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 à l' GitLab autogestion
Vous pouvez créer des connexions pour GitLab Enterprise Edition ou GitLab Community Edition avec une installation autogérée.
Vous pouvez utiliser le AWS Management Console ou le AWS Command Line Interface (AWS CLI) pour créer une connexion et un hôte à des fins d' GitLab autogestion.
**Note**
En autorisant cette application de connexion en mode GitLab autogérée, vous autorisez notre service à traiter vos données, et vous pouvez révoquer ces autorisations à tout moment en désinstallant l'application.
Avant de créer une connexion à GitLab Automanaged, vous devez créer un hôte à utiliser pour la connexion, comme indiqué dans ces étapes. Pour voir une présentation du flux de travail de création d’hôte pour les fournisseurs installés, consultez [Flux de travail de création ou de mise à jour d’un hôte](welcome-hosts-workflow.md).
Vous pouvez éventuellement configurer votre hôte avec un VPC. Pour plus d’informations sur la configuration réseau et de VPC pour votre ressource hôte, consultez les prérequis pour les VPC dans [(Facultatif) Prérequis : configuration réseau ou d’Amazon VPC pour votre connexion](connections-host-create.md#connections-create-host-prereq) et [Résolution des problèmes liés à la configuration d'un VPC pour votre hôte](troubleshooting-connections.md#troubleshooting-connections-host-vpc).
Avant de commencer :
+ Vous devez déjà avoir créé un compte GitLab et disposer de l'édition GitLab Enterprise ou de l'édition GitLab Community avec une installation autogérée. Pour plus d'informations, consultez [https://docs.gitlab.com/ee/subscriptions/self\$1managed/](https://docs.gitlab.com/ee/subscriptions/self_managed/).
**Note**
Les connexions fournissent uniquement l’accès au compte qui a été utilisé pour créer et autoriser la connexion.
**Note**
Vous pouvez créer des connexions à un référentiel dans lequel vous avez le rôle de **propriétaire** GitLab, puis la connexion peut être utilisée avec des ressources telles que CodePipeline. Pour les référentiels dans des groupes, il n'est pas nécessaire d'être le propriétaire du groupe.
+ Vous devez déjà avoir créé un jeton d'accès GitLab personnel (PAT) avec l'autorisation limitée suivante uniquement :`api`,. `admin_mode` Pour plus d'informations, consultez le [https://docs.gitlab.com/ee/user/profile/personalfichier \$1access\$1tokens.html](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html). Vous devez être administrateur pour créer et utiliser le PAT.
**Note**
Votre PAT est utilisé pour autoriser l’hôte et n’est pas stocké ni utilisé par les connexions à d’autres fins. Pour configurer un hôte, vous pouvez créer un PAT temporaire, puis, une fois l’hôte configuré, vous pouvez le supprimer.
**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 à l' GitLab autogestion (console)](#connections-create-gitlab-managed-console)
+ [Création d'une connexion à une interface GitLab autogérée (CLI)](#connections-create-gitlab-managed-cli)
## Création d'une connexion à l' GitLab autogestion (console)
Suivez ces étapes pour créer un hôte et une connexion GitLab autogérés dans la console. Pour voir les considérations relatives à la configuration d’un hôte dans un VPC, consultez [(Facultatif) Prérequis : configuration réseau ou d’Amazon VPC pour votre connexion](connections-host-create.md#connections-create-host-prereq).
**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.
**Note**
Vous créez un hôte pour une seule installation GitLab autogérée, puis vous pouvez gérer une ou plusieurs connexions GitLab autogérées avec cet hôte.
**Étape 1 : Créer votre hôte**
1. Connectez-vous à AWS Management Console, puis ouvrez la console AWS Developer Tools à 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électionnez un fournisseur**, sélectionnez **GitLabAutogé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. (Facultatif) Si vous avez lancé votre hôte 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. Veillez à choisir le VPC de l’infrastructure sur laquelle votre hôte est installé 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 hôte 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 GitLab autogéré dont le statut est En attente.\]](http://docs.aws.amazon.com/fr_fr/dtconsole/latest/userguide/images/connections-create-glsm-host.png)
**Étape 2 : Configurer votre hôte en attente**
1. Choisissez **Configurer l’hôte**.
1. Une *host\$1name* page **de configuration** s'affiche. Dans **Fournir un jeton d'accès personnel**, accordez à votre GitLab PAT uniquement les autorisations délimitées suivantes : `api` et. `admin_mode`
**Note**
Seul un administrateur peut créer et utiliser le PAT.
![\[Capture d'écran de la console montrant la saisie du jeton d'accès GitLab personnel pour le nouvel hôte\]](http://docs.aws.amazon.com/fr_fr/dtconsole/latest/userguide/images/connections-create-glsm-pat.png)
1. Une fois votre hôte enregistré avec succès, la page des détails de l'hôte s'affiche et indique que l'état de l'hôte est **Disponible**.
![\[Capture d’écran de la console montrant l’état disponible du nouvel hôte\]](http://docs.aws.amazon.com/fr_fr/dtconsole/latest/userguide/images/connections-create-glsm-host-available.png)
**Étape 3 : Créer votre connexion**
1. Connectez-vous à AWS Management Console, puis ouvrez la console AWS Developer Tools à l'adresse[https://console.aws.amazon.com/codesuite/settings/connections](https://console.aws.amazon.com/codesuite/settings/connections).
1. Choisissez **Paramètres**, puis choisissez **Connexions**. Choisissez **Créer une connexion**.
1. Pour créer une connexion à un GitLab référentiel, sous **Sélectionnez un fournisseur**, choisissez **GitLab Autogéré**. Dans **Connection name (Nom de la connexion)**, saisissez le nom de la connexion que vous souhaitez créer.
![\[Capture d'écran de la console montrant l'option de connexion sélectionnée pour GitLab l'autogestion.\]](http://docs.aws.amazon.com/fr_fr/dtconsole/latest/userguide/images/connections-create-glsm.png)
1. Dans **URL**, saisissez le point de terminaison de votre serveur.
1. Si vous avez lancé votre serveur dans un VPC Amazon et que vous souhaitez vous connecter à votre VPC, choisissez **Use a VPC (Utilisation d'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 hôte est installé ou un VPC qui a accès à votre hôte 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.
Veillez à choisir le sous-réseau de l’infrastructure sur laquelle votre hôte est installé ou un sous-réseau qui a accès à votre hôte installé 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é.
Veillez à choisir le groupe de sécurité de l’infrastructure sur laquelle votre hôte est installé ou un groupe de sécurité qui a accès à votre hôte installé via VPN ou Direct Connect.
1. Si vous avez configuré un VPC privé et que vous avez configuré votre hôte 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 doit être la clé publique du certificat.
1. Choisissez **Connect to GitLab self-managed**. 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).**
1. Lorsque la page de connexion GitLab s'affiche, connectez-vous avec vos informations d'identification, puis choisissez **Se connecter**.
1. Une page d'autorisation s'affiche avec un message demandant l'autorisation de connexion pour accéder à votre GitLab compte.
Choisissez **Authorize** (Autoriser).
1. Le navigateur revient à la page de la console des connexions. Sous **Créer une GitLab connexion**, la nouvelle connexion est affichée dans **Nom de la connexion**.
1. Choisissez **Connect to GitLab self-managed**.
Une fois la connexion créée avec succès, une bannière de réussite s'affiche. Les détails de la connexion sont affichés sur la page **Paramètres de connexion**.
## Création d'une connexion à une interface GitLab autogérée (CLI)
Vous pouvez utiliser le AWS Command Line Interface (AWS CLI) pour créer un hôte et une connexion à des fins GitLab d'autogestion.
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 GitLab autogéré (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 `GitLabSelfManaged` et le point de terminaison est `my-instance.dev`.
```
aws codeconnections create-host --name MyHost --provider-type GitLabSelfManaged --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 le faire passer à l’état `Available`.
**É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 l' GitLab autogestion (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 à l’étape suivante.
**Étape 4 : Pour terminer une connexion pour l' GitLab autogestion 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).