Onboarding Azure DevOps von bis DevOps Change-Geschwindigkeit – Arbeitsbereich

Yokohama IT Service Management

Release

yokohama

ft:locale

de-DE

ft:publication_title

Yokohama IT Service Management

ft:clusterId

itsm

bundleId

itsm

workflow

Technology

Onboarding Azure DevOps von bis DevOps Change-Geschwindigkeit – Arbeitsbereich

Freigeben Version: Yokohama

Aktualisiert 30. Januar 2025

17 Minuten Lesedauer

Stellen Sie über das Playbook „DevOps Change Workspace“ eine Verbindung zu Ihrer Instanz Azure DevOps her, um Daten für Planung, Codierung, Orchestration, Artefakte und Softwarequalitätsfunktionen zu sammeln.

verbunden

Sie können auf Ebene Ihrer Organisation oder auf Ebene einzelner Projekte eine Verbindung zu Azure DevOps (ADO) herstellen. Wenn Sie eine Verbindung auf Projektebene herstellen, müssen Sie den Verbindungsprozess für jedes Projekt in Ihrer Organisation wiederholen. Nachdem Sie eine Verbindung zu einer Instanz des Tools hergestellt haben, können Sie zusätzliche Einstellungen konfigurieren, die DevOps den Import von Pipelines, Aufgabenausführungsdatensätzen und Schrittausführungsdatensätzen ermöglichen.

Wenn Sie Webhooks in der Instanz Azure DevOps zum Senden von Daten an DevOps Change-Geschwindigkeitkonfigurieren, verwendet Azure DevOps standardmäßig die Tokenauthentifizierung für den Integrationsbenutzer. Die DevOps Change-Geschwindigkeit APIs werden mithilfe der Tokenauthentifizierung aufgerufen, und Sie müssen bei der Konfiguration nicht den Anwendernamen und das Passwort für die Integration eingeben. Wenn der Anwender „devops.system“ in Ihrer ServiceNow-Instanz nicht verfügbar ist, müssen Sie die Eigenschaft Zu diesem Anwender wechseln festlegen, nachdem die tokenbasierte Authentifizierung erfolgreich war. Weitere Informationen finden Sie unter DevOps Change-Geschwindigkeit -Eigenschaften. Die Eingabe des Integrationsbenutzernamens und des Passworts ist nur in den folgenden Szenarien erforderlich:

Wenn DevOps Config installiert ist, werden DevOps Config-APIs mit der Standardauthentifizierung aufgerufen.
Wenn Sie die Azure Invoke REST API-Serviceverbindung verwenden. In diesem Fall müssen Sie die Eigenschaft This property decides whether to create a Generic Connection on configure operation for Azure DevOps aktivieren.

Hinweis:

DevOps Change-Geschwindigkeit verwendet den Begriff „Instanz“, um sich auf ein bestimmtes Vorkommen eines Tools zu beziehen. Azure DevOps verwendet stattdessen den Begriff „Projekt“.

Eine Organisation verbinden

Stellen Sie eine Verbindung her, und konfigurieren Sie Ihre Instanz Azure DevOps direkt auf der Organisationsebene von Azure DevOps. Alle Projekte innerhalb der Organisation können erkannt werden, und Sie können mehrere Projekte innerhalb der Organisation konfigurieren. Sie können das Tool auf Organisationsebene verwalten.

Vorbereitungen

Führen Sie die im Thema Erste Schritte mit DevOps Change-Geschwindigkeit angegebenen Aufgaben aus.

Erforderliche Rolle: sn_devops.admin oder sn_devops.tool_owner

Prozedur

Navigieren zu Arbeitsbereiche > DevOps – Change-Arbeitsbereich und öffnen Sie das Playbook für das Onboarding von Azure DevOpsmit einer der folgenden Optionen.

Option	Schritte
Homepage	Wählen Sie Tool verbinden. Wählen Sie im modalen Element Verbindung mit einem Tool herstellen aus der entsprechenden Kategorie (Orchestrierung, Plan, Code, Artefakt oder Softwarequalität) Azure DevOps aus.
Modul „Anwendungen“	Wählen Sie in der primären Navigation Anwendungen ( ). Wählen Sie eine vorhandene Anwendung aus, oder erstellen Sie eine. Informationen zum Erstellen einer Anwendung finden Sie unter Anwendung erstellen – Arbeitsbereich. Wählen Sie im Bereich Empfohlene Aktionen die Karte Tool verbinden. Wählen Sie im modalen Element Verbindung mit einem Tool herstellen aus der entsprechenden Kategorie (Orchestrierung, Plan, Code, Artefakt oder Softwarequalität) Azure DevOps aus.
Modul Tools	Wählen Sie in der primären Navigation Tools ( ). Wählen Sie in der Liste Fähigkeit die entsprechende Kategorie aus (Orchestrierung, Planung, Codierung, Artefakt oder Softwarequalität). Wählen Sie Tool verbinden. Wählen Sie im modalen Element „Mit einem Tool verbinden“ die Option Azure DevOpsaus.

