Cloud Build-Trigger

Cloud Build verwendet Build-Trigger, um die CI/CD-Automatisierung zu aktivieren. Sie können Trigger so konfigurieren, dass sie auf eingehende Ereignisse warten, z. B. wenn ein neuer Commit an ein Repository übertragen oder ein Pull-Anfrage initiiert wird. Anschließend wird automatisch ein Build ausgeführt, wenn neue Ereignisse eingehen. Sie können auch Trigger konfigurieren, um Code bei Änderungen an Ihrem Quell-Repository oder nur bei Änderungen zu erstellen, die bestimmten Kriterien entsprechen.

Diese Seite bietet eine Übersicht über die einzelnen Triggertypen und die mit Triggern verbundenen Funktionen.

Trigger für Repository-Ereignisse

Mit Cloud Build können Sie Builds automatisch bei Repository-Ereignissen wie Push- oder Pull-Anfragen ausführen. Sie können externe Repositories wie Repositories in GitHub oder Bitbucket mit Cloud Build verbinden oder Code in Cloud Source Repositories für Ihre Builds verwenden. Sie können zwar jedes Quell-Repository mit Cloud Build verbinden, Cloud Build bietet jedoch spezielle Repository-Ereignis-Trigger, mit denen Sie bestimmte Quellcode-Verwaltungssysteme (SCMs) einbinden können. In diesem Abschnitt werden die verfügbaren Repository-Ereignis-Trigger erläutert.

GitHub-Trigger

Sie können GitHub-Trigger erstellen, um Builds automatisch als Reaktion auf Repository-Ereignisse wie Push- oder Pull-Anfragen auszuführen. Sie können den Build-Status des Triggers auf GitHub und in der Google Cloud Console einsehen. Sie können auch die Cloud Build-GitHub-Anwendung verwenden, um eine Verbindung zu GitHub herzustellen und Code in GitHub zu erstellen. Weitere Informationen finden Sie unter Repositories aus GitHub erstellen.

GitHub Enterprise-Trigger

Sie können Trigger für Repositories erstellen, die auf einer GitHub Enterprise-Instanz gehostet werden, einschließlich Instanzen, die in einer lokalen Umgebung gehostet werden und nicht über eine öffentliche Internetverbindung erreichbar sind. GitHub Enterprise-Trigger können verwendet werden, um Builds als Reaktion auf Push- oder Pull-Anfragen von einer GitHub Enterprise-Instanz auszuführen. Weitere Informationen finden Sie unter Repositories aus GitHub Enterprise erstellen.

GitLab Enterprise Edition-Trigger

Sie können Trigger für Repositories erstellen, die auf einer GitLab Enterprise Edition-Instanz gehostet werden, einschließlich Instanzen, die in einem privaten Netzwerk gehostet werden. Mit GitLab Enterprise Edition-Triggern können Builds als Reaktion auf Commit-Pushes oder Pull-Anfragen ausgeführt werden, die mit Ihrem GitLab Enterprise Edition-Repository verknüpft sind. Weitere Informationen finden Sie unter Repositories aus GitLab Enterprise Edition erstellen.

Bitbucket Server-Trigger

Sie können Trigger für Repositories erstellen, die auf einer Bitbucket Server-Instanz gehostet werden, einschließlich Instanzen, die in einer lokalen Umgebung gehostet werden. Sie können Ihr Bitbucket Server-Repository mehrmals mit mehreren Hostverbindungen mit Cloud Build verbinden. Weitere Informationen zum Erstellen von Triggern, mit denen Builds als Reaktion auf Ereignisse ausgeführt werden, finden Sie unter Repositories von Bitbucket Server erstellen.

Bitbucket Data Center-Trigger

Sie können Trigger für Repositories erstellen, die auf einer Bitbucket Data Center-Instanz gehostet werden, einschließlich Instanzen, die in einer lokalen Umgebung gehostet werden. Bitbucket Data Center-Trigger können verwendet werden, um Builds als Reaktion auf Ereignisse wie Commit-Pushes oder Pull-Anfragen auszuführen. Weitere Informationen finden Sie unter Repositories aus Bitbucket Data Center erstellen.

Bitbucket Cloud-Trigger

Sie können Trigger für Repositories erstellen, die in Bitbucket Cloud gehostet werden. Bitbucket Cloud-Trigger können verwendet werden, um Builds als Reaktion auf Ereignisse wie Commit-Pushes oder Pull-Anfragen auszuführen. Weitere Informationen finden Sie unter Repositories aus Bitbucket Cloud erstellen.

Secure Source Manager-Trigger

