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éation d'une connexion à GitHub Enterprise Server
Vous utilisez des connexions pour associer vos AWS ressources à un référentiel tiers. Vous pouvez utiliser le AWS Management Console ou le AWS Command Line Interface (AWS CLI) pour créer une connexion à GitHub Enterprise Server.
Les connexions fournissent uniquement l'accès aux référentiels détenus par le compte GitHub Enterprise Server qui est utilisé lors de la création de la connexion pour autoriser l'installation de l' GitHubapplication.
Avant de commencer :
+ Vous devez déjà disposer d'une instance GitHub d'Enterprise Server et d'un référentiel.
+ Vous devez être administrateur de l'instance GitHub Enterprise Server pour créer des GitHub applications et créer une ressource hôte, comme indiqué dans cette section.
**Important**
Lorsque vous configurez votre hôte pour GitHub Enterprise Server, un point de terminaison VPC pour les données d'événements des webhooks est créé pour vous. Si vous avez créé votre hôte avant le 24 novembre 2020 et que vous souhaitez utiliser des points de terminaison PrivateLink Webhook VPC, vous devez d'abord [supprimer](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-host-delete.html) votre hôte, puis en [créer un](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-host-create.html) nouveau.
**Note**
Pour les organisations GitHub utilisant Enterprise Server ou GitLab autogérées, vous ne transmettez aucun hôte disponible. Vous créez un nouvel hôte pour chaque connexion de votre organisation, et vous devez vous assurer de saisir les mêmes informations dans les champs réseau (ID VPC, sous-réseau IDs et groupe de sécurité IDs) pour l'hôte. Pour de plus amples informations, veuillez consulter [Configuration de la connexion et de l'hôte pour les fournisseurs installés qui soutiennent les organisations](troubleshooting-connections.md#troubleshooting-organization-host).
**Topics**
+ [Création d'une connexion à GitHub Enterprise Server (console)](connections-create-gheserver-console.md)
+ [Création d'une connexion à GitHub Enterprise Server (CLI)](connections-create-gheserver-cli.md)
# Création d'une connexion à GitHub Enterprise Server (console)
Pour créer une connexion GitHub Enterprise Server, vous devez fournir des informations sur l'emplacement d'installation de votre GitHub Enterprise Server et autoriser la création de la connexion à l'aide de vos informations d'identification GitHub Enterprise.
**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.
**Topics**
+ [Créez votre connexion au serveur GitHub d'entreprise (console)](#connections-create-gheserver-connection)
## Créez votre connexion au serveur GitHub d'entreprise (console)
Pour créer une connexion à GitHub Enterprise Server, munissez-vous de l'URL de votre serveur et de vos informations d'identification GitHub Enterprise.
**Pour créer un hôte**
1. Connectez-vous à la AWS Management Console console AWS Developer Tools et ouvrez-la à l'adresse[https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections).
1. Sur l'ongle **Hosts (Hôtes)**, choisissez **Create host (Créer un hôte)**.
1. Dans **Host name (Nom d'hôte)**, saisissez le nom que vous souhaitez utiliser pour votre hôte.
1. Dans **Sélectionner un fournisseur**, choisissez l’une des options suivantes :
+ **GitHub Serveur d'entreprise**
+ **GitLab autogéré**
1. Dans **URL**, saisissez le point de terminaison de l'infrastructure sur laquelle votre fournisseur est installé.
1. Si votre serveur est configuré dans un VPC Amazon et que vous souhaitez vous connecter à votre VPC, choisissez **Use a VPC (Utiliser un VPC)**. Sinon, choisissez **No VPC**.
1. Si vous avez lancé votre instance dans un VPC Amazon et que vous souhaitez vous connecter à votre VPC, choisissez **Use a VPC (Utiliser un VPC)** et complétez ce qui suit.
1. Dans **ID du VPC**, choisissez votre ID de VPC. Veillez à choisir le VPC de l’infrastructure sur laquelle votre instance est installée ou un VPC qui a accès à votre instance via VPN ou Direct Connect.
1. Si vous avez configuré un VPC privé et que vous avez configuré votre instance pour effectuer la validation TLS à l’aide d’une autorité de certification non publique, dans **Certificat TLS**, saisissez votre ID de certificat. La valeur du certificat TLS est la clé publique du certificat.
1. Choisissez **Create host (Créer un hôte)**.
1. Une fois la page des détails de l'hôte affichée, l'état de l'hôte change au fur et à mesure que l'hôte est créé.
**Note**
Si la configuration de votre hôte inclut une configuration VPC, prévoyez plusieurs minutes pour l'approvisionnement des composants du réseau hôte.
Attendez que votre hôte atteigne l'état **En attente**, puis terminez la configuration. Pour de plus amples informations, veuillez consulter [Configurer un hôte en attente](connections-host-setup.md).
![\[Capture d'écran de la console montrant les détails de l'hôte avec l'hôte En attente.\]](http://docs.aws.amazon.com/fr_fr/dtconsole/latest/userguide/images/connections-create-host-pending.png)
**Étape 2 : créer votre connexion à GitHub Enterprise Server (console)**
1. Connectez-vous à la console Developer Tools AWS Management Console 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 Enterprise Server installé, choisissez **GitHub Enterprise Server**.
**Se connecter au serveur GitHub d'entreprise**
1. Dans **Connection name (Nom de la connexion)**, saisissez le nom de votre connexion.
![\[Capture d'écran de la console montrant la page des paramètres Créer un hôte sans VPC.\]](http://docs.aws.amazon.com/fr_fr/dtconsole/latest/userguide/images/connections-create-ghes-screen.png)
1. Dans **URL**, saisissez le point de terminaison de votre serveur.
**Note**
Si l'URL fournie a déjà été utilisée pour configurer un serveur d' GitHubentreprise pour une connexion, vous serez invité à choisir l'ARN de la ressource hôte créé précédemment pour ce point de terminaison.
1. (Facultatif) Si vous avez lancé votre serveur dans un VPC Amazon et que vous souhaitez vous connecter avec votre VPC, choisissez **Utiliser un VPC** et procédez comme suit.
**Note**
Pour les organisations GitHub utilisant Enterprise Server ou GitLab autogérées, vous ne transmettez aucun hôte disponible. Vous créez un nouvel hôte pour chaque connexion de votre organisation, et vous devez vous assurer de saisir les mêmes informations dans les champs réseau (ID VPC, sous-réseau IDs et groupe de sécurité IDs) pour l'hôte. Pour de plus amples informations, veuillez consulter [Configuration de la connexion et de l'hôte pour les fournisseurs installés qui soutiennent les organisations](troubleshooting-connections.md#troubleshooting-organization-host).
1. Dans **ID du VPC**, choisissez votre ID de VPC. Assurez-vous de choisir le VPC pour l'infrastructure sur laquelle votre instance de serveur GitHub d'entreprise est installée ou un VPC avec accès à votre instance de serveur GitHub d'entreprise via VPN ou Direct Connect.
1. Sous **Subnet ID (ID de sous-réseau)**, choisissez **Add (Ajouter)**. Dans le champ, choisissez l'ID de sous-réseau que vous souhaitez utiliser pour votre hôte. Vous pouvez choisir jusqu'à 10 sous-réseaux.
Assurez-vous de choisir le sous-réseau pour l'infrastructure dans laquelle votre instance de serveur GitHub d'entreprise est installée ou un sous-réseau avec accès à votre instance de serveur GitHub d'entreprise installée via VPN ou Direct Connect.
1. Sous **Groupe de sécurité IDs**, choisissez **Ajouter**. Dans le champ, choisissez le groupe de sécurité que vous souhaitez utiliser pour votre hôte. Vous pouvez choisir jusqu'à 10 groupes de sécurité.
Assurez-vous de choisir le groupe de sécurité pour l'infrastructure sur laquelle votre instance de serveur GitHub d'entreprise est installée ou un groupe de sécurité ayant accès à votre instance de serveur GitHub d'entreprise installée via VPN ou Direct Connect.
1. Si vous avez configuré un VPC privé et que vous avez configuré votre instance de serveur GitHub d'entreprise pour effectuer une validation TLS à l'aide d'une autorité de certification non publique, dans Certificat **TLS, entrez votre ID de certificat**. La valeur du certificat TLS doit être la clé publique du certificat.
![\[Capture d'écran de la console montrant la page de création GitHub d'une connexion au serveur d'entreprise pour les options VPC.\]](http://docs.aws.amazon.com/fr_fr/dtconsole/latest/userguide/images/connections-create-ghes-screen-vpc.png)
1. Choisissez **Connect to GitHub Enterprise Server**. La connexion créée s'affiche avec le statut **En attente**. Une ressource hôte est créée pour la connexion avec les informations de serveur que vous avez fournies. Pour le nom d'hôte, l'URL est utilisée.
1. Choisissez **Update pending connection (Mettre à jour la connexion en attente).**
![\[Capture d'écran de la console montrant la page de connexion GitHub Enterprise Server en attente.\]](http://docs.aws.amazon.com/fr_fr/dtconsole/latest/userguide/images/connections-create-ghes-pending.png)
1. Si vous y êtes invité, sur la page de connexion GitHub Enterprise, connectez-vous à l'aide de vos informations GitHub d'identification Enterprise.
1. Sur la page **Créer une GitHub application**, choisissez un nom pour votre application.
![\[Capture d'écran de la console montrant la page de création d'application\]](http://docs.aws.amazon.com/fr_fr/dtconsole/latest/userguide/images/connections-create-ghes-app-name.png)
1. Sur la page GitHub d'autorisation, choisissez **Autoriser**.
![\[Capture d'écran de la console montrant une page d'autorisation d'application\]](http://docs.aws.amazon.com/fr_fr/dtconsole/latest/userguide/images/connections-create-ghes-app-authorize.png)
1. Sur la page d'installation de l'application, un message indique que l'application Connector est prête à être installée. Si vous avez plusieurs organisations, vous pouvez être invité à choisir l'organisation dans laquelle vous souhaitez installer l'application.
Choisissez les paramètres du référentiel dans lesquels vous souhaitez installer l'application. Choisissez **Installer**.
![\[Capture d'écran de la console montrant une page d'autorisation d'application\]](http://docs.aws.amazon.com/fr_fr/dtconsole/latest/userguide/images/connections-create-ghes-app-install.png)
1. La page de connexion affiche la connexion créée avec un statut **Disponible**.
# Création d'une connexion à GitHub Enterprise Server (CLI)
Vous pouvez utiliser le AWS Command Line Interface (AWS CLI) pour créer une connexion.
Pour ce faire, utilisez les commandes **create-host** et **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`.
**Étape 1 : Pour créer un hôte pour GitHub Enterprise Server (CLI)**
1. Ouvrez une invite de terminal (Linux, macOS ou Unix) ou de commande (Windows). Utilisez le AWS CLI pour exécuter la **create-host** commande, en spécifiant le `--name``--provider-type`, et `--provider-endpoint` pour votre connexion. Dans cet exemple, le nom du fournisseur tiers est `GitHubEnterpriseServer` et le point de terminaison est `my-instance.dev`.
```
aws codeconnections create-host --name MyHost --provider-type GitHubEnterpriseServer --provider-endpoint "https://my-instance.dev"
```
En cas de succès, cette commande renvoie les informations Amazon Resource Name (ARN) hôte semblables à ce qui suit.
```
{
"HostArn": "arn:aws:codeconnections:us-west-2:account_id:host/My-Host-28aef605"
}
```
Après cette étape, l'hôte présente l'état `PENDING`.
1. Utilisez la console pour terminer la configuration de l'hôte et passer l'hôte vers l'état `Available`. Pour de plus amples informations, veuillez consulter [Configurer un hôte en attente](connections-host-setup.md).
**Étape 2 : Configurer un hôte en attente dans la console**
1. Connectez-vous à la console Developer Tools AWS Management Console et ouvrez-la à l'adresse[https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections).
1. Utilisez la console pour terminer la configuration de l'hôte et passer l'hôte vers l'état `Available`. Consultez [Configurer un hôte en attente](connections-host-setup.md).
**Étape 3 : Pour créer une connexion pour GitHub Enterprise Server (CLI)**
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 `--host-arn` et `--connection-name` pour votre connexion.
```
aws codeconnections create-connection --host-arn arn:aws:codeconnections:us-west-2:account_id:host/MyHost-234EXAMPLE --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"
}
```
1. Utilisez la console pour configurer la connexion en attente. Pour de plus amples informations, veuillez consulter [Mettre à jour une connexion en attente](connections-update.md).
**Étape 4 : Pour établir une connexion pour GitHub Enterprise Server dans la console**
1. Connectez-vous à la console Developer Tools AWS Management Console et ouvrez-la à l'adresse[https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections).
1. Utilisez la console pour configurer la connexion en attente et la faire passer à l’état `Available`. Pour de plus amples informations, veuillez consulter [Mettre à jour une connexion en attente](connections-update.md).