Wichtig:

Wenn Sie Toolobjekte wie Pipelines, Pläne oder Repositorys erkennen und nachverfolgen möchten, während Sie eine Verbindung zum Tool herstellen, müssen Sie Ihr Tool über das Anwendungsmodul verbinden.

Geben Sie im modalen Element Mit einem Tool verbinden die Verbindungsdetails ein.
1. Wählen Sie in der Dropdown-Liste Organisation verbinden aus.
2. Geben Sie die URL Azure DevOps für die Organisation ein.
3. Geben Sie im Feld Toolname einen Namen für das Tool ein.
4. Wählen Sie Weiter.
  
  Das Playbook DevOps wird geöffnet, um Sie bei der Durchführung der Onboarding-Aufgaben zu unterstützen.

Wählen Sie im Abschnitt „Azure DevOps-Instanzdetails eingeben“ im Feld Anmeldeinformationstyp einen der folgenden Werte aus.

Option	Bezeichnung
Persönliches Zugriffstoken	Geben Sie das Passwort oder Zugriffstoken ein, um auf diese Instanz zuzugreifen. Informationen zum Erstellen eines PAT finden Sie unter Persönliches Zugriffstoken (PAT).
OAuth 2.0	Voraussetzungen: Erstellen Sie einen Mandanten in MicrosoftMicrosoft Azure Event Hubs Entra Fügen Sie dem Mandanten in MicrosoftMicrosoft Azure Event Hubs Entra einen Anwender hinzu Erstellt eine Organisation im Azure-Portal Erstellen Sie eine Azure DevOps -App Registrieren Sie Azure DevOps als OAuth-Anbieter Konfigurieren Sie Einstellungen auf Organisations- und Projektebene Erstellen Sie einen Anmeldeinformationsdatensatz, und rufen Sie das OAuth-Token ab Einen vorhandenen OAuth-Anmeldeinformations-Datensatz verwenden Wählen Sie die Option Vorhandenen OAuth-Anmeldeinformationsdatensatz verwenden aus. Wählen Sie einen Wert im Feld Anmeldeinformationen aus. Erstellen Sie einen neuen Anmeldeinformationsdatensatz Deaktivieren Sie die Option Vorhandenen OAuth-Anmeldeinformationsdatensatz verwenden. Geben Sie im Feld Anwendungs-ID (Client) die Anwendungs-ID Ihrer Azure-Anwendung (verfügbar im Abschnitt Übersicht Ihrer Azure-Anwendungsregistrierung in Azure) ein. Geben Sie die Verzeichnis-ID Ihrer Azure-Anwendung (verfügbar im Abschnitt Übersicht Ihrer Azure-Anwendungsregistrierung in Azure) im Feld Verzeichnis-ID (Mandant) ein. Geben Sie den geheimen Clientschlüssel Ihrer Azure-Anwendung (verfügbar im Abschnitt „Zertifikate und Geheimnisse Ihrer Azure-Anwendungsregistrierung“ in Azure) in das Feld Geheimer Clientschlüssel ein.

Option

Bezeichnung

Persönliches Zugriffstoken

Geben Sie das Passwort oder Zugriffstoken ein, um auf diese Instanz zuzugreifen.

Informationen zum Erstellen eines PAT finden Sie unter Persönliches Zugriffstoken (PAT). Verbindung mit einem Tool herstellen – ADO PAT

OAuth 2.0

Voraussetzungen:

Einen vorhandenen OAuth-Anmeldeinformations-Datensatz verwenden

Wählen Sie die Option Vorhandenen OAuth-Anmeldeinformationsdatensatz verwenden aus.
Wählen Sie einen Wert im Feld Anmeldeinformationen aus.

Erstellen Sie einen neuen Anmeldeinformationsdatensatz

Deaktivieren Sie die Option Vorhandenen OAuth-Anmeldeinformationsdatensatz verwenden.
Geben Sie im Feld Anwendungs-ID (Client) die Anwendungs-ID Ihrer Azure-Anwendung (verfügbar im Abschnitt Übersicht Ihrer Azure-Anwendungsregistrierung in Azure) ein.
Geben Sie die Verzeichnis-ID Ihrer Azure-Anwendung (verfügbar im Abschnitt Übersicht Ihrer Azure-Anwendungsregistrierung in Azure) im Feld Verzeichnis-ID (Mandant) ein.
Geben Sie den geheimen Clientschlüssel Ihrer Azure-Anwendung (verfügbar im Abschnitt „Zertifikate und Geheimnisse Ihrer Azure-Anwendungsregistrierung“ in Azure) in das Feld Geheimer Clientschlüssel ein.

