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.
# GitLab accéder à CodeBuild
En GitLab effet, vous utilisez une GitLab connexion pour accéder au fournisseur source.
**Topics**
+ [Connect CodeBuild à GitLab](#connections-gitlab)
## Connect CodeBuild à GitLab
Les connexions vous permettent d'autoriser et d'établir des configurations qui associent votre fournisseur tiers aux AWS ressources que vous utilisez AWS CodeConnections. Pour associer votre référentiel tiers en tant que source pour votre projet de construction, vous utilisez une connexion.
Pour ajouter un fournisseur de source GitLab ou un fournisseur de source GitLab autogéré CodeBuild, vous pouvez choisir de :
+ Utilisez l'assistant de **création de projet** ou la page **Modifier la source** de la CodeBuild console pour choisir l'option **GitLab**ou le fournisseur **GitLab autogéré**. Consultez [Création d'une connexion à GitLab (console)](#connections-gitlab-console) la section pour ajouter le fournisseur source. La console vous permet de créer une ressource de connexions.
+ Utilisez la CLI pour créer vos ressources de connexions, voir [Création d'une connexion à GitLab (CLI)](#connections-gitlab-cli) pour créer une ressource de connexions avec la CLI.
**Note**
Vous pouvez également créer une connexion à l'aide de la console Developer Tools sous **Paramètres**. Voir [Créer une connexion](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-create.html).
**Note**
En autorisant l'installation de cette connexion GitLab, vous autorisez notre service à traiter vos données en accédant à votre compte, et vous pouvez révoquer ces autorisations à tout moment en désinstallant l'application.
### Créez une connexion avec GitLab
Cette section décrit comment se connecter GitLab à CodeBuild. Pour plus d’informations sur les connexions GitLab , consultez [Connect CodeBuild à GitLab](#connections-gitlab).
Avant de commencer :
+ Vous devez déjà avoir créé un compte auprès de GitLab.
**Note**
Les connexions fournissent uniquement l'accès aux référentiels appartenant 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 le référentiel avec des ressources telles que CodeBuild. Pour les référentiels dans des groupes, il n'est pas nécessaire d'être le propriétaire du groupe.
+ Pour spécifier une source pour votre projet de build, vous devez déjà avoir créé un référentiel sur GitLab.
**Topics**
+ [Création d'une connexion à GitLab (console)](#connections-gitlab-console)
+ [Création d'une connexion à GitLab (CLI)](#connections-gitlab-cli)
#### Création d'une connexion à GitLab (console)
Suivez ces étapes pour utiliser la CodeBuild console afin d'ajouter une connexion pour votre projet (référentiel) dans GitLab.
**Note**
Au lieu de créer ou d'utiliser une connexion existante dans votre compte, vous pouvez utiliser une connexion partagée depuis un autre AWS compte. Pour plus d'informations, voir [Partager des connexions avec AWS des comptes](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-share.html).
**Pour créer ou modifier votre projet de construction**
1. Connectez-vous à la CodeBuild console.
1. Choisissez l’une des options suivantes.
+ Choisissez de créer un projet de construction. Suivez les étapes décrites [Création d'un projet de génération (console)](create-project.md#create-project-console) pour terminer le premier écran et dans la section **Source**, sous **Source Provider**, sélectionnez **GitLab**.
+ Choisissez de modifier un projet de construction existant. Choisissez **Modifier**, puis **Source**. Sur la page **Modifier la source**, sous **Fournisseur de source**, sélectionnez **GitLab**.
1. Sélectionnez l’une des méthodes suivantes :
+ Sous **Connexion**, choisissez **Connexion par défaut**. La connexion par défaut applique une GitLab connexion par défaut à tous les projets.
+ Sous **Connexion**, choisissez **Connexion personnalisée**. Connexion personnalisée applique une GitLab connexion personnalisée qui remplace les paramètres par défaut de votre compte.
1. Effectuez l’une des actions suivantes :
+ Sous **Connexion par défaut** ou **Connexion personnalisée**, si vous n'avez pas encore créé de connexion avec votre fournisseur, choisissez **Créer une nouvelle GitLab connexion**. Passez à l'étape 5 pour créer la connexion.
+ Sous **Connexion**, si vous avez déjà créé une connexion avec votre fournisseur, choisissez-la. Passez à l'étape 10.
**Note**
Si vous fermez la fenêtre contextuelle avant de créer une GitLab connexion, vous devez actualiser la page.
1. Pour créer une connexion à un GitLab référentiel, sous **Sélectionnez un fournisseur**, sélectionnez **GitLab**. Dans **Connection name (Nom de la connexion)**, saisissez le nom de la connexion que vous souhaitez créer. Choisissez **Connect to (Se connecter à) GitLab**.
![\[Capture d'écran de la console montrant l'option de connexion sélectionnée pour GitLab.\]](http://docs.aws.amazon.com/fr_fr/codebuild/latest/userguide/images/connections-create-gitlab.png)
1. Lorsque la page de connexion GitLab s'affiche, connectez-vous avec vos informations d'identification, puis choisissez **Se connecter**.
1. Si c'est la première fois que vous autorisez la connexion, une page d'autorisation s'affiche avec un message demandant l'autorisation de connexion pour accéder à votre GitLab compte.
Choisissez **Authorize** (Autoriser).
![\[Capture d'écran montrant le message d'autorisation de connexion à votre GitLab compte.\]](http://docs.aws.amazon.com/fr_fr/codebuild/latest/userguide/images/gitlab-authorization.png)
1. Le navigateur revient à la page de la console des connexions. Dans **les paramètres de GitLab connexion**, la nouvelle connexion est affichée dans **Nom de la connexion**.
1. Choisissez **Se connecter**.
Une fois la GitLab connexion créée avec succès, une bannière de réussite s'affiche en haut de la page.
1. Sur la page **Créer un projet de construction**, dans la liste déroulante **Connexion par défaut** ou **Connexion personnalisée**, assurez-vous que l'ARN de votre connexion est répertorié. Sinon, cliquez sur le bouton d'actualisation pour le faire apparaître.
1. Dans **Repository**, choisissez le nom de votre projet en GitLab spécifiant le chemin du projet avec l'espace de noms. Par exemple, pour un référentiel au niveau du groupe, entrez le nom du référentiel au format suivant :. `group-name/repository-name` Pour plus d'informations sur le chemin et l'espace de noms, consultez le `path_with_namespace` champ dans [https://docs.gitlab.com/ee/get-single-projectapi/projects.html\$1](https://docs.gitlab.com/ee/api/projects.html#get-single-project). Pour plus d'informations sur l'espace de noms dans GitLab, consultez [https://docs.gitlab.com/ee/user/namespace/](https://docs.gitlab.com/ee/user/namespace/).
**Note**
Pour les groupes dans GitLab, vous devez spécifier manuellement le chemin du projet avec l'espace de noms. Par exemple, pour un référentiel nommé `myrepo` dans un groupe`mygroup`, entrez ce qui suit :`mygroup/myrepo`. Vous pouvez trouver le chemin du projet avec l'espace de noms dans l'URL dans GitLab.
1. Dans **Version source (facultatif)**, entrez un identifiant de pull request, une branche, un identifiant de validation, une balise ou une référence et un identifiant de validation. Pour de plus amples informations, veuillez consulter [Exemple de version source avec AWS CodeBuild](sample-source-version.md).
**Note**
Nous vous recommandons de choisir des noms de branche Git qui ne ressemblent pas à des validations IDs, tels que `811dd1ba1aba14473856cee38308caed7190c0d` ou`5392f7`. Cela vous permet d'éviter les collisions entre Git Checkout et les validations réelles.
1. Dans **Git clone depth (facultatif)**, vous pouvez créer un clone superficiel dont l'historique est tronqué au nombre de validations spécifié. Si vous souhaitez un clone complet, choisissez **Full**.
1. Dans **État de la construction - facultatif**, sélectionnez **Signaler les statuts de construction au fournisseur source lorsque vos builds commencent et se terminent** si vous souhaitez que l'état du début et de la fin de votre build soit signalé à votre fournisseur source.
Pour pouvoir signaler l'état de construction au fournisseur de source, l'utilisateur associé au fournisseur de source doit avoir un accès en écriture au dépôt. Si l'utilisateur ne dispose pas d'un accès en écriture, l'état de construction ne peut pas être mis à jour. Pour de plus amples informations, veuillez consulter [Accès au fournisseur de source](access-tokens.md).
#### Création d'une connexion à GitLab (CLI)
Vous pouvez utiliser le AWS Command Line Interface (AWS CLI) pour créer une connexion.
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 avec la CLI CloudFormation, utilisez la console pour modifier la connexion afin de définir son état`AVAILABLE`.
**Pour créer une connexion**
+ Suivez les instructions du *guide de l'utilisateur de la console Developer Tools* pour [créer une connexion à GitLab (CLI)](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-create-gitlab.html#connections-create-gitlab-cli).