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.
# Anschluss an CI/CD Rohrleitungen
Die CI/CD-Pipeline-Integration ermöglicht es dem AWS DevOps Agenten, Bereitstellungen zu überwachen und bei Untersuchungen Codeänderungen mit Betriebsvorfällen zu korrelieren. Durch die Verbindung Ihrer CI/CD Anbieter kann der Agent Bereitstellungsereignisse verfolgen und sie mit AWS Ressourcen verknüpfen, um bei der Reaktion auf Vorfälle mögliche Ursachen zu identifizieren.
AWS DevOps Agent unterstützt die Integration mit gängigen CI/CD Plattformen in einem zweistufigen Prozess:
1. **Registrierung auf Kontoebene** — Registrieren Sie Ihren CI/CD Anbieter einmal auf Kontoebene AWS
1. **Agent Space-Verbindung** — Connect spezifische Projekte oder Repositorys mit einzelnen Agent Spaces, je nach den Bedürfnissen deiner Organisation
Dieser Ansatz ermöglicht es Ihnen, CI/CD Anbieterregistrierungen für mehrere Agent Spaces gemeinsam zu nutzen und gleichzeitig die genaue Kontrolle darüber zu behalten, welche Projekte von jedem Space überwacht werden.
## Unterstützte Anbieter CI/CD
AWS DevOps Agent unterstützt die folgenden CI/CD Plattformen:
+ **GitHub**— Stellen Sie mithilfe der AWS DevOps GitHub Agent-App eine Verbindung zu Repositorys von [GitHub.com](http://GitHub.com) her.
+ **GitLab**— Connect Projekte über [GitLab.com,](http://gitlab.com) verwaltete GitLab Instanzen oder öffentlich zugängliche, selbst gehostete GitLab Bereitstellungen.
**Topics**
+ [Verbindung herstellen GitHub](connecting-to-cicd-pipelines-connecting-github.md)
+ [Verbindung herstellen GitLab](connecting-to-cicd-pipelines-connecting-gitlab.md)
# 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
1. Melden Sie sich bei der AWS Management Console an
1. Navigieren Sie zur AWS DevOps Agent-Konsole
1. Gehen Sie zur Registerkarte **Funktionen**
1. Klicken Sie im Abschnitt **Pipeline** auf **Hinzufügen**
1. Wählen Sie **GitHub**aus 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](configuring-capabilities-for-aws-devops-agent-connecting-to-privately-hosted-tools.md).
**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
1. Sie werden GitHub zur Installation der AWS DevOps GitHub Agent-App weitergeleitet.
1. Wählen Sie aus, in welchem Konto oder welcher Organisation die App installiert werden soll.
1. 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.
1. Ihr Browser wird auf die Seite „ GitHub App erstellen“ Ihrer GitHub Enterprise Server-Instanz weitergeleitet.
1. 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**.
1. 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
1. Sie sehen die Seite „**Installieren und autorisieren**“ für die GitHub App.
1. 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
1. Klicken Sie auf **Installieren und autorisieren**.
1. 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:
1. Wählen Sie in der AWS DevOps Agent-Konsole Ihren Agent Space aus
1. Gehen Sie zur Registerkarte **Funktionen**
1. Klicken Sie im Abschnitt **Pipeline** auf **Hinzufügen**
1. Wählen Sie **GitHub**aus der Liste der verfügbaren Anbieter
1. Wählen Sie die Teilmenge der Repositorys aus, die für diesen Agent Space relevant sind
1. 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.
# Verbindung herstellen GitLab
GitLab Die Integration ermöglicht es dem AWS DevOps Agenten, Bereitstellungen von GitLab Pipelines aus zu überwachen, um bei der Reaktion auf Vorfälle als Grundlage für Ursachenuntersuchungen zu dienen. Diese Integration folgt einem zweistufigen Prozess: Registrierung von auf Kontoebene GitLab, gefolgt von der Verbindung bestimmter Projekte mit einzelnen Agent Spaces.
## Registrierung GitLab (auf Kontoebene)
GitLab wird auf AWS Kontoebene registriert und von allen Agent Spaces in diesem Konto gemeinsam genutzt. Einzelne Agent Spaces können dann wählen, welche spezifischen Projekte für ihren Agent Space gelten.
### Schritt 1: Navigieren Sie zu den Pipeline-Anbietern
1. Melden Sie sich bei der AWS Management Console an
1. Navigieren Sie zur AWS DevOps Agent-Konsole
1. Gehen Sie zur Seite **Capability Providers** (zugänglich über die Seitennavigation)
1. Suchen Sie **GitLab**im Abschnitt **Verfügbare** Anbieter unter **Pipeline** und klicken Sie auf **Registrieren**
### Schritt 2: GitLab Verbindung konfigurieren
Konfigurieren Sie auf der GitLab Registrierungsseite Folgendes:
**Verbindungstyp** — Wählen Sie aus, ob Sie als Person oder als Gruppe eine Verbindung herstellen möchten:
+ **Persönlich** (Standard) — Ihr individuelles GitLab Benutzerkonto mit einem Benutzernamen und einem Profil
+ **Gruppe** — In verwenden Sie Gruppen GitLab, um ein oder mehrere verwandte Projekte gleichzeitig zu verwalten
**GitLab Instanztyp** — Wählen Sie aus, mit welchem GitLab Instanztyp Sie eine Verbindung herstellen möchten:
+ **GitLab.com** (Standard) — Der öffentliche GitLab Dienst
+ **Öffentlich zugänglich, selbst gehostet GitLab** — Markieren Sie das Kästchen ** GitLab Self Hosted Endpoint verwenden** und geben Sie die URL zu Ihrer GitLab Instance ein
**Anmerkung**
**Derzeit werden nur öffentlich zugängliche GitLab Instanzen unterstützt.
**Zugriffstoken** — Stellen Sie ein GitLab persönliches Zugriffstoken bereit:
1. Melden Sie sich in einem separaten Browser-Tab bei Ihrem GitLab Konto an
1. Navigieren Sie zu Ihren Benutzereinstellungen und wählen Sie **Access Tokens**
1. Erstellen Sie ein neues persönliches Zugriffstoken mit den folgenden Berechtigungen:
+ `read_repository`— Erforderlich für den Zugriff auf Repository-Inhalte
+ `read_virtual_registry`— Erforderlich für den Zugriff auf virtuelle Registrierungsinformationen
+ `read_registry`— Erforderlich für den Zugriff auf Registrierungsinformationen
+ `api`— Erforderlich für den Lese- und Schreibzugriff auf die API
+ `self_rotate`- Erforderlich für rotierende Tokens. Diese Funktion wird derzeit von AWS DevOps Agent nicht unterstützt, wird aber zu einem späteren Zeitpunkt unterstützt. Wenn Sie es jetzt hinzufügen, müssen Sie in future kein neues Token erstellen.
1. Legen Sie den Ablauf des Tokens auf maximal 365 Tage ab dem aktuellen Datum fest
1. Kopieren Sie das generierte Token
1. Kehren Sie zur AWS DevOps Agentenkonsole zurück
1. Fügen Sie das Token in das Feld „Zugriffstoken“ ein
### Schritt 3: Schließen Sie die Registrierung ab
**(Optional) Stichwörter** — Fügen Sie der GitLab Registrierung aus organisatorischen Gründen AWS Stichwörter hinzu.
Klicken Sie auf **Weiter**, um Ihre Konfiguration zu überprüfen, und klicken Sie dann auf **Senden**, um den GitLab Registrierungsprozess abzuschließen. Das System validiert Ihr Zugriffstoken und stellt die Verbindung her.
## Projekte mit einem Agent Space verbinden
Nachdem Sie sich auf GitLab Kontoebene registriert haben, können Sie bestimmte Projekte mit einzelnen Agent Spaces verbinden:
1. Wählen Sie in der AWS DevOps Agent-Konsole Ihren Agent Space aus
1. Gehen Sie zur Registerkarte **Funktionen**
1. Klicken Sie im Abschnitt **Pipeline** auf **Hinzufügen**
1. Wählen Sie **GitLab**aus der Liste der verfügbaren Anbieter
1. Wählen Sie die GitLab Projekte aus, die für Ihren Agent Space relevant sind
1. Klicken Sie auf **Speichern**
AWS DevOps Der Agent überwacht diese Projekte im Hinblick auf Implementierungen von GitLab Pipelines, um anhand von Ursachenuntersuchungen Informationen zu liefern.
## Verbindungen verwalten GitLab
+ **Aktualisierung des Zugriffstokens** — Wenn Ihr Zugriffstoken abläuft oder aktualisiert werden muss, können Sie es in der AWS DevOps Agent-Konsole aktualisieren, indem Sie die GitLab Registrierung auf Kontoebene ändern.
+ **Verbundene Projekte anzeigen** — Wählen Sie in der AWS DevOps Agent-Konsole Ihren Agent-Bereich aus und wechseln Sie zur Registerkarte Funktionen, um die verbundenen Projekte im Abschnitt Pipeline anzuzeigen.
+ ** GitLab Verbindung entfernen** — Um GitLab Projekte von einem Agent Space zu trennen, wählen Sie die Verbindung im Abschnitt Pipeline aus und klicken Sie auf **Entfernen**. Um die GitLab Registrierung vollständig zu entfernen, entfernen Sie sie zunächst aus allen Agent Spaces und löschen Sie dann die Registrierung auf Kontoebene.