View a markdown version of this page

GitLab accès dans CodeBuild - AWS CodeBuild

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ès dans CodeBuild

Pour GitLab, vous utilisez une GitLab connexion pour accéder au fournisseur source.

Connectez-vous 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 build, vous utilisez une connexion.

Pour ajouter un fournisseur source GitLab ou un fournisseur GitLab autogéré CodeBuild, vous pouvez choisir de :

  • Utilisez l'assistant de création de projet de création de la CodeBuild console ou la page Modifier la source pour choisir l'option GitLab ou fournisseur GitLab autogéré. Voir Créer une connexion à GitLab (console) pour ajouter le fournisseur source. La console vous aide à créer une ressource de connexions.

  • Utilisez la CLI pour créer vos ressources de connexions, voir Créer 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 dans 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 Connectez-vous CodeBuild à 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 Propriétaire GitLab, puis la connexion peut être utilisée avec le référentiel contenant 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éer une connexion à GitLab (console)

Procédez comme suit 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, consultez la section Partager des connexions avec AWS des comptes.

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 Fournisseur source, choisissez GitLab.

    • Choisissez de modifier un projet de construction existant. Choisissez Modifier, puis choisissez Source. Sur la page Modifier la source, sous Fournisseur de source, choisissez 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, choisissez 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.
  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 à la connexion d'accéder à votre GitLab compte.

    Choisissez Authorize (Autoriser).

    Capture d'écran montrant le message pour autoriser la connexion à votre GitLab compte.
  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.

  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 votre ARN de 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 en 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 ID de demande d'extraction, une branche, un ID de validation, une balise ou une référence et un ID de validation. Pour de plus amples informations, veuillez consulter Exemple de version source avec AWS CodeBuild.

    Note

    Nous vous recommandons de choisir des noms de branches 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 avec un historique tronqué au nombre de commits spécifié. Si vous souhaitez un clone complet, choisissez Full.

  14. Dans État de construction - facultatif, sélectionnez Signaler les états 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 source, l'utilisateur associé au fournisseur source doit disposer d'un accès en écriture au dépôt. Si l'utilisateur n'a pas accès en écriture, l'état de compilation ne peut pas être mis à jour. Pour de plus amples informations, veuillez consulter Accès au fournisseur source.

Créer 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 statut par défaut. Après avoir créé une connexion à l'aide de l'interface de ligne de commande CloudFormation, utilisez la console pour modifier la connexion afin de définir son étatAVAILABLE.

Pour créer une connexion