Cette page explique comment activer la fonctionnalité de déclenchement sur un Instance Bitbucket Cloud. En savoir plus sur Déclencheurs Cloud Build et Dépôts Cloud Build.
Avant de commencer
-
Enable the Cloud Build and Secret Manager APIs.
- Suivez les instructions pour connecter un hôte Bitbucket Cloud.
- Suivez les instructions de la section Se connecter à un dépôt Bitbucket Cloud.
Créer un déclencheur Bitbucket Cloud
Pour créer un déclencheur Bitbucket Cloud, procédez comme suit:
Console
Ouvrez la page Déclencheurs :
Sélectionnez votre projet Google Cloud, puis cliquez sur Ouvrir.
Cliquez sur Créer un déclencheur.
Entrez les paramètres de déclencheur suivants :
Nom : nom de votre déclencheur.
Région : sélectionnez la région de votre déclencheur.
- Si le fichier de configuration de compilation associé au déclencheur spécifie un pool privé, Cloud Build utilise le pool privé pour exécuter votre compilation. Dans ce cas, la région que vous spécifiez dans votre déclencheur doit correspondre à celle dans laquelle vous avez créé votre pool privé.
- Si le fichier de configuration de compilation associé au déclencheur ne spécifie pas de pool privé, Cloud Build utilise la version par défaut pour exécuter votre build dans la même région comme déclencheur.
Description (facultatif) : description de votre déclencheur.
Événement : sélectionnez l'événement lié au dépôt qui appelle votre déclencheur.
Déployer sur une branche : configurez votre déclencheur pour lancer une compilation sur les commits réalisés dans une branche spécifique.
Transférer le nouveau tag : configurez votre déclencheur pour lancer une compilation sur des commits contenant un tag particulier.
Demande d'extraction : configurez votre déclencheur pour lancer une compilation sur les commits d'une demande d'extraction.
Source: sélectionnez 2nd gen comme source.
Dépôt : sélectionnez le dépôt dans la liste des dépôts disponibles. Pour connecter un nouveau dépôt, consultez la section Se connecter à un Bitbucket Cloud Repository.
Branche ou tag : spécifiez une expression régulière à laquelle faire correspondre la valeur de la branche ou du tag. Pour en savoir plus sur la syntaxe des expressions régulières acceptables, consultez la page Syntaxe RE2.
Contrôle des commentaires : si vous avez sélectionné Demande d'extraction comme événement, choisissez l'une des options suivantes pour contrôler si une compilation doit être exécutée automatiquement par le déclencheur :
Obligatoire, sauf pour les propriétaires et les collaborateurs : lorsqu'une demande d'extraction est créée ou mise à jour par un propriétaire ou un collaborateur du dépôt, les compilations sont automatiquement exécutées par le déclencheur. Si un contributeur externe lance l'action, les compilations ne sont exécutées qu'après que le propriétaire ou le collaborateur a ajouté
/gcbrun
à la demande d'extraction.Obligatoire: lorsqu'une demande d'extraction est créée ou mise à jour par les compilations ne sont exécutées qu'après qu'un propriétaire un collaborateur commente
/gcbrun
sur la demande d'extraction. Compilations sont exécutées chaque fois qu'une modification est apportée à une demande d'extraction.Non requis: lorsqu'une demande d'extraction est créée ou mise à jour par les builds sont automatiquement exécutés par des déclencheurs.
Configuration: sélectionnez le fichier de configuration de compilation situé dans votre dépôt ou de configurer votre build de manière intégrée le déclencheur.
Type: sélectionnez le type de configuration à utiliser pour votre compilation.
- Fichier de configuration Cloud Build (yaml or json) : utilisez un fichier de configuration de compilation pour votre configuration.
- Dockerfile : utilisez un fichier
Dockerfile
pour votre configuration.
Emplacement: spécifiez l'emplacement de votre configuration.
Dépôt : si votre fichier de configuration se trouve dans votre dépôt, indiquez l'emplacement de votre fichier de configuration de compilation ou le répertoire
Dockerfile
et un nom pour l'image obtenue. Si votre configuration est unDockerfile
, vous pouvez éventuellement fournir un délai d'expiration pour votre compilation. Une fois leDockerfile
et le nom de l'image fournis, un Aperçu de la commandedocker build
pour votre compilation.Intégré: si vous avez sélectionné Fichier de configuration Cloud Build (yaml ou json) comme option de configuration, vous pouvez spécifier votre configuration de compilation de manière intégrée. Cliquez sur Ouvrir l'éditeur pour écrire votre fichier de configuration de compilation dans la console Google Cloud à l'aide d'une syntaxe YAML ou JSON. Cliquez sur OK pour enregistrer la configuration de compilation.
Cliquez sur Créer pour créer votre déclencheur Bitbucket Cloud.
gcloud
Créez un déclencheur d'événement de transfert de dépôt à l'aide de la commande suivante :
gcloud builds triggers create bitbucket-cloud \
--name=TRIGGER_NAME \
--repository=\
projects/PROJECT_ID/locations/REGION/connections/CONNECTION_NAME/repositories/REPO_NAME \
--branch-pattern=".*" --build-config="CONFIG_NAME" \
--region=REGION
Où :
- TRIGGER-NAME correspond au nom que vous souhaitez attribuer à votre déclencheur de compilation.
- PROJECT_ID correspond à votre ID de projet Google Cloud.
- REGION correspond à la région de votre déclencheur.
- CONNECTION_NAME est le nom de votre connexion hôte.
- REPO_NAME correspond au nom de votre dépôt connecté dans Bitbucket Cloud.
- CONFIG_NAME est le nom de votre fichier de schéma de configuration.
Une fois le déclencheur créé, Cloud Build écoute tous les événements d'envoi sur toutes les branches. Lorsque vous transférez un commit vers le dépôt, le déclencheur est appelé. Vous pouvez afficher les résultats de compilation sur la page Historique de compilation.
Partage des données
Les données envoyées à Bitbucket Cloud depuis Cloud Build vous aident à identifier des déclencheurs par nom et consultez les résultats des compilations sur vos dépôts Bitbucket Cloud.
Les données suivantes sont partagées entre Cloud Build et votre hôte Bitbucket Cloud :
- ID de projet Google Cloud
- Nom du déclencheur
Étape suivante
- Découvrez comment créer et gérer des déclencheurs.
- Découvrez comment démarrer manuellement des compilations.
- Découvrez comment afficher les résultats de la compilation.
- Découvrez comment effectuer des déploiements bleu-vert sur Compute Engine.