Verlaufsdaten für DevOps Tools werden importiert

Verwenden Sie den Servicekatalog, um eine neue App zu integrieren und Verlaufsdaten DevOps für diese App zu importieren. Aktivieren Sie die Abfrage, um Daten zu importieren, die zugeordneten Plänen, Repositorys und Pipelines zugeordnet sind, und zwar mit einer geplanten Häufigkeit.

Importieren Sie historische Daten DevOps für vorhandene Tools

Sie können eine App-Onboarding-Anforderung erstellen und Verlaufsdaten für das Tool ein DevOps -Tool importieren, für das Sie bereits ein Onboarding durchgeführt haben, indem Sie das App-Onboarding-Katalogformular verwenden. Derzeit können Sie Verlaufsdaten für die letzten 90 Tage ab dem aktuellen Datum importieren und für die folgenden Tools die Abfrage mit geplanten Häufigkeiten aktivieren:

• Jira (Planen)
• GitHub und GitHub Enterprise (Codierung)
• Jenkins (Orchestrierung)

Hinweis:

• Vergewissern Sie sich, dass das Tool, für das Sie Daten importieren, erstellt, verbunden und erkannt wurde.
• Importanforderungen für das Plan-Tool (Jira) werden zuerst verarbeitet, gefolgt von Repository- und Pipeline-Importanforderungen.

Import-Workflow und Wiederholungen

Bei erfolgreicher Übermittlung der Kataloganforderung aus dem Selfservice-Katalog wird die Anforderung gemäß dem von Ihnen konfigurierten Genehmigungs-Flow zur Genehmigung gesendet. Wenn die Anforderung genehmigt wird, wird ein eingehendes Ereignis für die Anforderung des App-Onboardings erstellt. Das Feld Verarbeitungsdetails des Datensatzes für eingehende Ereignisse zeigt die ID und den Status der Importanforderung an. Eine einzelne Importanforderung erstellt mehrere untergeordnete Importanforderungsseiten, die in der zugehörigen Liste angezeigt werden. Die Importanforderungsseiten werden basierend auf der folgenden Logik für die unterstützten Tools erstellt:

• Jira: Für einen Bereich von 15 Tagen wird eine Seite erstellt.
• GitHub : Für jeweils 100 Commits wird eine Seite erstellt.
• Jenkins: Seiten werden pro Build erstellt.

. Nachdem die Verarbeitung der Importanforderungen abgeschlossen ist, werden die zugehörigen von Ihnen zugeordneten Arbeitselemente, Commits, Verzweigungen, Tags, Pipelineausführungen und Testzusammenfassungen erstellt und im System beibehalten.

Bei einem erfolgreichen Import können Sie alle importierten Commits in anzeigen DevOps > Entwickeln:

• Verzweigungen
• Commits
• Committer
• Tags
• Repositorys
• Arbeitselemente

für Details zur Bestätigung des erfolgreichen Imports für den angegebenen Datumsbereich.

Wenn bei der Verarbeitung einer Importanforderung ein Seitenfehler auftritt, versucht ein integrierter Wiederholungsmechanismus, die Seite für eine festgelegte Anzahl von Malen zu verarbeiten. Wenn sich die Seite nach allen automatischen Wiederholungen immer noch im Fehlerstatus befindet, werden die nachfolgenden oder verbleibenden Seiten in der Importanforderung verarbeitet. Der Gesamtstatus der Importanforderung bleibt im Fehler.

Wenn beispielsweise die Planimportanforderung fehlgeschlagen ist (nach allen Wiederholungen), werden die Repository- und Pipeline-Importe verarbeitet. Sie können die Wiederholungen für die Importanforderung von konfigurieren DevOps > Administration > Eigenschaften > Maximale Anzahl von Wiederholungen pro Seite während des Importsan.

