GitLab connexions

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 devez utiliser 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 GitLabou le fournisseur GitLab autogéré. Consultez Création d'une connexion à 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) 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.

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.

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.

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.

Pour créer ou modifier votre projet de construction

1. Connectez-vous à la CodeBuild console.

2. 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) 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.

3. 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. La connexion personnalisée applique une GitLab connexion personnalisée qui remplace les paramètres par défaut de votre compte.

4. 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.

5. 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 GitLab.

   

6. Lorsque la page de connexion GitLab s'affiche, connectez-vous avec vos informations d'identification, puis choisissez Se connecter.

7. 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).

   

8. 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.

9. 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.

10. 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é. Si ce n'est pas le cas, cliquez sur le bouton d'actualisation pour le faire apparaître.

11. 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/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/.

    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 groupemygroup, entrez ce qui suit : mygroup/myrepo Vous pouvez trouver le chemin du projet avec l'espace de noms dans l'URL dans GitLab.

12. 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 plus d’informations, consultez Exemple de version source avec AWS CodeBuild.

    Note

    Nous vous recommandons de choisir des noms de branche Git qui ne ressemblent pas à des identifiants de validation, tels que 811dd1ba1aba14473856cee38308caed7190c0d ou5392f7. Cela vous permet d'éviter les collisions entre Git Checkout et les validations réelles.

13. 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.

14. 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 plus d’informations, consultez Accès au fournisseur de source.

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 AWS CloudFormation, utilisez la console pour modifier la connexion afin de définir son étatAVAILABLE.

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).