Wenn Ihre -Toolinstanz an MID-Serverangehängt ist, wählen Sie die Option MID-Server, und geben Sie die Details ein.

Weitere Informationen zum MID-Server finden Sie unter MID-Server-Auswahl.
Wählen Sie Verbinden.
Berechtigungsprüfungen werden für die von Ihnen eingegebenen Anmeldeinformationen ausgeführt.
Erforderliche Berechtigungen und verfügbare Berechtigungen werden angezeigt. Wenn Sie Anmeldeinformationen mit besseren Berechtigungen eingeben möchten, wählen Sie Anmeldeinformationen erneut eingeben aus. Ausführliche Informationen zu allen erforderlichen Berechtigungen finden Sie unter Azure DevOps-Berechtigungen in Für DevOps Tools sind Berechtigungen erforderlich.
Sie können mit der Toolverbindung fortfahren, auch wenn Sie nicht über alle erforderlichen Berechtigungen verfügen.

Hinweis:
Beim Onboarding einer Organisation muss der Besitzer der PAT für die Projektadministratorberechtigung Mitglied der Projektsammlungsadministratorgruppe der Organisation sein.
Sie benötigen die Projektadministratorberechtigung nur für das Onboarding des Tools. Sobald das Onboarding des Tools erfolgreich war, können Sie die Berechtigung Projektadministrator in PAT deaktivieren.
Geben Sie den Zugriff für das Tool an.
1. Wenn Sie den Zugriff auf das Tool steuern möchten, fügen Sie im Feld Verwaltet von die Gruppen hinzu, die Zugriff auf das Tool erhalten müssen.
  Die Aufgaben, die diese Benutzer in den Gruppen ausführen können, hängt von der ihnen zugewiesenen Rolle ab.
  - DevOps Rolle Tool-Besitzer: Kann das Tool anzeigen und bearbeiten.
  - DevOps Rolle App-Besitzer: Kann das Tool anzeigen und Verlaufsdaten zuordnen, erkennen, importieren und Pipelineschritte (falls zutreffend) der Objekte des Tools (z. B. Pläne, Repositorys und Pipelines) ändern.
  - DevOps Administratorrolle: Kann alle Tools bearbeiten.
  - Andere DevOps -Rollen: Können das Tool anzeigen.
  Hinweis:
  Wenn Sie keine Gruppe auswählen und diesen Schritt überspringen, können alle Anwender mit der Rolle DevOps Toolbesitzer das Tool bearbeiten.
2. Wenn Sie den Zugriff auf das Tool steuern möchten, wird die Option Alle DevOps-App-Besitzer können Toolobjekte anzeigen und Anwendungen zuordnen zur Auswahl verfügbar.
  Mit dieser Option können alle Anwender mit der Rolle DevOps „ App-Besitzer auf das Tool zugreifen. Wenn diese Option ausgewählt ist, können sie Verlaufsdaten anzeigen, zuordnen, erkennen, importieren und Pipelineschritte (falls zutreffend) der Objekte des Tools ändern.
3. Klicken Sie auf Zuweisen.
Installieren Sie die Erweiterung ServiceNow DevOps in Ihrer Instanz Azure DevOps.

Mit der Erweiterung ServiceNow DevOps werden beim Konfigurieren von Webhooks automatisch Serviceverbindungen erstellt. Serviceverbindungen sind zum Senden von Build- und Release-Benachrichtigungen von Azure DevOpserforderlich. Die -Erweiterung enthält auch anwenderdefinierte Aufgaben zum Ändern der Azure DevOps -Pipelines für Change-Steuerung, Artefakte und Pakete.

Weitere Informationen zur Erweiterung finden Sie unter Verwenden Sie die Erweiterung ServiceNow DevOps für die anwenderdefinierten Aktionen Azure DevOps und Azure DevOps ..

Hinweis:
Wenn Sie diesen Schritt überspringen, müssen Sie zum Senden von Benachrichtigungen von Azure DevOps nach der Konfiguration von Webhooks manuell Serviceverbindungen erstellen.

Wählen Sie nach der Installation der Erweiterung Als installiert markiert aus.
Konfigurieren Sie Webhooks automatisch in Ihrer Instanz Azure DevOps, um Daten an DevOps Change-Geschwindigkeitzu senden.
Senden Sie Daten entweder durch nächtliche Abfrage oder konfigurieren Sie Webhooks zum Senden von Echtzeitdaten.
- Webhooks: Aktivieren Sie Echtzeitbenachrichtigungen für Ihre Pipelineausführungen. Echtzeitbenachrichtigungen sind ideal, um aktuelle Informationen zu erhalten, insbesondere für die Automatisierung von Change-Anforderungen.
  Um Webhooks zu verwenden, wählen Sie Konfigurieren aus.