Sie können Trigger für Repositories erstellen, die in Secure Source Manager gehostet werden. Secure Source Manager-Trigger können verwendet werden, um Builds als Reaktion auf Ereignisse wie Commit-Pushes oder Pull-Anfragen auszuführen. Weitere Informationen finden Sie unter Triggerdatei in Secure Source Manager erstellen.

Manuelle Trigger

Sie können manuelle Trigger erstellen, um Builds manuell auszuführen und definierte Werte von Substitutionsvariablen zum Zeitpunkt des Aufrufs vor der Ausführung eines Builds zu überschreiben. Sie können auch manuelle Trigger so konfigurieren, dass sie nach einem Zeitplan ausgeführt werden. Weitere Informationen finden Sie unter Code in Quell-Repositories manuell erstellen.

Pub/Sub-Trigger

Sie können Pub/Sub-Trigger erstellen, um Builds als Reaktion auf jede über Pub/Sub veröffentlichte Nachricht auszuführen. Sie können beispielsweise Pub/Sub-Trigger verwenden, um Builds als Reaktion auf Image-Übertragungen an Artifact Registry zu erstellen. In diesem Fall können Sie den Trigger so konfigurieren, dass Filter verwendet werden, um einen Build nur dann auszuführen, wenn das hochgeladene Image mit einem bestimmten Tag wie prod übereinstimmt. Außerdem können Pub/Sub-Trigger so konfiguriert werden, dass sie ein beliebiges Pub/Sub-Thema abonnieren. Weitere Informationen finden Sie unter Builds als Reaktion auf Pub/Sub-Ereignisse automatisieren.

Webhook-Trigger

Sie können Webhook-Trigger erstellen, um Builds als Reaktion auf Webhooks auszuführen. Webhook-Ereignisse, die an eine benutzerdefinierte URL gesendet werden, ermöglichen es Ihnen, externe Systeme und externe Quellcode-Verwaltungssysteme (SCMs) wie Bitbucket.com, Bitbucket Server oder GitLab direkt mit Cloud Build zu verbinden. Beim Erstellen von Webhook-Triggern können Sie die Build-Konfiguration auch inline im Trigger definieren, um zu steuern, welche Repositories der Trigger während des Builds klont, anstatt explizit eine Quelle anzugeben. Weitere Informationen finden Sie unter Builds als Reaktion auf Webhook-Ereignisse automatisieren. Weitere Informationen zur Verwendung von Webhook-Triggern zum Erstellen von Repositories aus bestimmten SCMs finden Sie unter Repositories aus Bitbucket Server erstellen, Repositories aus Bitbucket Cloud erstellen und Repositories aus GitLab erstellen.

Trigger für mit Developer Connect verknüpfte Repositories

Mit Developer Connect können Sie externe Produkte oder Entwicklertools, die nicht von Google stammen, über standardisierte Schritte und Anwendungen mit Google Cloud verbinden. Sie können Trigger konfigurieren, die Builds aus Repositories erstellen, die über Developer Connect für die folgenden SCMs verbunden sind:

Triggerfunktionen

Cloud Build-Trigger bieten Funktionen, mit denen Sie genau steuern können, wie ein Build ausgeführt wird. In diesem Abschnitt werden verschiedene Funktionen im Zusammenhang mit Triggern erläutert.

Geplante manuelle Trigger

Sie können manuelle Trigger so planen, dass Builds automatisch nach einem vordefinierten Zeitplan ausgeführt werden. Sie können beispielsweise einen geplanten Trigger konfigurieren, um jeden Samstag um 6:00 Uhr einen Build auszuführen. Wenn Sie Builds planen möchten, können Sie einen manuellen Trigger erstellen und den Trigger mit Cloud Scheduler aufrufen. Weitere Informationen finden Sie unter Builds planen.

Ereignisse filtern

Cloud Build verwendet die Common Expression Language (CEL) mit der Variablen build für Felder, die in der Build-Ressource aufgeführt sind, um auf Felder zuzugreifen, die mit Ihrem Build-Ereignis verknüpft sind, z. B. Ihre Trigger-ID, Image-Liste oder Substitutionswerte. Mit dem String filter können Sie Build-Ereignisse in Ihrer Build-Konfigurationsdatei anhand eines beliebigen Felds filtern, das in der Ressource Build aufgeführt ist. Weitere Informationen finden Sie unter CEL zum Filtern von Build-Ereignissen verwenden.

Substitutionsvariablen

Sie können in der Build-Konfigurationsdatei Substitutionsvariablen angeben, um bestimmte Werte zum Build-Zeitpunkt zu ersetzen. Sie können beispielsweise Substitutionsvariablen verwenden, wenn ein Wert bis zur Erstellung des Builds nicht bekannt ist oder wenn Sie eine vorhandene Build-Anfrage mit anderen Variablen wiederverwenden möchten. Cloud Build bietet Standardsubstitutionen, die Sie für Builds verwenden können, die von Triggern aufgerufen werden, z. B. Variablenzuordnungen zu dem Trigger- oder Repository-Namen. Sie können außerdem Ihre eigenen Substitutionsvariablen definieren. Weitere Informationen finden Sie unter Variablenwerte ersetzen.

