Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Connecter GitLab
<a name="connecting-to-cicd-pipelines-connecting-gitlab"></a>

GitLab l'intégration permet à l' AWS DevOps agent de surveiller les déploiements à partir de GitLab pipelines afin d'éclairer les enquêtes causales lors de la réponse à un incident. Cette intégration suit un processus en deux étapes : enregistrement au niveau du compte GitLab, suivi de la connexion de projets spécifiques à des espaces d'agent individuels.

## Inscription GitLab (au niveau du compte)
<a name="registering-gitlab-account-level"></a>

GitLab est enregistré au niveau du AWS compte et partagé entre tous les espaces d'agent de ce compte. Les espaces d'agent individuels peuvent ensuite choisir les projets spécifiques qui s'appliquent à leur espace d'agent.

### Étape 1 : Accédez aux fournisseurs de pipelines
<a name="step-1-navigate-to-pipeline-providers"></a>

1. Connectez-vous à la console AWS de gestion

1. Accédez à la console de AWS DevOps l'agent

1. Accédez à la page **Capability Providers** (accessible depuis la navigation latérale)

1. Recherchez **GitLab**dans la section Fournisseurs **disponibles** sous **Pipeline** et cliquez sur **Enregistrer**

### Étape 2 : Configuration de la GitLab connexion
<a name="step-2-configure-gitlab-connection"></a>

Sur la page GitLab d'enregistrement, configurez les éléments suivants :

**Type de connexion** : indiquez si vous vous connectez en tant que personne ou en tant que groupe :
+ **Personnel** (par défaut) — Votre compte GitLab utilisateur individuel avec un nom d'utilisateur et un profil
+ **Groupe** — Dans GitLab, vous utilisez des groupes pour gérer un ou plusieurs projets connexes en même temps

**GitLab type d'instance** — Choisissez le type d' GitLab instance auquel vous vous connectez :
+ **GitLab.com** (par défaut) — Le GitLab service public
+ **Auto-hébergé accessible au public GitLab** : cochez la case **Utiliser un point de terminaison GitLab auto-hébergé** et fournissez l'URL de votre instance GitLab 

**Note**  
**Actuellement, seules les GitLab instances accessibles au public sont prises en charge.

**Jeton d'accès** — Fournissez un jeton d'accès GitLab personnel :

1. Dans un onglet de navigateur distinct, connectez-vous à votre GitLab compte

1. Accédez à vos paramètres utilisateur et sélectionnez **Access Tokens**

1. Créez un nouveau jeton d'accès personnel avec les autorisations suivantes :
   + `read_repository`— Nécessaire pour accéder au contenu du référentiel
   + `read_virtual_registry`— Nécessaire pour accéder aux informations du registre virtuel
   + `read_registry`— Nécessaire pour accéder aux informations du registre
   + `api`— Nécessaire pour accéder à l'API en lecture et en écriture
   + `self_rotate`- Nécessaire pour la rotation des jetons. Cette fonctionnalité n'est actuellement pas prise en charge par l' AWS DevOps Agent mais le sera ultérieurement. En ajoutant maintenant, il n'est plus nécessaire de créer un nouveau jeton dans le futur.

1. Définissez l'expiration du jeton sur un maximum de 365 jours à compter de la date actuelle

1. Copiez le jeton généré

1. Retournez à la console de AWS DevOps l'agent

1. Collez le jeton dans le champ « Jeton d'accès »

### Étape 3 : Compléter l'enregistrement
<a name="step-3-complete-registration"></a>

**Tags (Facultatif)** — Ajoutez des AWS tags à l' GitLab enregistrement à des fins d'organisation.

Cliquez sur **Suivant** pour vérifier votre configuration, puis sur **Soumettre** pour terminer le processus GitLab d'enregistrement. Le système validera votre jeton d'accès et établira la connexion.

## Connecter des projets à un espace d'agents
<a name="connecting-projects-to-an-agent-space"></a>

Après vous être enregistré GitLab au niveau du compte, vous pouvez connecter des projets spécifiques à des espaces d'agent individuels :

1. Dans la console AWS DevOps Agent, sélectionnez votre espace agent

1. Accédez à l'onglet **Fonctionnalités**

1. Dans la section **Pipeline**, cliquez sur **Ajouter**

1. Sélectionnez **GitLab**dans la liste des fournisseurs disponibles

1. Sélectionnez les GitLab projets pertinents pour votre espace d'agents

1. Cliquez sur **Enregistrer**

AWS DevOps L'agent surveillera ces projets pour détecter les déploiements à partir de GitLab pipelines afin d'éclairer les enquêtes causales.

## Gestion des GitLab connexions
<a name="managing-gitlab-connections"></a>
+ **Mise à jour du jeton** d'accès : si votre jeton d'accès expire ou doit être mis à jour, vous pouvez le mettre à jour dans la console de l' AWS DevOps agent en modifiant l' GitLab enregistrement au niveau du compte.
+ **Affichage des projets connectés** : dans la console AWS DevOps Agent, sélectionnez votre espace agent et accédez à l'onglet Fonctionnalités pour afficher les projets connectés dans la section Pipeline.
+ **Suppression de la GitLab connexion** : pour déconnecter GitLab des projets d'un espace agent, sélectionnez la connexion dans la section Pipeline et cliquez sur **Supprimer**. Pour supprimer complètement l' GitLab enregistrement, supprimez-le d'abord de tous les agents Spaces, puis supprimez l'enregistrement au niveau du compte.