Onboarding Azure DevOps von auf DevOps Change-Geschwindigkeit  – Klassisch

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 6 Minuten Lesedauer

    • Erstellen Sie einen Azure DevOps -Tooldatensatz in DevOps Change-Geschwindigkeit, um Azure DevOps -Tooldaten zu verbinden, zu erkennen und zu importieren.

    Vorbereitungen

    Erforderliche Rolle: sn_devops.admin oder sn_devops.tool_owner

    Warum und wann dieser Vorgang ausgeführt wird

    Aktionen:
    • Stellen Sie eine Verbindung zur Organisation oder dem Projekt Azure DevOps von her.
    • Erkennen Sie Pläne, Repositorys, Orchestration-Aufgaben und Pipelines.
    • Konfigurieren Sie Webhooks in Azure DevOps.
    • Importieren Sie Arbeitselement-, Planversions- und Funktionsdatensätze, Verzweigungs- und Commit-Datensätze sowie Aufgaben- und Schrittausführungs-Datensätze.

    Um den Import von Arbeitselementstatus oder -typen in Azure Boards anzupassen, verwenden Sie die Skripteinbindung DevOpsAzureDevOpsWorkItemHelper.

    Prozedur

    1. Navigieren zu DevOps > Tools > Neu erstellen (veraltet).
    2. Füllen Sie die Felder im Formular „Tool zum Erstellen DevOps “ aus.
      Feld Beschreibung
      Toolname Name Ihrer Wahl zur Identifizierung dieses Tools.
      Toolintegration Wählen Sie Azure DevOpsaus.
      Mit einer Organisation oder einem Projekt verbinden Wählen Sie aus der Liste.
      • Eine Organisation verbinden: Stellen Sie direkt auf Ihrer Azure DevOps Organisationsebene eine Verbindung her. Alle Projekte innerhalb der Organisation können erkannt werden, und Sie können mehrere Projekte innerhalb der Organisation konfigurieren.
      • Ein Projekt verbinden: Stellen Sie eine direkte Verbindung auf Projektebene her.
      Tool-URL Azure DevOps Organisations-URL (z. B. https://dev.azure.com/ <your organization> oder die Projekt-URL Azure DevOps (z. B. https://dev.azure.com//<your project> , abhängig von Ihrer vorherigen Auswahl.
      Zertifizierungstyp Typ der Anmeldeinformationen, Basic Auth oder OAuth 2.0.

      Basisauth.

      1. Geben Sie Ihren ADO-Instanz-Anwendernamen ein.
      2. Geben Sie das persönliche Zugriffstoken (PAT) oder das Passwort für Ihre Instanz Azure DevOps ein.
        Hinweis:

        Wenn Sie ein persönliches Zugriffstoken (PAT) für Azure DevOpsgenerieren, müssen Sie die zu autorisierenden Bereiche auswählen, wenn Sie keinen vollständigen Zugriff gewähren. Weitere Informationen finden Sie unter Azure DevOps PAT-Bereiche für DevOps.

      OAuth 2.0

      Voraussetzungen:
      Wählen Sie im Feld Tool-Anmeldeinformationen einen Anmeldeinformationsdatensatz für das OAuth 2.0-Tool aus.
      Hinweis:
      Nur Datensätze, die nicht für ADO verwendet werden und für sie konfiguriert sind, können als vorhandener Anmeldeinformationsdatensatz ausgewählt werden.

      Eine Liste aller Berechtigungen, die für die Anmeldeinformationen zum Herstellen einer Verbindung mit Azure DevOpserforderlich sind, finden Sie unter Berechtigungen Azure DevOps für in Für DevOps Tools sind Berechtigungen erforderlich.

    3. Wahlweise: Wenn Ihre Instanz Azure DevOps an ein MID-Serverangehängt ist, wählen Sie die Option MID-Server verwenden, und geben Sie die Details ein.

      Weitere Informationen zum MID-Server finden Sie unter MID-Server-Auswahl

    4. Wählen Sie Absenden.

      Das Tool wird automatisch über einen Verbindungsalias und eine HTTP-Toolverbindung (Anmeldeinformationen für Standardauthentifizierung) verbunden, und die Details des Tooldatensatzes werden in einem Formular angezeigt.

      Hinweis:
      Wenn Sie keine globalen Administratorrechte für Ihr Tool haben (um die automatische Konfiguration der Webhook-URL zuzulassen), müssen Sie es möglicherweise vom Tool-Administrator konfigurieren (schneiden Sie die Webhook-URL aus, und fügen Sie sie in die Toolkonfiguration ein). Sobald der Webhook im Tool konfiguriert ist, wechseln Sie in den manuellen Konfigurationsmodus, um manuell eine Verbindung zum Tool herzustellen, und beenden Sie den Vorgang.
    Bei erfolgreicher Tool-Erstellung gelangen Sie zur Tooldatensatzseite.
    1. Wahlweise: Wenn Sie den Zugriff auf das Tool steuern möchten, fügen Sie im Feld Verwaltet von auf der Registerkarte Zugriff die Gruppen hinzu, die Zugriff auf das Tool erhalten müssen.
      Welche Aufgaben die Benutzer in den Gruppen ausführen können, hängt von den ihnen zugewiesenen Rollen 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:
      Im Feld Verwaltet von können nur Gruppen ausgewählt werden, die Anwender mit den Rollen DevOps enthalten.

      Die Option Alle App-Besitzer können Toolobjekte anzeigen und Anwendungen zuordnen wird verfügbar, wenn Sie den Zugriff auf das Tool einschränken. 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.

    2. Entdecken Sie Toolobjekte, einschließlich vorhandener Anwendungspläne (Projekte, die dem Tool zugeordnet sind), Repositorys, Orchestration-Aufgaben und Pipelines.
      • Verbunden mit Organisation: Wählen Sie Projekte erkennen, um die Projekte der Organisation zu erkennen. Nach der Discovery sind die Projekte aus Ihrer Organisation unter der zugehörigen Liste „Projekte“ verfügbar.
      • Verbunden mit einem Projekt: Das Projekt wird während der Erstellung der Verbindung erkannt und ist in der zugehörigen Liste „Projekte“ verfügbar. Wenn Sie Projekte erkennen auf der Registerkarte Projekte der Tooldatensatzseite auswählen, werden alle Projekte in Ihrer Organisation erkannt.

      Wählen Sie ein Projekt aus der zugehörigen Liste „Projekte“ aus, um zur Projektdatensatzseite zu navigieren. Wählen Sie Erkennen aus, um die Projektobjekte zu erkennen, einschließlich vorhandener Pläne (Tafeln), Repositorys und Pipelines.

    3. Konfigurieren Sie Webhook-URLs in Azure DevOps.
      1. Sie können direkt von der Seite „Tooldatensatz“ oder von der Projektdatensatzseite für jedes Produkt konfigurieren.
        • Um auf der Seite mit den Tooldatensätzen zu konfigurieren, wählen Sie Projekte konfigurierenaus. Wählen Sie die Projekte aus, die Sie konfigurieren möchten, und wählen Sie Fortfahren..
        • Zum Konfigurieren von über die Projektdatensatzseite: Wählen Sie zuerst das Projekt auf der Tooldatensatzseite aus, und wählen Sie Konfigurierenaus.
      2. Geben Sie den Integrationsbenutzer und das Passwort DevOps ein, und wählen Sie Sendenaus.

        Beim Senden werden Webhooks und Serviceverbindungen automatisch in Azure DevOpserstellt. Dadurch werden die Benachrichtigungen von den Tools Azure DevOps mithilfe des Integrationsbenutzers DevOps Change-Geschwindigkeit ] an DevOps gesendet. Informationen zum Einrichten des Integrationsbenutzeraccounts 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 Integrationsanwenders 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.
      Hinweis:
      Für Pläne wird das Feld Nachverfolgung automatisch auf truefestgelegt.
    4. Für die erkannten Pläne können Sie Verlaufsdaten aus dem Tool importieren und ihm auch eine Anwendung zuordnen.
      1. Öffnen Sie einen Plandatensatz aus der zugehörigen Liste Pläne.
      2. Wählen Sie den zugehörigen Link Import aus.
        Datensätze werden für den Plan in den zugehörigen Listen „Arbeitselemente“, „Planversionen“ und „Funktionen“ erstellt.
        • Die zugehörige Liste der Arbeitselemente zeigt Aufgaben, Fehler und Stories.

          Die FelderNativer Status und Nativer Typ des Arbeitselements enthalten die ursprünglichen Status- und Typwerte aus dem Quelltool.

        • Die zugehörige Liste „Planversionen“ zeigt Releases an.
        • Die zugehörige Liste „Funktionen“ zeigt Epics und Funktionen an.
        Hinweis:
        Der historische Import von Azure DevOps Arbeitselementen wird für den CMMI-Prozess für agile Boards nicht unterstützt.
      3. Wählen Sie in der zugehörigen Liste „Apps“ Bearbeiten... aus, um eine App auszuwählen, die dem Plan (Projekt) zugeordnet werden soll, oder wählen Sie Neu, um eine zu erstellen.
        Einem Plan muss ein App-Datensatz zugeordnet sein, um das Setup des Planungstools abzuschließen.
    5. Importieren Sie für die erkannten Repositorys Verlaufsdaten für das Tool, und ordnen Sie das Repository einer App zu.
      1. Öffnen Sie den Repository-Datensatz aus der zugehörigen Liste Repositorys.
      2. Wählen Sie Importieren.
        Importierte Verzweigungs- und Commit-Datensätze aus dem Repository werden den entsprechenden zugehörigen Listen hinzugefügt.
      3. Wählen Sie im Feld App die Nachschlageliste aus, und wählen Sie einen App-Datensatz aus, der dem Repository zugeordnet werden soll, oder klicken Sie auf Neu, um einen zu erstellen.
      Importierte Verlaufsdatensätze werden den entsprechenden zugehörigen Listen hinzugefügt.

    Nächste Maßnahme

    Für Azure -Pipelines schließt Modellieren Sie eine Azure-Pipeline in DevOps die Konfiguration in DevOps Change-Geschwindigkeitab.
    • Ordnen Sie jede Pipeline einer bestimmten App zu.
    • Erstellen Sie Pipeline-Schritte, und ordnen Sie jeden Schritt einem Pipeline-Auftrag Azure zu.
    • Konfigurieren Sie die Change-Steuerung.