GitLabconnexions .com - AWS CodePipeline
Création d'une connexion à GitLab .com (console)Création d'une connexion à GitLab .com (CLI)

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.

GitLabconnexions .com

Les connexions vous permettent d'autoriser et d'établir des configurations qui associent votre fournisseur tiers à vos AWS ressources. Pour associer votre référentiel tiers en tant que source de votre pipeline, vous devez utiliser une connexion.

Note

Cette fonctionnalité n'est pas disponible dans les régions Asie-Pacifique (Hong Kong), Asie-Pacifique (Hyderabad), Asie-Pacifique (Jakarta), Asie-Pacifique (Melbourne), Asie-Pacifique (Osaka), Afrique (Le Cap), Moyen-Orient (Bahreïn), Moyen-Orient (Émirats arabes unis), Europe (Espagne), Europe (Zurich), Israël (Tel Aviv) ou AWS GovCloud (USA Ouest). Pour faire référence aux autres actions disponibles, voirIntégrations de produits et de services avec CodePipeline. Pour les considérations relatives à cette action dans la région Europe (Milan), voir la note dansCodeStarSourceConnection pour Bitbucket Cloud GitHub, GitHub Enterprise Server, GitLab .com et les actions GitLab autogérées.

Pour ajouter une action source GitLab .com dans CodePipeline, vous pouvez choisir de :

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 sur GitLab .com, 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 sur GitLab .com.

    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 CodePipeline. 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 pipeline, vous devez déjà avoir créé un dépôt sur gitlab.com.

Création d'une connexion à GitLab .com (console)

Suivez ces étapes pour utiliser la CodePipeline console afin d'ajouter une action de connexion pour votre projet (référentiel) dans GitLab.

Pour créer ou modifier votre pipeline

  1. Connectez-vous à la CodePipeline console.

  2. Choisissez l'une des options suivantes.

    • Choisissez de créer un pipeline. Suivez les étapes décrites dans Créer un pipeline pour terminer le premier écran et choisissez Next. Sur la page Source, sous Source Provider, sélectionnez GitLab.

    • Choisissez de modifier un pipeline existant. Choisissez Modifier, puis sélectionnez Modifier l'étape. Choisissez d'ajouter ou de modifier votre action source. Sur la page Modifier l'action, sous Nom de l'action, entrez le nom de votre action. Dans Action provider, sélectionnez GitLab.

  3. Effectuez l’une des actions suivantes :

    • Sous Connexion, si vous n'avez pas encore créé de connexion avec votre fournisseur, choisissez Se connecter à GitLab. Passez à l'étape 4 pour créer la connexion.

    • Sous Connexion, si vous avez déjà créé une connexion avec votre fournisseur, choisissez-la. Passez à l'étape 9.

    Note

    Si vous fermez la fenêtre contextuelle avant de créer une connexion GitLab .com, vous devez actualiser la page.

  4. Pour créer une connexion à un référentiel GitLab .com, 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 GitLab.

    Capture d'écran de la console montrant l'option de connexion sélectionnée pour GitLab.

  5. Lorsque la page de connexion de GitLab .com s'affiche, connectez-vous à l'aide de vos informations d'identification, puis choisissez Se connecter.

  6. 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 compte GitLab .com.

    Choisissez Authorize (Autoriser).

    Capture d'écran montrant le message d'autorisation de connexion pour votre compte GitLab .com.

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

  8. Choisissez Connect to GitLab.

    Vous serez renvoyé à la CodePipeline console.

    Note

    Une fois la connexion GitLab .com créée avec succès, une bannière de réussite s'affiche dans la fenêtre principale.

    Si vous ne vous êtes pas déjà connecté GitLab à l'ordinateur actuel, vous devez fermer manuellement la fenêtre contextuelle.

  9. Dans Nom du référentiel, 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.

  10. Sous Déclencheurs du pipeline, vous pouvez ajouter des déclencheurs si votre action est une CodeConnections action. Pour configurer la configuration des déclencheurs du pipeline et pour éventuellement filtrer à l'aide de déclencheurs, reportez-vous à la sectionFiltrer les déclencheurs sur les requêtes push ou pull de code.

  11. Dans Nom de branche, choisissez la branche où vous souhaitez que votre pipeline détecte les modifications de source.

    Note

    Si le nom de la branche n'est pas renseigné automatiquement, cela signifie que vous n'avez pas accès au référentiel en tant que propriétaire. Soit le nom du projet n'est pas valide, soit la connexion utilisée n'a pas accès au projet/au référentiel.

  12. Dans Output artifact format (Format d'artefact de sortie), vous devez choisir le format de vos artefacts.

    • Pour stocker les artefacts de sortie de l'action GitLab .com à l'aide de la méthode par défaut, choisissez CodePipeline default. L'action accède aux fichiers depuis le référentiel GitLab .com et stocke les artefacts dans un fichier ZIP dans le magasin d'artefacts du pipeline.

    • Pour stocker un fichier JSON contenant une référence d'URL au référentiel afin que les actions en aval puissent exécuter directement les commandes Git, choisissez Full clone (Clone complet). Cette option ne peut être utilisée que par des actions CodeBuild en aval.

      Si vous choisissez cette option, vous devrez mettre à jour les autorisations associées à votre rôle de service de CodeBuild projet, comme indiqué dansAjoutez CodeBuild GitClone des autorisations pour les connexions à Bitbucket GitHub, GitHub Enterprise Server ou .com GitLab. Pour consulter un didacticiel expliquant comment utiliser l'option de clonage complet, voirTutoriel : Utiliser un clone complet avec une source de GitHub pipeline.

  13. Choisissez d'enregistrer l'action source et de continuer.

Création d'une connexion à GitLab .com (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 avec la CLI AWS CloudFormation, utilisez la console pour modifier la connexion afin de définir son étatAVAILABLE.

Pour créer une connexion

  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 --provider-type et --connection-name pour votre connexion. Dans cet exemple, le nom du fournisseur tiers est GitLab et le nom de connexion spécifié est MyConnection.

    aws codestar-connections create-connection --provider-type GitLab --connection-name MyConnection

    En cas de succès, cette commande renvoie les informations ARN de connexion semblables à ce qui suit.

    {
    "ConnectionArn": "arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f"
}

  2. Utilisez la console pour terminer la connexion. Pour plus d'informations, voir Mettre à jour une connexion en attente.

  3. Le pipeline détecte par défaut les modifications lors de l'envoi du code vers le référentiel des sources de connexion. Pour configurer la configuration du déclencheur du pipeline pour le lancement manuel ou pour les balises Git, effectuez l'une des opérations suivantes :

    • Pour configurer la configuration du déclencheur du pipeline de manière à ce qu'elle commence par un déverrouillage manuel uniquement, ajoutez la ligne suivante à la configuration : 

      "DetectChanges": "false",

    • Pour configurer la configuration des déclencheurs du pipeline afin de filtrer avec des déclencheurs, voir plus de détails dansFiltrer les déclencheurs sur les requêtes push ou pull de code. Par exemple, ce qui suit ajoute au niveau du pipeline de la définition JSON du pipeline. Dans cet exemple, release-v0 et release-v1 sont les balises Git à inclure et release-v2 les balises Git à exclure.

      "triggers": [
            {
                "providerType": "CodeStarSourceConnection",
                "gitConfiguration": {
                    "sourceActionName": "Source",
                    "push": [
                        {
                            "tags": {
                                "includes": [
                                    "release-v0", "release-v1"
                                ],
                                "excludes": [
                                    "release-v2"
                                ]
                            }
                        }
                    ]
                }
            }
        ]