- Nächtliche Abfrage: Wenn Sie jetzt nicht konfigurieren, können Sie die nächtliche Abfrage später aktivieren, um Daten für alle nachverfolgten Pläne abzurufen, indem Sie die Eigenschaft Enable Polling auf Jafestlegen.
1. Geben Sie den Anwendernamen und das Passwort für die Integration DevOps ein.
  Informationen zum Erstellen des Integrationsbenutzers DevOps und des Passworts finden Sie unter Richten Sie den Integrationsbenutzeraccount in ein DevOps Change-Geschwindigkeit.
  Hinweis:
  
  Die Eingabe des Integrationsbenutzernamens und des Passworts ist nur dann für die Konfiguration erforderlich, wenn DevOps Config installiert oder die Eigenschaft This property decides whether to create a Generic Connection on configure operation for Azure DevOps aktiviert ist. Wenn dieser Schritt nicht erforderlich ist, werden Webhooks mithilfe der tokenbasierten Authentifizierung konfiguriert.
  
  Wenn DevOps Config installiert ist oder die generische Verbindung für den Konfigurationsvorgang für die Azure DevOps-Eigenschaft aktiviert ist, können Sie das Token nur über die Anwenderoberfläche des Arbeitsbereichs neu generieren (automatische Konfiguration mit neuem Token). Dadurch wird das Passwort des Integrationsbenutzers aktualisiert. Wenn DevOps Config nicht installiert ist, kann das Token sowohl über den -Arbeitsbereich als auch über die klassische Anwenderoberfläche für die tokenbasierte Authentifizierung neu generiert werden. Generieren Sie Ihr Token regelmäßig neu, um die Sicherheit zu erhöhen.
2. Wählen Sie die Projekte aus, für die Sie Webhooks konfigurieren möchten.
3. Wählen Sie Konfigurieren.
Um Webhooks manuell zu konfigurieren, wählen Sie Manuell konfigurierenaus. Weitere Informationen finden Sie unter Konfigurieren Sie Webhooks manuell in Azure DevOps..

Die Webhook-Konfiguration und -Discovery erfolgen im Hintergrund, und Sie gelangen zur Seite „Zusammenfassung“.
Wählen Sie auf der Seite „Zusammenfassung “ Tooldatensatz anzeigen, um die Details des verbundenen Tools zu überprüfen.

Ergebnisse

Sie haben das Onboarding des Tools Azure DevOps erfolgreich in DevOps Change-Geschwindigkeit auf Organisationsebene durchgeführt.

Nächste Maßnahme

Wählen Sie auf der Registerkarte Projekte auf der Tooldatensatzseite ein Projekt aus, um zur Projektdatensatzseite zu navigieren. Von hier aus können Sie Projektobjekte erkennen und Webhooks für das Projekt konfigurieren.

Wählen Sie Erkennen aus, um die Projektobjekte zu erkennen, einschließlich vorhandener Pläne (Tafeln), Repositorys und Pipelines.
Wenn Sie das Tool direkt auf Projektebene erstellt haben, werden durch Auswahl von Projekte erkennen auf der Registerkarte Projekte der Tooldatensatzseite auch alle Projekte in Ihrer Organisation erkannt.
Wählen Sie Konfigurieren aus, und geben Sie die Anmeldeinformationen des Integrationsbenutzers ein, um Webhooks für das Projekt zu konfigurieren.
Wenn Sie sich auf der Seite mit den Tooldatensätzen befinden, erhalten Sie durch Auswahl von Projekte konfigurieren und Eingabe der Anmeldeinformationen des Integrationsbenutzers die Liste der nicht konfigurierten Projekte in Ihrer Organisation. Wählen Sie die Projekte aus, für die Sie Webhooks konfigurieren möchten, und wählen Sie Konfigurierenaus.
Hinweis:
Die Eingabe des Integrationsbenutzernamens und des Passworts ist nur dann erforderlich, wenn DevOps Config installiert ist oder die generische Verbindung für den Konfigurationsvorgang für Azure DevOps deaktiviert ist. Wenn dieser Schritt nicht erforderlich ist, werden Webhooks mithilfe der tokenbasierten Authentifizierung konfiguriert.
Um Verlaufsdaten in Projektobjekte wie Pläne, Repositorys oder Pipelines zu importieren, ordnen Sie die Objekte einer Anwendung zu, und importieren Sie die Daten. Weitere Informationen finden Sie unter Toolobjekte Anwendungen zuordnen – Arbeitsbereich.

Ein Projekt verbinden

Stellen Sie eine Verbindung her, und konfigurieren Sie Ihre -Instanz Azure DevOps direkt auf Projektebene. Wenn Sie mehrere Projekte innerhalb der Organisation haben, müssen Sie jedes einzeln verbinden.