• Geben Sie im Feld Maximale Wiederholungen pro Seite während des Imports die Anzahl der Wiederholungen für einen automatischen Versuch an, falls die Importanforderungsseite fehlschlägt. Wenn nach allen automatischen Neuversuchen die Seite nicht erfolgreich ist, verarbeitet die Importanforderung die verbleibenden Seiten. Der Gesamtstatus der Importanforderung wird als „Fehler“ angegeben.
• Sie können manuell versuchen, einen fehlgeschlagenen Import zu versuchen, indem Sie auf der Seite der fehlgeschlagenen Importanforderung auf die Schaltfläche „ Import wiederholen“ klicken.

Abfragezeitplan und -konfiguration

Aktivieren Sie die Abfrage, um Daten DevOps mit einer geplanten Häufigkeit in Apps zu importieren, die über importierte Verlaufsdaten verfügen und die zugehörigen Plänen, Repositorys und Pipelines zugeordnet sind.

Nachdem Sie das Onboarding einer App durchgeführt und die zugehörigen DevOps -Daten importiert haben, können Sie den Basissystemzeitplan für die Erstellung von Importanforderungen für die Pläne, Repositorys und Pipelines aktivieren, die nachverfolgt und einer App zugeordnet werden. Wenn die Verarbeitung der Importanforderungen abgeschlossen ist, werden die zugehörigen Daten beibehalten und in der App angezeigt. Die geplante DevOpsImportPolling -Aufgabe des Basissystems ist zwar standardmäßig aktiv, Sie müssen jedoch die Abfrage der Eigenschaften DevOps aktivieren, um die geplante Aufgabe auszuführen.

Um die Abfrage zu aktivieren, navigieren Sie zu DevOps > Administration > Eigenschaften > Importabfrage aktivieren und aktivieren Sie das Kontrollkästchen.

Durch Aktivieren dieser Eigenschaftskennzeichnung wird die geplante Basissystem- DevOpsImportPolling -Aufgabe aktiviert. Die geplante Abfrageaufgabe berücksichtigt entweder den letzten erfolgreichen Import oder 30 Tage (je nachdem, was später liegt) als „Startdatum“ und das Datum des aktuellen Tages als „Enddatum“ für den Datenimport für alle aktiven und nachverfolgten Apps Pipelines. Die Aufgabe ermittelt die Zeit des letzten erfolgreichen Imports und erstellt entsprechend die nachfolgende Importanforderung. Diese Logik stellt sicher, dass die geplante Abfrageaufgabe das Delta der relevanten DevOps -Daten für diese App importiert, vom Datum des letzten erfolgreichen Imports bis zum Datum und maximal 30 Tage.

Hinweis:

Konfigurieren Sie keine Abfragehäufigkeit, die weniger als einen Tag oder 24 Stunden beträgt.

Die Standardhäufigkeit der Aufgabe ist entsprechend der Systemzeitzone auf „täglich um Mitternacht ausgeführt“ festgelegt. Zum Ändern der Häufigkeit der geplanten Aufgabe benötigen Sie die Rolle ServiceNow Now Platform Administrator (admin).

Navigieren zu Systemdefinition > Geplante Aufgaben > DevOpsImportPolling und ändern Sie die Werte im Feld Ausführungshäufigkeit, Zeitzoneund Zeit nach Bedarf. Weitere Informationen finden Sie unter Aufgaben planen

Hinweis:

• Die geplante Aufgabe gilt nur für aktive Apps. Stellen Sie sicher, dass sich die App, für die Sie die Abfrage konfigurieren, im Status „Aktiv“ befindet und dass das Feld „Nachverfolgen“ für die relevanten Pipelines aktiviert ist.
• Berücksichtigen Sie Folgendes, wenn Sie die Zeitplanhäufigkeit ändern:
  • Für JIRA basiert die Standardzeitzone auf der Zeitzone des Standorts des JIRA-Servers.
  • Für Jenkins ist die Standardzeitzone UTC. Weitere Informationen finden Sie in Jenkins der Dokumentation zu Systemzeit-Zeitzonen.

