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.
# Connexion GitLab
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)
GitLab est enregistré au niveau du AWS compte et partagé entre tous les espaces d'agent de ce compte. Chaque inscription renvoie à un GitLab utilisateur ou à un GitLab groupe.
### Étape 1 : Accédez aux fournisseurs de pipeline
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 choisissez **Enregistrer**
### Étape 2 : Configuration de la GitLab connexion
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. Revenir à la console de AWS DevOps l'agent
1. Collez le jeton dans le champ « Jeton d'accès »
### Étape 3 : Compléter l'enregistrement
**Tags (Facultatif)** — Ajoutez des AWS tags à l' GitLab enregistrement à des fins d'organisation.
Choisissez **Suivant** pour vérifier votre configuration, puis choisissez **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
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**, choisissez **Ajouter**
1. Sélectionnez **GitLab**dans la liste des fournisseurs disponibles
1. Sélectionnez l' GitLab enregistrement qui contient les projets que vous souhaitez utiliser
1. Sélectionnez les GitLab projets pertinents pour votre espace d'agents
1. Choisissez **Enregistrer**.
AWS DevOps L'agent surveille ces projets pour détecter les déploiements à partir de GitLab pipelines afin d'éclairer les enquêtes causales. Un même espace d'agent peut utiliser des projets issus de plusieurs inscriptions. Pour ajouter des projets issus d'un autre enregistrement, répétez ces étapes.
## Configuration de la révision du code et des tests automatisés
Lorsque vous sélectionnez des projets à l'étape de GitLab connexion, ils sont automatiquement ajoutés à la section **Révision du code et tests automatisés**. Cette section définit les projets qui déclenchent automatiquement une [Révisions du code de préparation à la publication](release-management-release-readiness-code-review.md) et les fonctionnalités de test automatisées.
La configuration de la révision du code et des tests automatisés inclut :
+ **Capacités** — Choisissez des fonctionnalités de révision du code et de test automatisé pour chaque projet. La section fournit deux paramètres par projet :
+ **Déclenchement automatique de la révision des modifications** : lorsqu'il est activé pour un projet, DevOps l'agent exécute automatiquement un [Révisions du code de préparation à la publication](release-management-release-readiness-code-review.md) chaque fois qu'une demande de fusion est ouverte ou mise à jour. Les résultats de l'examen apparaissent sous forme de commentaires intégrés à la demande de fusion. Ceci est activé par défaut pour tous les projets connectés.
+ **Tests de vérification automatisés** : lorsqu'il est activé pour un projet, DevOps l'agent crée, exécute et teste les modifications apportées au code dans un environnement de vérification géré lors de la révision du code. Cela permet une validation fonctionnelle allant au-delà de l'analyse statique. Pour plus d'informations, consultez la section [Tests de vérification automatisés](release-management-release-readiness-code-review.md). Ceci est activé par défaut pour tous les projets connectés.
+ **Liste des projets** : affiche tous les projets que vous avez sélectionnés lors de l'étape de connexion. Utilisez le champ de recherche pour filtrer les projets par nom. Chaque projet comporte des cases à cocher indépendantes pour les deux fonctionnalités.
+ **Rôle d'exécution** (facultatif) — Choisissez le rôle IAM que l' DevOps agent assume pour exécuter les fonctionnalités automatisées sur les projets que vous avez sélectionnés. Ce rôle est utilisé pour accéder aux services internes nécessaires lors des builds, tels que les registres de packages privés et les systèmes de stockage d'artefacts. Nous vous recommandons d'utiliser un rôle différent de votre rôle d'agent principal.
Pour configurer les révisions automatisées :
1. Après avoir connecté vos projets, accédez à la section **Révision du code et tests automatisés** dans vos paramètres GitLab d'intégration.
1. Pour chaque projet, activez ou désactivez la fonction de **validation automatique des modifications** selon que vous souhaitez ou non des révisions automatiques des demandes de fusion.
1. Pour chaque projet, activez ou désactivez la fonctionnalité de **test de vérification automatique** selon que vous souhaitez ou non des [tests de vérification automatisés](release-management-release-readiness-code-review.md) dans un environnement de vérification géré.
1. Vous pouvez éventuellement sélectionner un rôle IAM dans la liste déroulante des **rôles d'exécution** que l' DevOps agent assumera lors de l'exécution des fonctionnalités automatisées sur les projets que vous avez sélectionnés.
1. Choisissez **Enregistrer** pour appliquer votre configuration.
Une fois configurée, toute nouvelle demande de fusion dans un projet pour lequel la **révision des modifications par déclenchement automatique** est activée déclenchera automatiquement une révision du code de préparation à la publication. Si les **tests de vérification automatisés** sont également activés, la révision inclut la validation fonctionnelle dans un environnement de vérification. Pour plus d'informations sur les révisions de code, consultez[Révisions du code de préparation à la publication](release-management-release-readiness-code-review.md).
## Gestion des GitLab connexions
+ **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, puis choisissez **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.