View a markdown version of this page

Connecter GitLab - AWS DevOps Agent

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

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

  1. Connectez-vous à la console AWS de gestion

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

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

  4. Recherchez GitLabdans la section Fournisseurs disponibles sous Pipeline et cliquez sur 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

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

  3. 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.

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

  5. Copiez le jeton généré

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

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

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

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

  2. Accédez à l'onglet Fonctionnalités

  3. Dans la section Pipeline, cliquez sur Ajouter

  4. Sélectionnez GitLabdans la liste des fournisseurs disponibles

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

  6. 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

  • 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.