Die geplanten Aufgaben, die den Import von DevOps -Daten abfragen, berücksichtigen die Standardwerte für die folgenden DevOps -Eigenschaften im Zusammenhang mit Importen und Importanforderungen:

• Maximale Anzahl von Wiederholungen pro Seite beim Import
• Maximale Anzahl von Seiten, die für eine Importanforderung gleichzeitig verarbeitet werden
• Um Nutzlasten als Anhänge im Datensatz der Importanforderungsseite zu speichern, legen Sie das Feld „Wert“ auf „wahr“ fest. Alles andere gilt als falsch.

Importieren Sie vorhandene Azure DevOps -Pipelines, Repositorys und Pläne

Nachdem Sie Azure DevOps mit DevOpsintegriert haben, können Sie bis zu 90 Tage an vorhandenen Azure DevOps -Pipeline-, Repository- und Plandaten importieren. Sie können dann DevOps -Dashboards verwenden, um Azure DevOps ]-Daten anzuzeigen und zu verwalten.

Vorbereitungen

Erforderliche Rolle: admin

Warum und wann dieser Vorgang ausgeführt wird

• Sie fordern die Daten aus dem Servicekatalog als vordefiniertes Katalogelement an.
• Importierte Testzusammenfassungen, Artefakte und Pakete sind mit Pipelineausführungen und nicht mit Schrittausführungen verknüpft.
• SonarQube-Scan-Ergebnisse werden nicht importiert.
• Azure DevOps gelten folgende Einschränkungen:
  • Alle 15 Tage können maximal 20.000 Arbeitselemente importiert werden.
  • Maximal 200 ausgeführte Commits können jeder Pipeline-Ausführung zugeordnet werden.
  • Testergebnisse für Pipeline-Ausführungen, die länger als 7 Tage dauern, werden nicht zurückgegeben.

Hinweis:

Der Importvorgang kann für sehr große Datensätze einige Zeit und Stunden dauern.

Prozedur

1. Navigieren zu Alle > Servicekatalog > Katalogdefinitionen > Meine Kataloge und wählen Sie dann DevOps Onboarding aus.
2. Wählen Sie in der zugehörigen Liste „ Katalogelemente“ DevOps-App-Onboarding aus.
3. Wählen Sie im Formular „Katalogelement“ Testen, um die Daten anzufordern.
   Im resultierenden Formular „DevOps-App-Onboarding“ können Sie das zu bestellende Katalogelement angeben. In diesem Fall ist die zu bestellende „app“ Ihre Instanz Azure DevOps.

   

4. Wählen Sie im Feld App das Symbol Aus Liste auswählen ( ) und dann Ihre Instanz von Azure DevOpsaus.
   Nachdem Sie nun die Instanz angegeben haben, geben Sie den Datumsbereich und die zu importierenden Datenquellen an.
5. Wiederholen Sie das folgende Verfahren für jede Pipeline, jedes Repository und jeden Plan, die bzw. den Sie importieren möchten:
   1. Wählen Sie im entsprechenden Feld Onboarding das Symbol In Liste auswählen ( ), um das zu importierende Element auszuwählen.
      Sie können mehrere Elemente auswählen.
   2. Geben Sie den Datumsbereich für die Daten in den Feldern Importieren von und Importieren bis an.
6. Wählen Sie Jetzt bestellen aus.
   Ihre Anforderung wird auf der Seite „Bestellstatus“ angezeigt.
7. Wählen Sie die Anforderungsnummer aus, damit Sie oder ein anderer Anwender mit der Administratorrolle die Anforderung genehmigen können.
   
8. Genehmigen Sie die Anforderung: Legen Sie im Formular Anforderung die Option Genehmigung und Anforderungsstatusauf Genehmigtfest.
   Der Importvorgang beginnt sofort nach der Genehmigung.

Importieren Sie vorhandene GitLab -Pipelines und -Repositorys

