Connexions Bitbucket Cloud - AWS CodePipeline
Création d'une connexion à Bitbucket Cloud (console)Création d'une connexion à Bitbucket Cloud () 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.

Connexions Bitbucket Cloud

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 (UAE), 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 Bitbucket Cloud 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.

Avant de commencer :

  • Vous devez avoir créé un compte auprès du fournisseur du référentiel tiers, tel que Bitbucket Cloud.

  • Vous devez déjà avoir créé un référentiel de code tiers, tel qu'un référentiel Bitbucket Cloud.

Note

Les connexions Bitbucket Cloud fournissent uniquement l'accès aux référentiels détenus par le compte Bitbucket Cloud qui a été utilisé pour créer la connexion.

Si l'application est installée dans un espace de travail Bitbucket Cloud, vous devez disposer des autorisations d'administration de l'espace de travail. Dans le cas contraire, l'option d'installation de l'application ne s'affichera pas.

Création d'une connexion à Bitbucket Cloud (console)

Suivez ces étapes pour utiliser la CodePipeline console afin d'ajouter une action de connexion à votre référentiel Bitbucket.

Note

Vous pouvez créer des connexions à un référentiel Bitbucket Cloud. Les types de fournisseurs Bitbucket installés, tels que Bitbucket Server, ne sont pas pris en charge.

Étape 1 : créer ou modifier votre pipeline

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

    • 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, choisissez Bitbucket.

  3. Effectuez l’une des actions suivantes :

    • Sous Connexion, si vous n'avez pas encore créé de connexion avec votre fournisseur, choisissez Connect to Bitbucket. Passez à l'étape 2 : créer une connexion à Bitbucket.

    • Sous Connexion, si vous avez déjà créé une connexion avec votre fournisseur, choisissez-la. Passez à l'étape 3 : Enregistrer l'action source pour votre connexion.

Étape 2 : créer une connexion à Bitbucket Cloud

Pour créer une connexion à Bitbucket Cloud

  1. Sur la page des paramètres de Connect to Bitbucket, entrez le nom de votre connexion et choisissez Connect to Bitbucket.

    Capture d'écran de la console montrant le bouton Connect to Bitbucket.

    Le champ des applications Bitbucket apparaît.

  2. Sous Bitbucket apps (Applications Bitbucket), choisissez une installation d'application ou choisissez Install a new app (Installer une nouvelle application) pour en créer une.

    Note

    Vous n'installez l'application qu'une seule fois pour chaque espace de travail ou compte Bitbucket Cloud. Si vous avez déjà installé l'application Bitbucket, choisissez-la et passez à l'étape 4.

    Capture d'écran de la console montrant la boîte de dialogue Se connecter à Bitbucket Cloud, avec le bouton d'installation d'une nouvelle application.

  3. Si la page de connexion de Bitbucket Cloud s'affiche, connectez-vous avec vos informations d'identification, puis choisissez de continuer.

  4. Sur la page d'installation de l'application, un message indique que l' AWS CodeStar application essaie de se connecter à votre compte Bitbucket.

    Si vous utilisez un espace de travail Bitbucket, modifiez l'option Autoriser pour pour l'espace de travail. Seuls les espaces de travail auxquels vous avez accès en tant qu'administrateur s'affichent.

    Choisissez Grant access (Accorder l'accès).

  5. Dans Bitbucket apps (Applications Bitbucket), l'ID de connexion de votre nouvelle installation s'affiche. Choisissez Se connecter. La connexion créée s'affiche dans la liste des connexions.

    Capture d'écran de la console montrant la demande d'accès.

Étape 3 : enregistrer votre action source Bitbucket Cloud

Suivez ces étapes dans l'assistant ou sur la page Modifier l'action pour enregistrer votre action source avec vos informations de connexion.

Pour terminer et enregistrer votre action source avec votre connexion

  1. Dans Nom du référentiel, choisissez le nom de votre référentiel tiers.

  2. 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 sectionAjouter un déclencheur avec des types d'événements de type code push ou pull request.

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

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

    • Pour stocker un JSON fichier contenant une URL référence au référentiel afin que les actions en aval puissent exécuter directement les commandes Git, choisissez Full clone. 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.

  4. Choisissez Suivant dans l'assistant ou Enregistrer sur la page d'action Modifier.

Création d'une connexion à Bitbucket Cloud () CLI

Vous pouvez utiliser le AWS Command Line Interface (AWS CLI) pour créer une connexion.

Note

Vous pouvez créer des connexions à un référentiel Bitbucket Cloud. Les types de fournisseurs Bitbucket installés, tels que Bitbucket Server, ne sont pas pris en charge.

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

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 Bitbucket et le nom de connexion spécifié est MyConnection.

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

    En cas de succès, cette commande renvoie les ARN informations de connexion similaires aux suivantes.

    {
    "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 dansAjouter un déclencheur avec des types d'événements de type code push ou pull request. Par exemple, ce qui suit ajoute des balises Git au niveau du pipeline de la JSON définition 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"
                                ]
                            }
                        }
                    ]
                }
            }
        ]