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. 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
<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 klicken Sie auf **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 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
<a name="step-3-complete-registration"></a>

**(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
<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. 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
<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.