Bash-Parametererweiterungen

Sie können die Bash-Parametererweiterungen auf die Werte der Substitutionsvariablen anwenden. Mit Bash-Parametererweiterungen können Sie Strings bearbeiten, die mit vorhandenen Variablen verknüpft sind. Sie können beispielsweise die Bash-Parametererweiterungen verwenden, um Großbuchstaben zu verwenden oder einen Teilstring zu ersetzen. Weitere Informationen finden Sie unter Bash-Parametererweiterungen.

Nutzlastbindungen

Sie können einen Teil der Ereignisnutzlast als Substitutionsvariable mithilfe von Nutzlastbindungen speichern. Mit einer Nutzlast verknüpfte Variablen werden als Bindungen bezeichnet und sind für Builds verfügbar, die durch Push- und Pull-Ereignisse aufgerufen werden. Sie können Bindungen verwenden, um auf zusätzliche Daten zu Ihrem Build zuzugreifen, z. B. den Autor einer Pull-Anfrage. Weitere Informationen finden Sie unter Nutzlastbindungen.

Genehmigungen

Sie können Trigger so konfigurieren, dass ein Build nicht sofort ausgeführt wird, sondern als ausstehend markiert wird, bis er genehmigt wird. Wenn ein Nutzer mit Berechtigungen einen ausstehenden Build genehmigt, wird der Build gestartet. Wenn die Genehmigung abgelehnt wird, wird der Build nicht gestartet. Informationen zum Konfigurieren von Triggern, die eine Genehmigung erfordern, finden Sie unter Builds nach Genehmigung steuern.

Benachrichtigungen zum Build-Status

Sie können Cloud Build-Notifier so konfigurieren, dass sie auf Build-Ereignisaktualisierungen von Pub/Sub im Standardthema cloud-builds oder in einem benutzerdefinierten Thema warten. Benachrichtigungssysteme können auch Nachrichten filtern, die vom Thema empfangen werden, und Nachrichten an Ihre verbundenen Dienste senden. Cloud Build stellt im cloud-build-notifiers-Repository bereitstellbare Notifier-Images bereit und verwaltet sie. Sie können Benachrichtigungen mit einem Cloud Build-Notifier konfigurieren, z. B. BigQuery, HTTP, Slack oder SMTP, oder einen eigenen Notifier erstellen.

Dienstkonten für Build-Trigger

Wenn ein Trigger einen Build aufruft, führt Cloud Build die Build-Schritte mit einem Dienstkonto aus. Abhängig von der Triggerkonfiguration und den Einstellungen für die Organisationsrichtlinie Ihres Projekts können von Triggern aufgerufene Builds eines der folgenden Dienstkonten verwenden:

  • Nutzerdefiniertes Dienstkonto (ACCOUNT_NAME@PROJECT_ID.): Empfohlen. Sie erstellen und verwalten dieses Dienstkonto und gewähren nur die IAM-Berechtigungen (Identity and Access Management), die für den Build des Triggers erforderlich sind.
  • Standardmäßiges Compute Engine-Dienstkonto (PROJECT_NUMBER-compute@): Das Standard-Build-Dienstkonto für Projekte, die ihren ersten Build nach der Änderung des Standarddienstkontos ausgeführt haben, sofern nicht durch Organisationsrichtlinien eingeschränkt. In diesen Projekten müssen Sie beim Erstellen oder Aktualisieren eines Triggers explizit ein Dienstkonto auswählen (entweder ein nutzerspezifisches Dienstkonto oder das Compute Engine-Standarddienstkonto).
  • Cloud Build-Legacy-Dienstkonto (PROJECT_NUMBER@cloudbuild.): Wird als Standard-Build-Dienstkonto in Projekten verwendet, in denen vor der Änderung des Standarddienstkontos Builds ausgeführt wurden, oder in Organisationen, die die Änderung deaktiviert haben. Wenn in diesen Projekten das Feld serviceAccount eines Triggers nicht angegeben ist, wird standardmäßig das Legacy-Cloud Build-Dienstkonto verwendet.

Bevor Sie IAM-Rollen für die Build-Schritte eines Triggers zuweisen, prüfen Sie, welches Dienstkonto für den Trigger konfiguriert ist. Eine Anleitung finden Sie unter Zu konfigurierendes Dienstkonto identifizieren.

Nächste Schritte