Nachdem Sie GitLab mit DevOpsintegriert haben, können Sie bis zu 90 Tage an vorhandenen GitLab -Pipeline- und -Repository-Daten importieren. Sie können dann DevOps -Dashboards verwenden, um GitLab ]-Daten anzuzeigen und zu verwalten.

Vorbereitungen

Erforderliche Rolle: admin

Warum und wann dieser Vorgang ausgeführt wird

• Sie fordern die Daten aus dem Servicekatalog als vordefiniertes Katalogelement an.
• Importierte Testzusammenfassungen sind mit Pipeline-Ausführungen und nicht mit Schrittausführungen verknüpft.
• Nur Artefakte, die mit dem Schlüsselwort „artefakte“ veröffentlicht wurden, werden importiert.
• Für Artefakte, die abgelaufen sind, werden keine Testergebnisse angezeigt. Sie können das Ablaufdatum eines Artefakts festlegen, indem Sie die Eigenschaft „expire_in“ in der Pipeline konfigurieren. Weitere Informationen zu Richtlinien für den Ablauf von Artefakten finden Sie unter Ablauf von Artefakt- und Auftragsmetadaten.
• SonarQube-Scan-Ergebnisse werden nicht importiert.
• In einem einzigen Import können nur 6.400 Commits pro Verzweigung importiert werden.
• GitLab führt die folgende Einschränkung durch: Beim Zuordnen von Run Commits zu einer Pipelineausführung stellt GitLab in einigen Szenarien den Startteil der Commit-Details nicht bereit. Es wird nur der Teil vor der SHA als „0000000000000000“ angegeben. In solchen Szenarien wird der letzte Commit als ausgeführter Commit zugeordnet. Zum Beispiel, wenn eine neue Verzweigung erstellt wird oder wenn eine Pipeline manuell ausgeführt wird.
  Hinweis:

  Der Importvorgang kann für sehr große Datensätze einige Zeit und Stunden dauern.

Prozedur

1. Navigieren zu Alle > Servicekatalog > Katalogdefinitionen > Meine Kataloge und wählen Sie dann DevOps Onboarding aus.
2. Wählen Sie in der zugehörigen Liste „ Katalogelemente“ DevOps-App-Onboarding aus.
3. Wählen Sie im Formular „Katalogelement“ Testen, um die Daten anzufordern.
   Im resultierenden Formular „DevOps-App-Onboarding“ können Sie das zu bestellende Katalogelement angeben. In diesem Fall ist die zu bestellende „app“ Ihre Instanz GitLab.

   

4. Wählen Sie im Feld App das Symbol Aus Liste auswählen ( ) und dann Ihre Instanz von GitLabaus.
   Nachdem Sie nun die Instanz angegeben haben, geben Sie den Datumsbereich und die zu importierenden Datenquellen an.
5. Wiederholen Sie das folgende Verfahren für jedes Repository, das Sie importieren möchten:
   1. Wählen Sie im Feld Onboarding-Repositorys das Symbol Aus Liste auswählen ( ) und dann das zu importierende Element.
      Sie können mehrere Elemente auswählen.
   2. Geben Sie den Datumsbereich für die Daten in den Feldern Importieren von und Importieren bis an.
   Hinweis:

   Die den Repositorys zugeordneten Pipelines werden automatisch ausgewählt, wenn Sie das Repository im Feld Onboarding -Repositorys auswählen. Sie müssen die Pipelines nicht separat auswählen.
6. Wählen Sie Jetzt bestellen aus.
   Ihre Anforderung wird auf der Seite „Bestellstatus“ angezeigt.
7. Wählen Sie die Anforderungsnummer aus, damit Sie oder ein anderer Anwender mit der Administratorrolle die Anforderung genehmigen können.
   
8. Genehmigen Sie die Anforderung: Legen Sie im Formular Anforderung die Option Genehmigung und Anforderungsstatus auf Genehmigtfest.
   Der Importvorgang beginnt unmittelbar nach der Genehmigung.