Onboarding GitHub von auf DevOps Change-Geschwindigkeit  – Klassisch

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 3 Minuten Lesedauer
  • Verbinden Sie Ihre Instanz GitHub, um Repositorys, Pläne und Pipelines zu erkennen, zu konfigurieren und zu importieren.

    Vorbereitungen

    Erforderliche Rolle: sn_devops.admin oder sn_devops.tool_owner

    Führen Sie die im Abschnitt „Erste Schritte“ angegebenen Schritte aus, bevor Sie eine Verbindung zu einem Tool herstellen.

    Warum und wann dieser Vorgang ausgeführt wird

    • Stellen Sie eine Verbindung mit GitHub her, und rufen Sie die Webhook-URL ab, wenn Sie einen DevOps -Tooldatensatz übermitteln.
    • Erkennen Sie Repositorys und Pläne.
    • Konfigurieren Sie den Webhook im Repository GitHub.
    • Importieren Sie Verzweigungs- und Commit-Datensätze.

    Prozedur

    1. Geben Sie die Instanzdetails GitHub ein, um eine Verbindung zu DevOps Change-Geschwindigkeit herzustellen, indem Sie zu navigieren Alle > DevOps > Tools > Neu erstellen (veraltet).
    2. Geben Sie einen Wert in das Feld Toolname ein, und füllen Sie die Tooldetails aus.
      Tabelle : 1. Formular „DevOps-Tool erstellen“.
      Feld Beschreibung
      Toolintegration

      Zu integrierendes Tool. Wählen Sie in diesem Fall GitHubaus.

      Tool-URL

      URL der zu integrierenden vorhandenen Instanz GitHub. Beispiel: https://api.github.com

      GitHub Anmeldeinformationstyp
      • Basisauth.
        • GitHub-Anwendername
        • Persönliches Zugriffstoken (klassisch)

        Mit der Standardauthentifizierung wird nur ein persönliches Zugriffstoken (klassisch) unterstützt. Wenn Sie ein persönliches Zugriffstoken (klassisch) für GitHubgenerieren, müssen Sie die zu autorisierenden Bereiche angeben, wenn Sie keinen vollständigen Zugriff gewähren. Die Mindestbereiche, die Sie für die Autorisierung auswählen müssen, sind repo, admin:repo_hook und user:email.

      • OAuth

        GitHub Tool-Anmeldeinformationen. Weitere Informationen finden Sie unter GitHub OAuth 2.0-Anmeldeinformationen für DevOps Change-Geschwindigkeiteinrichten.

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

    3. Wahlweise: Wählen Sie MID-Server für ein lokales Tool aus, das an einen MID-Server angehängt ist.

      Die Anwendung wird automatisch auf „DevOps“ und die Fähigkeit auf „REST“ festgelegt.

      Hinweis:
      Der Gewährungstyp „OAuth-Autorisierungscode“ wird für GitHub und GitHub Enterprise mit MID-Server unterstützt.
    4. Wählen Sie Absenden.
    Bei erfolgreicher Tool-Erstellung gelangen Sie zur Tooldatensatzseite.
    1. 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. Wählen Sie Erkennen aus, um vorhandene Repositorys, Pläne oder Pipelines für das Tool zu erkennen.
      Repository-Datensätze werden der zugehörigen Liste „Repositorys“ hinzugefügt.
    3. Konfigurieren Sie die Webhook-URL in einem GitHub -Repository automatisch, um Benachrichtigungen an das DevOps-Tool zu senden, indem Sie Konfigurierenauswählen.
      Alternativ können Sie die nächtliche Abfrage aktivieren, um das Datensystem für alle verfolgten Repositorys oder Pipelines abzurufen, indem Sie die Eigenschaft Abruf aktivieren auf Jafestlegen.
      Hinweis:
      Wenn Sie keine Administratorrechte für das Tool GitHub haben (um die automatische Konfiguration der Webhook-URL zu ermöglichen), müssen Sie es möglicherweise vom Tooladministrator für Sie konfigurieren (erstellen und konfigurieren Sie die Webhook-URL manuell in Ihrer Toolinstanz). 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.
    4. Klicken Sie auf Importieren, um Verlaufsdaten aus dem Repository zu importieren.
      Importierte Verzweigungs- und Commit-Datensätze aus dem Repository werden den entsprechenden zugehörigen Listen hinzugefügt.
    5. Klicken Sie im Feld App auf die Nachschlageliste, und wählen Sie einen App-Datensatz aus, der dem Repository zugeordnet werden soll, oder klicken Sie auf Neu, um einen zu erstellen.