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.
# Raccordement aux CI/CD pipelines
L'intégration du pipeline CI/CD permet à l' AWS DevOps agent de surveiller les déploiements et de corréler les modifications de code avec les incidents opérationnels au cours des enquêtes. En connectant vos CI/CD fournisseurs, l'agent peut suivre les événements de déploiement et les associer à AWS des ressources pour aider à identifier les causes profondes potentielles lors de la réponse aux incidents.
AWS DevOps L'agent prend en charge l'intégration avec les CI/CD plateformes populaires grâce à un processus en deux étapes :
1. **Enregistrement au niveau du compte** — Enregistrez votre CI/CD fournisseur une fois au niveau du AWS compte
1. **Connexion à l'espace agent** : connectez des projets ou des référentiels spécifiques à des espaces d'agent individuels en fonction des besoins de votre organisation
Cette approche vous permet de partager les inscriptions des CI/CD fournisseurs entre plusieurs espaces d'agents tout en gardant un contrôle précis sur les projets surveillés par chaque espace.
## CI/CD Fournisseurs pris en charge
AWS DevOps L'agent prend en charge les CI/CD plateformes suivantes :
+ **GitHub**— Connectez les référentiels depuis [GitHub.com](http://GitHub.com) à l'aide de l' GitHub application AWS DevOps Agent.
+ **GitLab**— Connectez des projets à partir de [GitLab.com,](http://gitlab.com) d' GitLab instances gérées ou de GitLab déploiements auto-hébergés accessibles au public.
**Rubriques**
+ [Connecter GitHub](connecting-to-cicd-pipelines-connecting-github.md)
+ [Connecter GitLab](connecting-to-cicd-pipelines-connecting-gitlab.md)
# Connecter GitHub
GitHub l'intégration permet à l' AWS DevOps agent d'accéder aux référentiels de code et de recevoir les événements de déploiement lors des enquêtes sur les incidents. Cette intégration suit un processus en deux étapes : enregistrement au niveau du compte GitHub, suivi de la connexion de référentiels spécifiques à des espaces d'agent individuels.
AWS DevOps L'agent prend en charge les instances GitHub .com (SaaS) et GitHub Enterprise Server (auto-hébergées).
## Conditions préalables
Avant de vous connecter GitHub, assurez-vous d'avoir :
+ Accès à la console d'administration de AWS DevOps l'agent
+ Un compte GitHub utilisateur ou une organisation avec des autorisations d'administrateur
+ Autorisation d'installer GitHub des applications dans votre compte ou votre organisation
Pour GitHub Enterprise Server, vous devez également :
+ Une instance de serveur GitHub d'entreprise (version 3.x ou ultérieure) accessible via HTTPS
+ L'URL HTTPS de votre instance de serveur GitHub d'entreprise (par exemple,`https://github.example.com`)
+ (Facultatif) Une connexion privée, si votre instance de serveur GitHub d'entreprise n'est pas accessible au public
## Inscription GitHub (au niveau du compte)
GitHub est enregistré au niveau du AWS compte et partagé entre tous les espaces d'agent de ce compte. Vous ne devez vous inscrire qu' GitHub une seule fois par AWS compte.
### Étape 1 : Accédez aux fournisseurs de pipelines
1. Connectez-vous à la console AWS de gestion
1. Accédez à la console de AWS DevOps l'agent
1. Accédez à l'onglet **Fonctionnalités**
1. Dans la section **Pipeline**, cliquez sur **Ajouter**
1. Sélectionnez **GitHub**dans la liste des fournisseurs disponibles
Si ce GitHub n'est pas encore le cas, il vous sera demandé de l'enregistrer d'abord.
### Étape 2 : Choisissez le type de connexion
Sur l'écran « Enregistrer un GitHub compte/une organisation », indiquez si vous vous connectez en tant qu'utilisateur ou en tant qu'organisation :
+ **Utilisateur** — Votre GitHub compte personnel avec un nom d'utilisateur et un profil
+ **Organisation** — Un GitHub compte partagé où plusieurs personnes peuvent collaborer sur de nombreux projets à la fois
Si vous vous connectez à une instance de serveur GitHub d'entreprise, cochez la case **Utiliser un serveur GitHub d'entreprise** et entrez l'URL HTTPS de votre instance (par exemple,`https://github.example.com`).
Si votre instance GitHub Enterprise Server n'est pas accessible au public, vous pouvez éventuellement configurer une connexion privée pour permettre à l' AWS DevOps agent d'accéder à votre instance en toute sécurité. Pour de plus amples informations, veuillez consulter [Connexion à des outils hébergés en privé](configuring-capabilities-for-aws-devops-agent-connecting-to-privately-hosted-tools.md).
**Note**
**N'incluez `/api/v3` aucun chemin de fin dans l'URL. Entrez uniquement l'URL de base.
### Étape 3 : configurer l' GitHub application
Cliquez sur **Soumettre** pour démarrer le processus de configuration de l'application. Les étapes suivantes varient selon que vous vous connectez à GitHub .com ou à GitHub Enterprise Server.
#### Pour GitHub .com
1. Vous serez redirigé GitHub vers l' GitHub application AWS DevOps Agent pour y installer.
1. Sélectionnez le compte ou l'organisation dans lequel vous souhaitez installer l'application.
1. L'application permet à l' AWS DevOps agent de recevoir des événements provenant de référentiels connectés, y compris des événements de déploiement.
#### Pour GitHub Enterprise Server
GitHub Enterprise Server utilise un flux GitHub App Manifest, qui configure automatiquement une nouvelle GitHub application sur votre instance. Cela implique deux redirections vers votre instance de serveur GitHub d'entreprise.
1. Votre navigateur sera redirigé vers la page « Créer une GitHub application » de votre instance GitHub Enterprise Server.
1. Vous verrez le nom de l'application prérempli. N'hésitez pas à modifier le nom selon vos besoins. Cliquez sur **Créer une GitHub application**.
1. Vous serez redirigé vers l' AWS DevOps Agent, qui échange le code manifeste contre les informations d'identification de l'application.
### Étape 4 : sélectionner les référentiels et terminer l'installation
1. Vous verrez la page **d'installation et d'autorisation** de l' GitHub application.
1. Sélectionnez les référentiels auxquels l'application doit accéder :
+ **Tous les référentiels** : accordez l'accès à tous les référentiels actuels et futurs
+ **Sélectionnez uniquement les référentiels** : choisissez des référentiels spécifiques à partir de votre compte ou de votre organisation
1. Cliquez sur **Installer et autoriser**.
1. Vous serez redirigé vers la console de l' AWS DevOps agent, où GitHub vous serez enregistré au niveau du compte.
## Connexion de référentiels à un espace d'agents
Une fois enregistré GitHub au niveau du compte, vous pouvez connecter des référentiels 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 **GitHub**dans la liste des fournisseurs disponibles
1. Sélectionnez le sous-ensemble de référentiels correspondant à cet espace agent
1. Cliquez sur **Ajouter** pour terminer la connexion
Vous pouvez connecter différents ensembles de référentiels à différents espaces d'agent en fonction des besoins de votre organisation.
## Comprendre l' GitHub application
L' GitHub application AWS DevOps Agent :
+ Demande un accès en lecture seule à vos référentiels
+ Reçoit les événements de déploiement et autres événements du référentiel
+ Permet à AWS DevOps l'agent de corréler les modifications de code avec les incidents opérationnels
+ Peut être désinstallé à tout moment via vos GitHub paramètres
Pour GitHub Enterprise Server, l' GitHub application est automatiquement créée sur votre instance lors de l'enregistrement. Vous pouvez gérer l'accès au référentiel de l'application ou la désinstaller via **Paramètres > Applications > GitHub Applications installées**. Pour supprimer complètement la définition de l'application, accédez à **Réglages > Paramètres du développeur > GitHub Applications**.
## Gestion des GitHub connexions
+ **Mise à jour de l'accès aux** référentiels : pour modifier les référentiels auxquels GitHub l'application peut accéder, accédez aux paramètres de votre GitHub compte ou de votre organisation (ou aux paramètres de votre instance GitHub Enterprise Server), accédez aux GitHub applications installées et modifiez la configuration de l'application AWS DevOps Agent.
+ **Affichage des référentiels connectés** : dans la console de l' AWS DevOps agent, sélectionnez votre espace agent et accédez à l'onglet Fonctionnalités pour afficher les référentiels connectés dans la section Pipeline.
+ **Suppression de la GitHub connexion** : pour vous déconnecter GitHub d'un espace agent, sélectionnez la connexion dans la section Pipeline et cliquez sur **Supprimer**. Pour désinstaller complètement l' GitHub application, désinstallez-la dans les paramètres de votre GitHub compte ou de votre organisation. Pour GitHub Enterprise Server, étant donné que l' GitHub application est créée directement sur votre instance lors de l'enregistrement, vous pouvez éventuellement nettoyer entièrement l'application en effectuant les deux opérations suivantes :
+ **Désinstallez l'application** : accédez à **Paramètres > Applications > GitHub Applications installées**, cliquez sur **Configurer** dans l'application, puis désinstallez-la.
+ **Supprimer l'application** : accédez à **Réglages > Paramètres du développeur > GitHub Applications**, sélectionnez l'application, accédez à l'onglet **Avancé**, puis choisissez **Supprimer GitHub l'application**. **Avertissement :** La suppression de l' GitHub application est définitive et ne peut pas être annulée. Si vous le supprimez, vous devrez réenregistrer GitHub Enterprise Server depuis le début dans la console de l' AWS DevOps agent pour créer une nouvelle application.
# 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
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
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
**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
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
+ **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.