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.
# Créez une connexion avec GitHub
Vous pouvez utiliser le AWS Management Console ou le AWS Command Line Interface (AWS CLI) pour créer une connexion à GitHub.
Avant de commencer :
+ Vous devez déjà avoir créé un compte auprès de GitHub.
+ Vous devez déjà avoir créé votre référentiel de code tiers.
**Note**
Pour créer la connexion, vous devez être le propriétaire de GitHub l'organisation. Pour les référentiels qui ne font pas partie d'une organisation, vous devez être le propriétaire du référentiel.
**Topics**
+ [Création d'une connexion à GitHub (console)](#connections-create-github-console)
+ [Création d'une connexion à GitHub (CLI)](#connections-create-github-cli)
## Création d'une connexion à GitHub (console)
Vous pouvez utiliser la console pour créer une connexion à GitHub.
**Note**
À compter du 1er juillet 2024, la console crée des connexions avec `codeconnections` l'ARN de la ressource. Les ressources associées aux deux préfixes de service continueront de s'afficher dans la console.
1. Connectez-vous à la AWS Management Console console Developer Tools et ouvrez-la à l'adresse[https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections).
1. Choisissez **Settings > Connections (Paramètres > Connexions)**, puis **Create connection (Créer une connexion)**.
1. Pour créer une connexion à un référentiel GitHub ou à un référentiel GitHub Enterprise Cloud, sous **Sélectionnez un fournisseur**, choisissez **GitHub**. Dans **Connection name (Nom de la connexion)**, saisissez le nom de la connexion que vous souhaitez créer. Choisissez **Connect to GitHub**, puis passez à l'étape 2.
![\[Capture d'écran de la console montrant l'option de connexion sélectionnée pour Bitbucket.\]](http://docs.aws.amazon.com/fr_fr/dtconsole/latest/userguide/images/github-conn.png)
**Pour créer une connexion avec GitHub**
1. Dans **les paramètres de GitHub connexion**, le nom de votre connexion apparaît dans **Nom de la connexion**. Choisissez **Connect to (Se connecter à) GitHub**. La page de demande d'accès s'affiche.
![\[Capture d'écran de la console montrant la page d'accès au GitHub compte.\]](http://docs.aws.amazon.com/fr_fr/dtconsole/latest/userguide/images/github-conn-access.png)
1. Choisissez **Autoriser le AWS connecteur pour GitHub**. La page de connexion affiche et affiche le champ **GitHub Applications**.
![\[Capture d'écran de la console montrant la page de GitHub connexion initiale avec le champ GitHub Apps.\]](http://docs.aws.amazon.com/fr_fr/dtconsole/latest/userguide/images/github-conn-access-app.png)
1. Sous **GitHub Applications**, choisissez une installation d'application ou choisissez **Installer une nouvelle application** pour en créer une.
**Note**
Installez une application pour toutes vos connexions à un fournisseur particulier. Si vous avez déjà installé le AWS Connector for GitHub app, choisissez-le et ignorez cette étape.
1. Sur la GitHub page Installer le **AWS connecteur pour**, choisissez le compte sur lequel vous souhaitez installer l'application.
![\[Capture d'écran de la console montrant la page AWS du connecteur pour GitHub l'installation.\]](http://docs.aws.amazon.com/fr_fr/dtconsole/latest/userguide/images/github-conn-access-app-install1.png)
**Note**
Vous n'installez l'application qu'une seule fois pour chaque GitHub compte. Si vous avez déjà installé l'application, vous pouvez choisir **Configure (Configurer)** pour passer à une page de modification pour l'installation de votre application, ou vous pouvez utiliser le bouton Précédent pour revenir à la console.
1. Sur la GitHub page **Installer le AWS connecteur pour**, laissez les valeurs par défaut et choisissez **Installer**.
![\[Capture d'écran de la console montrant la page AWS du deuxième connecteur pour GitHub l'installation.\]](http://docs.aws.amazon.com/fr_fr/dtconsole/latest/userguide/images/github-conn-access-app-install2.png)
Après cette étape, une page d'autorisations mise à jour peut s'afficher GitHub.
1. Si une page s'affiche indiquant que des autorisations ont été mises à jour pour l' GitHub application AWS Connector, choisissez **Accepter les nouvelles autorisations**.
![\[Capture d'écran de la console montrant la page AWS Connector pour les autorisations GitHub mises à jour.\]](http://docs.aws.amazon.com/fr_fr/dtconsole/latest/userguide/images/accept-new-permissions.png)
1. Vous revenez à la GitHub page **Connect to**. L'identifiant de connexion de votre nouvelle installation apparaît dans **GitHubApps**. Choisissez **Connect (Connexion)**.
### Consultez votre connexion créée
+ La connexion créée s'affiche dans la liste des connexions.
![\[Capture d'écran de la console montrant la liste des connexions avec la connexion créée avec succès.\]](http://docs.aws.amazon.com/fr_fr/dtconsole/latest/userguide/images/connections-create-ghe-complete.png)
## Création d'une connexion à GitHub (CLI)
Vous pouvez utiliser le AWS Command Line Interface (AWS CLI) pour créer une connexion à GitHub.
Pour ce faire, utilisez la commande **create-connection**.
**Important**
Une connexion créée via le AWS CLI ou AWS CloudFormation est en `PENDING` état par défaut. Après avoir créé une connexion à l'aide de la CLI CloudFormation, utilisez la console pour modifier la connexion afin de définir son état`AVAILABLE`.
**Pour créer une connexion avec GitHub**
1. Ouvrez une invite de terminal (Linux, macOS ou Unix) ou de commande (Windows). Utilisez le AWS CLI pour exécuter la **create-connection** commande, en spécifiant le `--provider-type` et `--connection-name` pour votre connexion. Dans cet exemple, le nom du fournisseur tiers est `GitHub` et le nom de connexion spécifié est `MyConnection`.
```
aws codeconnections create-connection --provider-type GitHub --connection-name MyConnection
```
En cas de succès, cette commande renvoie les informations ARN de connexion semblables à ce qui suit.
```
{
"ConnectionArn": "arn:aws:codeconnections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f"
}
```
1. Utilisez la console pour terminer la connexion. Pour de plus amples informations, veuillez consulter [Mettre à jour une connexion en attente](connections-update.md).