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 GitLab
<a name="connecting-to-cicd-pipelines-connecting-gitlab"></a>

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)
<a name="registering-gitlab-account-level"></a>

GitLab wird auf AWS Kontoebene registriert und von allen Agent Spaces in diesem Konto gemeinsam genutzt. Jede Registrierung ist mit einem GitLab Benutzer oder einer GitLab Gruppe verknüpft.

### Schritt 1: Navigieren Sie zu den Pipeline-Anbietern
<a name="step-1-navigate-to-pipeline-providers"></a>

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 wählen Sie **Registrieren**

### Schritt 2: GitLab Verbindung konfigurieren
<a name="step-2-configure-gitlab-connection"></a>

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 Instanz 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
<a name="step-3-complete-registration"></a>

**(Optional) Stichwörter** — Fügen Sie der GitLab Registrierung aus organisatorischen Gründen AWS Stichwörter hinzu.

Wählen Sie **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
<a name="connecting-projects-to-an-agent-space"></a>

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. Wählen Sie im Abschnitt **Pipeline** die Option **Hinzufügen**

1. Wählen Sie **GitLab**aus der Liste der verfügbaren Anbieter

1. Wählen Sie die GitLab Registrierung aus, die die Projekte enthält, die Sie verwenden möchten

1. Wählen Sie die GitLab Projekte aus, die für Ihren Agent Space relevant sind

1. Wählen Sie **Speichern** aus.

AWS DevOps Der Agent überwacht diese Projekte von GitLab Pipelines aus im Hinblick auf Implementierungen, um anhand von Ursachenuntersuchungen Informationen zu liefern. Ein einziger Agent Space kann Projekte aus mehreren Registrierungen verwenden. Um Projekte aus einer anderen Registrierung hinzuzufügen, wiederholen Sie diese Schritte.

## Konfiguration von Codeüberprüfung und automatisiertem Testen
<a name="configuring-code-review-and-automated-testing"></a>

Wenn Sie im GitLab Verbindungsschritt Projekte auswählen, werden sie automatisch zum Abschnitt **Codeüberprüfung und automatisiertes Testen** hinzugefügt. In diesem Abschnitt wird konfiguriert, welche Projekte automatisch A auslösen [Code-Reviews zur Veröffentlichungsbereitschaft](release-management-release-readiness-code-review.md) und welche Testfunktionen automatisiert werden.

Die Konfiguration für Codeüberprüfung und automatisiertes Testen umfasst:
+ **Funktionen** — Wählen Sie für jedes Projekt Funktionen zur Codeüberprüfung und zum automatisierten Testen aus. Dieser Abschnitt enthält zwei Einstellungen pro Projekt:
  + **Automatische Überprüfung von Änderungen auslösen** — Wenn diese Option für ein Projekt aktiviert ist, wird der DevOps Agent [Code-Reviews zur Veröffentlichungsbereitschaft](release-management-release-readiness-code-review.md) jedes Mal, wenn eine Zusammenführungsanfrage geöffnet oder aktualisiert wird, automatisch ausgeführt. Überprüfungsergebnisse werden als Inline-Kommentare zur Zusammenführungsanfrage angezeigt. Dies ist standardmäßig für alle verbundenen Projekte aktiviert.
  + **Automatisierte Überprüfungstests** — Wenn diese Option für ein Projekt aktiviert ist, erstellt, führt der DevOps Agent Ihre Codeänderungen während der Code-Reviews in einer verwalteten Überprüfungsumgebung aus und testet sie. Dies ermöglicht eine funktionale Validierung, die über die statische Analyse hinausgeht. Weitere Informationen finden Sie unter [Automatisierte Überprüfungstests](release-management-release-readiness-code-review.md). Dies ist standardmäßig für alle verbundenen Projekte aktiviert.
+ **Projektliste** — Zeigt alle Projekte an, die Sie während des Verbindungsschritts ausgewählt haben. Verwenden Sie das Suchfeld, um Projekte nach Namen zu filtern. Jedes Projekt hat unabhängige Checkboxen für beide Funktionen.
+ **Runtime-Rolle** (optional) — Wählen Sie die IAM-Rolle aus, die der DevOps Agent für die Ausführung automatisierter Funktionen in Ihren ausgewählten Projekten übernimmt. Diese Rolle wird beim Zugriff auf interne Dienste verwendet, die während der Erstellung benötigt werden, z. B. private Paketregistrierungen und Artefaktspeichersysteme. Wir empfehlen, eine andere Rolle als Ihre primäre Agentenrolle zu verwenden.

So konfigurieren Sie automatische Bewertungen:

1. Nachdem Sie Ihre Projekte verbunden haben, navigieren Sie in Ihren GitLab Integrationseinstellungen zum Abschnitt **Codeüberprüfung und automatisiertes Testen**.

1. Aktivieren oder deaktivieren Sie für jedes Projekt die Funktion zum **automatischen Auslösen der Änderungsprüfung**, je nachdem, ob Sie automatische Überprüfungen von Anfragen zusammenführen möchten.

1. Aktivieren oder deaktivieren Sie für jedes Projekt die Funktion **Automatisierte Überprüfungstests**, je nachdem, ob Sie [automatisierte Überprüfungstests](release-management-release-readiness-code-review.md) in einer verwalteten Überprüfungsumgebung wünschen.

1. Wählen Sie optional eine IAM-Rolle aus der Dropdownliste „**Runtime-Rolle**“ aus, die der DevOps Agent bei der Ausführung automatisierter Funktionen für Ihre ausgewählten Projekte übernimmt.

1. Wählen Sie **Speichern**, um Ihre Konfiguration zu übernehmen.

Nach der Konfiguration **löst jede neue Zusammenführungsanfrage in einem Projekt, für das die automatische Änderungsprüfung aktiviert ist, automatisch eine Überprüfung** des Release-Readiness Codes aus. Wenn auch **automatisierte Überprüfungstests** aktiviert sind, umfasst die Überprüfung auch die funktionale Validierung in einer Überprüfungsumgebung. Weitere Informationen zu Code-Reviews finden Sie unter[Code-Reviews zur Veröffentlichungsbereitschaft](release-management-release-readiness-code-review.md).

## GitLab Verbindungen verwalten
<a name="managing-gitlab-connections"></a>
+ **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.