Cloud Build utilise des déclencheurs de compilation pour activer l'automatisation CI/CD. Vous pouvez configurer des déclencheurs pour écouter les événements entrants, par exemple lorsqu'un nouveau commit est envoyé à un dépôt ou lorsqu'une demande d'extraction est lancée, puis exécuter automatiquement une compilation lorsque de nouveaux événements se produisent. Vous pouvez également configurer des déclencheurs pour compiler le code pour toute modification apportée à votre dépôt source ou uniquement pour les modifications correspondant à certains critères.
Cette page présente chaque type de déclencheur et les fonctionnalités associées aux déclencheurs.
Déclencheurs d'événements du dépôt
Cloud Build vous permet d'exécuter automatiquement des compilations sur des événements de dépôt, tels que des transferts ou des demandes d'extraction. Vous pouvez connecter des dépôts externes, tels que des dépôts dans GitHub ou Bitbucket, à Cloud Build ou utiliser du code dans Cloud Source Repositories pour vos builds. Bien que vous puissiez connecter n'importe quel dépôt source à Cloud Build, Cloud Build fournit des déclencheurs d'événements de dépôt spécifiques que vous pouvez utiliser pour intégrer des systèmes de gestion de code source (SCM) spécifiques. Cette section décrit les déclencheurs d'événements de dépôt disponibles.
Déclencheurs GitHub
Vous pouvez créer des déclencheurs GitHub pour exécuter automatiquement des builds en réponse à des événements de dépôt, tels que des push ou des demandes d'extraction. Vous pouvez afficher l'état de compilation du déclencheur sur GitHub et dans la console Google Cloud . Vous pouvez également utiliser l'application GitHub Cloud Build pour vous connecter et créer du code dans GitHub. Pour en savoir plus, consultez Créer des dépôts à partir de GitHub.
Déclencheurs GitHub Enterprise
Vous pouvez créer des déclencheurs pour les dépôts hébergés sur une instance GitHub Enterprise, y compris les instances hébergées dans un environnement sur site et non accessibles via une connexion Internet publique. Les déclencheurs GitHub Enterprise peuvent être utilisés pour exécuter des builds en réponse à des transferts ou à des demandes d'extraction depuis une instance GitHub Enterprise. Pour en savoir plus, consultez Créer des dépôts à partir de GitHub Enterprise.
Déclencheurs GitLab Enterprise Edition
Vous pouvez créer des déclencheurs pour les dépôts hébergés sur une instance GitLab Enterprise Edition, y compris les instances hébergées sur un réseau privé. Les déclencheurs GitLab Enterprise Edition peuvent être utilisés pour exécuter des builds en réponse à des transferts de commit ou à des demandes d'extraction associés à votre dépôt GitLab Enterprise Edition. Pour en savoir plus, consultez Créer des dépôts à partir de GitLab Enterprise Edition.
Déclencheurs Bitbucket Server
Vous pouvez créer des déclencheurs pour les dépôts hébergés sur une instance Bitbucket Server, y compris les instances hébergées dans un environnement sur site. Vous pouvez connecter votre dépôt Bitbucket Server à Cloud Build plusieurs fois avec plusieurs connexions hôtes. Pour en savoir plus sur la création de déclencheurs permettant d'exécuter des compilations en réponse à des événements, consultez Créer des dépôts à partir de Bitbucket Server.
Déclencheurs Bitbucket Data Center
Vous pouvez créer des déclencheurs pour les dépôts hébergés sur une instance Bitbucket Data Center, y compris les instances hébergées dans un environnement sur site. Les déclencheurs Bitbucket Data Center peuvent être utilisés pour exécuter des builds en réponse à des événements tels que des transferts de commit ou des demandes d'extraction. Pour en savoir plus, consultez Créer des dépôts à partir de Bitbucket Data Center.
Déclencheurs Bitbucket Cloud
Vous pouvez créer des déclencheurs pour les dépôts hébergés dans Bitbucket Cloud. Les déclencheurs Bitbucket Cloud peuvent être utilisés pour exécuter des builds en réponse à des événements tels que des transferts de commit ou des demandes d'extraction. Pour en savoir plus, consultez Créer des dépôts à partir de Bitbucket Cloud.
Déclencheurs Secure Source Manager
Vous pouvez créer des déclencheurs pour les dépôts hébergés dans Secure Source Manager. Les déclencheurs Secure Source Manager peuvent être utilisés pour exécuter des builds en réponse à des événements tels que des push de commit ou des demandes d'extraction. Pour en savoir plus, consultez Créer un fichier de déclencheurs dans Secure Source Manager.
Déclencheurs manuels
Vous pouvez créer des déclencheurs manuels pour exécuter des compilations manuellement et remplacer les valeurs des variables de substitution définies au moment de l'appel avant d'exécuter une compilation. Vous pouvez également configurer des déclencheurs manuels pour qu'ils s'exécutent selon une planification. Pour en savoir plus, consultez Compiler manuellement du code dans des dépôts sources.
Déclencheurs Pub/Sub
Vous pouvez créer des déclencheurs Pub/Sub pour exécuter des compilations en réponse à n'importe quel message publié via Pub/Sub. Par exemple, vous pouvez utiliser des déclencheurs Pub/Sub pour créer des builds en réponse aux envois d'images vers Artifact Registry. Dans ce cas, vous pouvez configurer votre déclencheur pour qu'il utilise des filtres afin d'exécuter une compilation uniquement si l'image transférée correspond à un tag spécifique, tel que prod.
De plus, les déclencheurs Pub/Sub peuvent être configurés pour s'abonner à n'importe quel sujet Pub/Sub. Pour en savoir plus, consultez Automatiser les builds en réponse à des événements Pub/Sub.
Déclencheurs de webhook
Vous pouvez créer des déclencheurs de webhook pour exécuter des builds en réponse à des webhooks. Les événements de webhook envoyés à une URL personnalisée vous permettent de connecter directement des systèmes externes et des systèmes de gestion de code source (SCM) externes, tels que Bitbucket.com, Bitbucket Server ou GitLab, à Cloud Build. Lorsque vous créez des déclencheurs de webhook, vous pouvez également définir votre configuration de compilation de manière intégrée sur votre déclencheur pour contrôler les dépôts que votre déclencheur clone au moment de la compilation, plutôt que de spécifier explicitement une source. Pour en savoir plus, consultez Automatiser les builds en réponse aux événements de webhook. Pour apprendre à utiliser des déclencheurs de webhook pour créer des dépôts à partir de SCM spécifiques, consultez Créer des dépôts à partir de Bitbucket Server, Créer des dépôts à partir de Bitbucket Cloud et Créer des dépôts à partir de GitLab.
Déclencheurs pour les dépôts associés à Developer Connect
Developer Connect vous permet de connecter des produits externes ou des outils de développement non Google à Google Cloud à l'aide d'étapes et d'applications standardisées. Vous pouvez configurer des déclencheurs qui compilent à partir de dépôts connectés via Developer Connect pour les SCM suivants :
- Bitbucket Cloud
- Bitbucket Data Center
- Bitbucket Server
- GitHub
- GitHub Enterprise
- GitLab
- GitLab Enterprise Edition
Fonctionnalités de déclenchement
Les déclencheurs Cloud Build fournissent des fonctionnalités qui vous permettent de contrôler avec précision l'exécution d'un build. Cette section décrit les différentes fonctionnalités associées aux déclencheurs.
Déclencheurs manuels planifiés
Vous pouvez planifier des déclencheurs manuels pour exécuter automatiquement des builds selon une planification prédéfinie. Par exemple, vous pouvez configurer un déclencheur planifié pour exécuter une compilation tous les samedis à 6h. Pour planifier des compilations, vous pouvez créer un déclencheur manuel et l'appeler à l'aide de Cloud Scheduler. Pour en savoir plus, consultez Planifier des builds.
Filtrer des événements
Cloud Build utilise le langage CEL (Common Expression Language) avec la variable build sur les champs répertoriés dans la ressource Build pour accéder aux champs associés à votre événement de compilation, tels que l'ID de déclencheur, la liste d'images ou les valeurs de substitution. Vous pouvez utiliser la chaîne filter pour filtrer les événements de compilation dans votre fichier de configuration de compilation à l'aide de n'importe quel champ listé dans la ressource Build. Pour en savoir plus, consultez Utiliser CEL pour filtrer les événements de compilation.
Variables de substitution
Vous pouvez spécifier des variables de substitution dans votre fichier de configuration de compilation pour remplacer des valeurs spécifiques au moment de la compilation. Par exemple, vous pouvez utiliser des variables de substitution si vous ne connaissez pas la valeur avant la compilation ou si vous souhaitez réutiliser une requête de compilation existante avec différentes variables. Cloud Build fournit des substitutions par défaut que vous pouvez utiliser pour les compilations appelées par des déclencheurs, telles que des mappages de variables vers le nom de votre déclencheur ou le nom de votre dépôt. Vous pouvez également définir vos propres variables de substitution. Pour en savoir plus, consultez la section Remplacer les valeurs des variables.
Extension des paramètres bash
Vous pouvez appliquer des extensions de paramètres bash aux valeurs des variables de substitution. Les extensions de paramètres bash vous permettent de manipuler des chaînes associées à des variables existantes. Par exemple, vous pouvez utiliser des extensions de paramètres bash pour mettre des majuscules ou remplacer une sous-chaîne. Pour en savoir plus, consultez la section Expansions des paramètres bash.
Liaisons de charge utile
Vous pouvez stocker une partie de la charge utile d'un événement de déclencheur en tant que variable de substitution à l'aide de liaisons de charge utile. Les variables associées à une charge utile sont appelées liaisons et sont disponibles pour les compilations appelées par des événements push et pull. Vous pouvez utiliser des liaisons pour accéder à des données supplémentaires liées à votre compilation, telles que l'auteur d'une demande d'extraction. Pour en savoir plus, consultez la section Liaisons de charge utile.
Approbations
Vous pouvez configurer des déclencheurs pour qu'ils n'exécutent pas immédiatement un build, mais qu'ils le marquent comme en attente jusqu'à ce qu'il soit approuvé. Si un utilisateur disposant des autorisations approuve une compilation en attente, celle-ci démarre. Si l'approbation est refusée, la compilation ne démarre pas. Pour savoir comment configurer des déclencheurs nécessitant une approbation, consultez Contrôler les builds en fonction de l'approbation.
Notifications d'état de la compilation
Vous pouvez configurer les notificateurs Cloud Build pour qu'ils écoutent les mises à jour des événements de compilation de Pub/Sub sur le sujet cloud-builds par défaut ou sur un sujet défini par l'utilisateur.
Les notificateurs peuvent également filtrer les messages reçus par le sujet et envoyer des messages à vos services connectés. Cloud Build fournit et gère des images de notificateur déployables dans le dépôt cloud-build-notifiers.
Vous pouvez configurer des notifications à l'aide d'un notificateur Cloud Build, tel que BigQuery, HTTP, Slack ou SMTP, ou créer votre propre notificateur.
Comptes de service pour les déclencheurs de compilation
Lorsqu'un déclencheur appelle une compilation, Cloud Build exécute les étapes de compilation à l'aide d'un compte de service. Selon la configuration de votre déclencheur et les paramètres des règles d'administration de votre projet, les builds appelés par des déclencheurs peuvent utiliser l'un des comptes de service suivants :
- Compte de service spécifié par l'utilisateur (
ACCOUNT_NAME@PROJECT_ID.) : recommandé. Vous créez et gérez ce compte de service, et n'accordez que les autorisations IAM (Identity and Access Management) requises pour la compilation du déclencheur. - Compte de service Compute Engine par défaut (
PROJECT_NUMBER-compute@) : compte de service de compilation par défaut pour les projets qui ont exécuté leur première compilation après la modification du compte de service par défaut, sauf restriction par des règles d'administration. Dans ces projets, vous devez sélectionner explicitement un compte de service (soit un compte de service spécifié par l'utilisateur, soit le compte de service Compute Engine par défaut) lors de la création ou de la mise à jour d'un déclencheur. - Ancien compte de service Cloud Build (
PROJECT_NUMBER@cloudbuild.) : utilisé comme compte de service de compilation par défaut dans les projets qui ont exécuté des compilations avant la modification du compte de service par défaut ou dans les organisations qui ont désactivé la modification. Dans ces projets, si le champserviceAccountd'un déclencheur n'est pas spécifié, le déclencheur utilise par défaut l'ancien compte de service Cloud Build.
Avant d'accorder des rôles IAM pour les étapes de compilation d'un déclencheur, vérifiez quel compte de service est configuré sur le déclencheur. Pour savoir comment procéder, consultez Identifier le compte de service à configurer.
Étapes suivantes
- Découvrez comment créer et gérer des déclencheurs de compilation.
- Découvrez comment configurer des comptes de service spécifiés par l'utilisateur.