Verlaufsdaten für werden importiert DevOpsTools
Verwenden Sie den Servicekatalog, um eine neue App zu onboarden und den Verlauf zu importieren DevOpsDaten für diese App. Aktivieren Sie die Abfrage, um Daten zu importieren, die zugeordneten Plänen, Repositorys und Pipelines in einer geplanten Häufigkeit zugeordnet sind.
Importieren Sie den Verlauf DevOpsDaten für vorhandene Tools
Sie können eine App-Onboarding-Anforderung erstellen und Verlaufsdaten für importieren A DevOpsTool, das Sie bereits integriert haben, mithilfe des App-Onboarding-Katalogformulars. Derzeit können Sie Verlaufsdaten für die letzten 90 Tage ab dem aktuellen Datum importieren und die Abfrage für eine geplante Häufigkeit für die folgenden Tools aktivieren:
- Jira (Plan)
- GitHubUnd GitHubUnternehmen (Codierung)
- Jenkins (Orchestration)
Hinweis:
- Stellen Sie sicher, dass Sie das Tool erstellt, verbunden und erkannt haben, für das Sie Daten importieren.
- Importanforderungen für Plantool ( Jira) Werden zuerst verarbeitet, gefolgt von Repository- und Pipeline-Importanforderungen.
Importieren Sie den Workflow, und versuchen Sie es erneut
Nach erfolgreicher Übermittlung der Kataloganforderung aus dem Selfservice-Katalog wird die Anforderung gemäß dem von Ihnen konfigurierten Genehmiger-Flow zur Genehmigung gesendet. Wenn die Anforderung genehmigt wird, wird ein eingehendes Ereignis für die App-Onboarding-Anforderung erstellt. Die Verarbeitungsdetails Das Feld des eingehenden Ereignisdatensatzes 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: Eine Seite wird für einen Bereich von 15 Tagen erstellt.
- GitHub : Für alle 100 Commits wird eine Seite erstellt.
- Jenkins: Seiten werden pro Build erstellt.
Bei erfolgreichem Import können Sie alle importierten Commits in anzeigen :
- Zweige
- Commits
- Committer
- Tags
- Repositorys
- Arbeitselemente
Bei der Verarbeitung einer Importanforderung versucht ein integrierter Wiederholungsmechanismus, die Seite für eine festgelegte Anzahl von Zeiten zu verarbeiten, wenn eine Seite fehlerhaft ist. Wenn sich die Seite nach allen automatischen Wiederholungen noch im Fehlerstatus befindet, werden die nachfolgenden oder verbleibenden Seiten in der Importanforderung verarbeitet. Der Gesamtstatus der Importanforderung bleibt fehlerhaft.
Wenn beispielsweise die Planimport-Anforderung fehlgeschlagen ist (nach allen Wiederholungen), fahren wir mit der Verarbeitung von Repository- und Pipeline-Importen fort. Sie können die Wiederholungen für die Importanforderung von konfigurieren an.
- Geben Sie die Anzahl der Wiederholungen an, die automatisch versucht werden sollen, falls die Importanforderungsseite in fehlschlägt Maximale Anzahl von Wiederholungen pro Seite beim Importieren Feld. Wenn die Seite nach allen automatischen Wiederholungen nicht erfolgreich ist, verarbeitet die Importanforderung die verbleibenden Seiten. Der Gesamtstatus der Importanforderung wird als fehlerhaft angezeigt.
- Sie können manuell versuchen, einen fehlgeschlagenen Import zu versuchen, indem Sie auf klicken Wiederholen Sie den Import Schaltfläche auf der Seite „fehlgeschlagene Importanforderung“,
Abfragezeitplan und -Konfiguration
Aktivieren Sie die Abfrage zum Importieren DevOpsDaten in einer geplanten Häufigkeit für Apps, die Verlaufsdaten importiert haben und zugeordneten Plänen, Repositorys und Pipelines zugeordnet sind.
Nachdem Sie eine App integriert und die zugehörige importiert haben DevOpsDaten können Sie den Basissystemzeitplan aktivieren, damit Importanforderungen für die Pläne, Repositorys und Pipelines erstellt werden, die nachverfolgt und einer App zugeordnet werden. Wenn die Verarbeitung der Importanforderungen abgeschlossen ist, werden die zugehörigen Daten beibehalten und für die App angezeigt. Während das Basissystem DevOpsImportPolling Die geplante Aufgabe ist standardmäßig aktiv. Sie müssen die Abfrage von aktivieren DevOpsEigenschaften zum Ausführen der geplanten Aufgabe.
Navigieren Sie zu , um die Abfrage zu aktivieren Und aktivieren Sie das Kontrollkästchen.
Wenn Sie diese Eigenschaftskennzeichnung aktivieren, wird das Basissystem aktiviert DevOpsImportPolling Aufgabe planen. Die geplante Aufgabe für die Abfrage berücksichtigt entweder den letzten erfolgreichen Import oder 30 Tage (je nachdem, welcher Zeitpunkt später liegt) als „Startdatum“ und das Datum des aktuellen Tages als „Enddatum“ für den Datenimport für alle Apps, die aktiv sind und über nachverfolgte Pipelines verfügen. Der Auftrag sucht nach der Zeit des letzten erfolgreichen Imports und erstellt die nachfolgende Importanforderung entsprechend. Diese Logik stellt sicher, dass der geplante Abfrageauftrag das Delta von relevant importiert DevOpsDaten für diese App vom letzten erfolgreichen Import bis zum Datum bis zu maximal dreißig Tagen.
Hinweis:
Die Standardhäufigkeit des Auftrags ist so festgelegt, dass er täglich um Mitternacht unter Verwendung der Systemzeitzone ausgeführt wird. Um die Häufigkeit der geplanten Aufgabe zu ändern, benötigen Sie ServiceNow Now PlatformAdministratorrolle (admin).Konfigurieren Sie keine Abfragehäufigkeit, die weniger als einen Tag oder 24 Stunden beträgt.
Navigieren zu Und ändern Sie Ausführen Häufigkeit, Zeitzone , Und Zeit Feldwerte, 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“ und im Status befindet Nachverfolgen Feld ist für die relevanten Pipelines aktiviert.
- Beachten Sie Folgendes, wenn Sie die Zeitplanhäufigkeit ändern:
- Für JIRA basiert die Standardzeitzone auf der Zeitzone des Standorts des JIRA-Servers.
- Für JenkinsDie Standardzeitzone ist UTC. Weitere Informationen finden Sie unter Jenkins Dokumentation zu Systemzeitzonen .
Die geplanten Aufgaben, die zum Importieren abgefragt werden DevOpsDaten berücksichtigen die Standardwerte für Folgendes DevOpsEigenschaften 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 wird als falsch betrachtet.
Importieren Sie vorhandene Azure DevOpsPipelines, Repositorys und Pläne
Nachdem Sie integriert haben Azure DevOpsMit DevOps, Sie können bis zu 90 Tage vorhandener importieren Azure DevOpsPipeline-, Repository- und Plandaten. Sie können dann verwenden DevOpsDashboards zum Anzeigen und Verwalten Azure DevOpsDaten.
Vorbereitungen
Erforderliche Rolle: Administrator
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 Pipeline-Ausführungen und nicht mit Schrittausführungen verknüpft.
- SonarQube-Scan-Ergebnisse werden nicht importiert.
- Azure DevOps Erzwingt die folgenden Einschränkungen:
- Alle 15 Tage können maximal 20.000 Arbeitselemente importiert werden.
- Jeder Pipeline-Ausführung können maximal 200 ausgeführte Commits zugeordnet werden.
- Testergebnisse für Pipeline-Ausführungen, die länger als 7 Tage sind, werden nicht zurückgegeben.
Hinweis:
Der Importvorgang kann für sehr große Datensätze einige Zeit oder Stunden dauern.
Prozedur
-
Wählen Sie im Formular Katalogelement die Option aus Versuchen Sie Es Zum anfordern der Daten.
Mit dem resultierenden DevOps-App-Onboarding-Formular können Sie das zu bestellende Katalogelement angeben. In diesem Fall ist die zu bestellende „App“ Ihr Azure DevOpsInstanz.
-
Wählen Sie das Symbol „in Liste auswählen“ aus (
) Auf App Und wählen Sie dann Ihre Instanz von aus Azure DevOps.
Nachdem Sie die Instanz jetzt angegeben haben, geben Sie den Datumsbereich und die Quellen der zu importierenden Daten an. -
Wiederholen Sie den folgenden Vorgang für jede Pipeline, jedes Repository und jeden Plan, die Sie importieren möchten:
-
Wählen Sie das Symbol „in Liste auswählen“ aus ( ) Auf dem entsprechenden Onboarding Feld zum Auswählen des zu importierenden Elements.
Sie können mehrere Elemente auswählen.
-
Wählen Sie das Symbol „in Liste auswählen“ aus (
-
Wählen Sie die Anforderungsnummer aus, damit Sie oder ein anderer Anwender mit der Administratorrolle die Anforderung genehmigen können.
Importieren Sie vorhandene GitLabPipelines und Repositorys
Nachdem Sie integriert haben GitLabMit DevOps, Sie können bis zu 90 Tage vorhandener importieren GitLabPipeline- und Repository-Daten. Sie können dann verwenden DevOpsDashboards zum Anzeigen und Verwalten GitLabDaten.
Vorbereitungen
Erforderliche Rolle: Administrator
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 Stichwort „Artefakte“ veröffentlicht wurden, werden importiert.
- Testergebnisse werden für abgelaufene Artefakte nicht angezeigt. Sie können das Ablaufdatum eines Artefakts festlegen, indem Sie konfigurieren Ablaufdatum_in Eigenschaft in der Pipeline. Weitere Informationen zu Richtlinien zum Ablauf von Artefakten finden Sie unter Ablauf der Artefakt- und Auftragsmetadaten .
- SonarQube-Scan-Ergebnisse werden nicht importiert.
- Nur 6400 Commits pro Verzweigung können in einem einzelnen Import importiert werden.
- GitLab erzwingt die folgende Einschränkung: Beim Zuordnen von Ausführungsbestätigungen zu einer Pipeline-Ausführung stellt GitLab in einigen Szenarien den Startteil der Commit-Details nicht bereit. Stellt nur das Teil vor der SHA als „0000000000000000“ bereit. In solchen Szenarien wird der neueste Commit als „Commit ausführen“ zugeordnet. 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 oder Stunden dauern.
Prozedur
-
Wählen Sie im Formular Katalogelement die Option aus Versuchen Sie Es Zum anfordern der Daten.
Mit dem resultierenden DevOps-App-Onboarding-Formular können Sie das zu bestellende Katalogelement angeben. In diesem Fall ist die zu bestellende „App“ Ihr GitLabInstanz.
-
Wählen Sie das Symbol „in Liste auswählen“ aus ( ) Auf App Und wählen Sie dann Ihre Instanz von aus GitLab.
Nachdem Sie die Instanz jetzt angegeben haben, geben Sie den Datumsbereich und die Quellen der zu importierenden Daten an.
-
Wiederholen Sie den folgenden Vorgang für jedes Repository, das Sie importieren möchten:
-
Wählen Sie das Symbol „in Liste auswählen“ aus ( ) Auf Onboarding-Repositorys Feld und wählen Sie dann das zu importierende Element aus.
Sie können mehrere Elemente auswählen.
Hinweis:Die den Repositorys zugeordneten Pipelines werden automatisch ausgewählt, wenn Sie das Repository in auswählen Onboarding-Repositorys Feld. Sie müssen die Pipelines nicht separat auswählen. -
Wählen Sie das Symbol „in Liste auswählen“ aus (
-
Wählen Sie die Anforderungsnummer aus, damit Sie oder ein anderer Anwender mit der Administratorrolle die Anforderung genehmigen können.