Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Verbindung herstellen GitHub
GitHub Durch die Integration kann der AWS DevOps Agent bei der Untersuchung von Vorfällen auf Code-Repositorys zugreifen und Bereitstellungsereignisse empfangen. Diese Integration folgt einem zweistufigen Prozess: Registrierung von auf Kontoebene GitHub, gefolgt von der Verbindung bestimmter Repositorys mit einzelnen Agent Spaces.
AWS DevOps Der Agent unterstützt sowohl GitHub .com- (SaaS) als auch GitHub Enterprise Server-Instanzen (selbst gehostet).
Voraussetzungen
Bevor Sie eine Verbindung herstellen GitHub, stellen Sie sicher, dass Sie über Folgendes verfügen
Zugriff auf die Administratorkonsole des AWS DevOps Agenten
Ein GitHub Benutzerkonto oder eine Organisation mit Administratorrechten
Autorisierung zur Installation von GitHub Apps in Ihrem Konto oder Ihrer Organisation
Für GitHub Enterprise Server benötigen Sie außerdem:
Eine GitHub Enterprise Server-Instanz (Version 3.x oder höher), auf die über HTTPS zugegriffen werden kann
Die HTTPS-URL Ihrer GitHub Enterprise Server-Instanz (zum Beispiel
https://github.example.com)(Optional) Eine private Verbindung, wenn Ihre GitHub Enterprise Server-Instanz nicht öffentlich zugänglich ist
Registrierung GitHub (auf Kontoebene)
GitHub wird auf AWS Kontoebene registriert und von allen Agent Spaces in diesem Konto gemeinsam genutzt. Sie müssen sich nur GitHub einmal pro AWS Konto registrieren.
Schritt 1: Navigieren Sie zu den Pipeline-Anbietern
Melden Sie sich bei der AWS Management Console an
Navigieren Sie zur AWS DevOps Agent-Konsole
Gehen Sie zur Registerkarte Funktionen
Klicken Sie im Abschnitt Pipeline auf Hinzufügen
Wählen Sie GitHubaus der Liste der verfügbaren Anbieter
Wenn es GitHub noch nicht registriert wurde, werden Sie aufgefordert, es zuerst zu registrieren.
Schritt 2: Wählen Sie den Verbindungstyp
Wählen Sie auf dem Bildschirm „ GitHub Konto/Organisation registrieren“ aus, ob Sie sich als Benutzer oder Organisation verbinden möchten:
Benutzer — Ihr persönliches GitHub Konto mit einem Benutzernamen und einem Profil
Organisation — Ein gemeinsam genutzter GitHub Account, über den mehrere Personen an vielen Projekten gleichzeitig zusammenarbeiten können
Wenn Sie eine Verbindung zu einer GitHub Enterprise Server-Instanz herstellen, aktivieren Sie das Kontrollkästchen GitHub Enterprise Server verwenden und geben Sie die HTTPS-URL Ihrer Instanz ein (z. B.https://github.example.com).
Wenn Ihre GitHub Enterprise Server-Instanz nicht öffentlich zugänglich ist, können Sie optional eine private Verbindung konfigurieren, damit der AWS DevOps Agent Ihre Instanz sicher erreichen kann. Weitere Informationen finden Sie unter Verbindung zu privat gehosteten Tools herstellen.
Anmerkung
Fügen /api/v3 Sie in der URL keinen nachfolgenden Pfad ein — geben Sie nur die Basis-URL ein.
Schritt 3: Richten Sie die GitHub App ein
Klicken Sie auf Senden, um mit der Einrichtung der App zu beginnen. Die nächsten Schritte unterscheiden sich je nachdem, ob Sie eine Verbindung zu GitHub .com oder GitHub Enterprise Server herstellen.
Für GitHub .com
Sie werden GitHub zur Installation der AWS DevOps GitHub Agent-App weitergeleitet.
Wählen Sie aus, in welchem Konto oder welcher Organisation die App installiert werden soll.
Die App ermöglicht es dem AWS DevOps Agenten, Ereignisse von verbundenen Repositorys zu empfangen, einschließlich Bereitstellungsereignisse.
Für GitHub Enterprise Server
GitHub Enterprise Server verwendet einen GitHub App-Manifest-Flow, der automatisch eine neue GitHub App auf Ihrer Instanz einrichtet. Dies beinhaltet zwei Weiterleitungen zu Ihrer GitHub Enterprise Server-Instanz.
Ihr Browser wird auf die Seite „ GitHub App erstellen“ Ihrer GitHub Enterprise Server-Instanz weitergeleitet.
Sie werden sehen, dass der Name der App vorausgefüllt ist. Sie können den Namen jederzeit nach Bedarf ändern. Klicken Sie auf GitHub App erstellen.
Sie werden zurück zum AWS DevOps Agenten weitergeleitet, der den Manifestcode gegen App-Anmeldeinformationen eintauscht.
Schritt 4: Wählen Sie Repositorys aus und schließen Sie die Installation ab
Sie sehen die Seite „Installieren und autorisieren“ für die GitHub App.
Wählen Sie aus, auf welche Repositorys die App zugreifen darf:
Alle Repositorien — Gewähren Sie Zugriff auf alle aktuellen und future Repositorien
Nur Repositorys auswählen — Wählen Sie bestimmte Repositorys aus Ihrem Konto oder Ihrer Organisation
Klicken Sie auf Installieren und autorisieren.
Sie werden zurück zur AWS DevOps Agent-Konsole weitergeleitet, wo GitHub Sie auf Kontoebene als registriert angezeigt werden.
Repositorys mit einem Agent Space verbinden
Nach der Registrierung GitHub auf Kontoebene können Sie bestimmte Repositorys mit einzelnen Agent Spaces verbinden:
Wählen Sie in der AWS DevOps Agent-Konsole Ihren Agent Space aus
Gehen Sie zur Registerkarte Funktionen
Klicken Sie im Abschnitt Pipeline auf Hinzufügen
Wählen Sie GitHubaus der Liste der verfügbaren Anbieter
Wählen Sie die Teilmenge der Repositorys aus, die für diesen Agent Space relevant sind
Klicken Sie auf Hinzufügen, um die Verbindung herzustellen
Sie können je nach den Anforderungen Ihres Unternehmens verschiedene Gruppen von Repositorys mit verschiedenen Agent Spaces verbinden.
Die GitHub App verstehen
Die AWS DevOps GitHub Agent-App:
Fordert schreibgeschützten Zugriff auf Ihre Repositorys an
Empfängt Bereitstellungsereignisse und andere Repository-Ereignisse
Ermöglicht dem AWS DevOps Agenten, Codeänderungen mit betrieblichen Vorfällen zu korrelieren
Kann jederzeit über Ihre GitHub Einstellungen deinstalliert werden
Für GitHub Enterprise Server wird die GitHub App bei der Registrierung automatisch auf Ihrer Instanz erstellt. Sie können den Repository-Zugriff der App verwalten oder sie über Einstellungen > Anwendungen > Installierte GitHub Apps deinstallieren. Um die App-Definition vollständig zu löschen, gehen Sie zu Einstellungen > Entwicklereinstellungen > GitHub Apps.
GitHub Verbindungen verwalten
Repository-Zugriff aktualisieren — Um zu ändern, auf welche Repositorys die GitHub App zugreifen kann, gehen Sie zu Ihren GitHub Konto- oder Organisationseinstellungen (oder zu den Einstellungen Ihrer GitHub Enterprise Server-Instanz), navigieren Sie zu den installierten GitHub Apps und ändern Sie die Konfiguration der AWS DevOps Agent-App.
Verbundene Repositorys anzeigen — Wählen Sie in der AWS DevOps Agent-Konsole Ihren Agent Space aus und wechseln Sie zur Registerkarte Funktionen, um die verbundenen Repositorys im Abschnitt Pipeline anzuzeigen.
GitHub Verbindung entfernen — Um die Verbindung zu einem Agent Space zu GitHub trennen, wählen Sie die Verbindung im Abschnitt Pipeline aus und klicken Sie auf Entfernen. Um die GitHub App vollständig zu deinstallieren, deinstallieren Sie sie in Ihren GitHub Konto- oder Organisationseinstellungen. Da die GitHub App bei GitHub Enterprise Server während der Registrierung direkt auf Ihrer Instanz erstellt wird, können Sie die App optional vollständig bereinigen, indem Sie die beiden folgenden Schritte ausführen:
App deinstallieren — Gehen Sie zu Einstellungen > Anwendungen > Installierte GitHub Apps, klicken Sie in der App auf Konfigurieren und deinstallieren Sie sie anschließend.
App löschen — Wähle „Einstellungen“ > „Entwicklereinstellungen“ > „ GitHub Apps“, wähle die App aus, gehe zum Tab „Erweitert“ und wähle „ GitHub App löschen“. Warnung: Das Löschen der GitHub App ist dauerhaft und kann nicht rückgängig gemacht werden. Wenn Sie sie löschen, müssen Sie GitHub Enterprise Server von Anfang an in der AWS DevOps Agent-Konsole neu registrieren, um eine neue App zu erstellen.
