Repositories aus Bitbucket Cloud erstellen

Mit Cloud Build können Sie Trigger zum Erstellen von Builds aus Repositories erstellen, die in Bitbucket Cloud gehostet werden. So können Sie Builds als Reaktion auf Ereignisse wie Commit-Push-Vorgänge oder Zusammenführungsanfragen ausführen, die mit Ihrem Bitbucket Cloud-Repository verknüpft sind.

Auf dieser Seite wird erläutert, wie Sie die Triggerfunktion für eine Bitbucket Cloud-Instanz aktivieren. Weitere Informationen zu Cloud Build-Triggern und Cloud Build-Repositories

Hinweise

Cloud Build and Secret Manager APIs aktivieren.
Aktivieren Sie die APIs

Folgen Sie der Anleitung zum Verbinden eines Bitbucket Cloud-Hosts.
Folgen Sie der Anleitung unter Verbindung zu einem Bitbucket Cloud-Repository herstellen.

Bitbucket Cloud-Trigger erstellen

Erstellen Sie mit den folgenden Schritten einen Bitbucket Cloud-Trigger:

Console

Seite "Trigger" aufrufen

Seite "Trigger" aufrufen
Wählen Sie Ihr Google Cloud-Projekt aus und klicken Sie auf Öffnen.
Klicken Sie auf Trigger erstellen.
Geben Sie die folgenden Triggereinstellungen ein:
- Name: Ein Name für Ihren Trigger
- Region: Wählen Sie die Region für Ihren Trigger aus.
  - Wenn die mit dem Trigger verknüpfte Build-Konfigurationsdatei einen privaten Pool angibt, verwendet Cloud Build diesen privaten Pool, um Ihren Build auszuführen. In diesem Fall muss die im Trigger angegebene Region mit der Region übereinstimmen, in der Sie Ihren privaten Pool erstellt haben.
  - Wenn in der mit dem Trigger verknüpften Build-Konfigurationsdatei kein privater Pool angegeben ist, verwendet Cloud Build den Standardpool, um den Build in derselben Region wie den Trigger auszuführen.
- Beschreibung Optional: Eine Beschreibung für Ihren Trigger.
- Ereignis: Wählen Sie das Repository-Ereignis aus, das den Trigger auslösen soll.
  - Push zu Zweig: Legen Sie den Trigger so fest, dass ein Build für Commits zu einem bestimmten Zweig gestartet wird.
  - Neues Tag mit Push übertragen: Legen Sie den Trigger so fest, dass ein Build für Commits gestartet wird, die ein bestimmtes Tag enthalten.
  - Pull-Anfrage: Legen Sie den Trigger so fest, dass er einen Build für Commits zu einer Pull-Anfrage startet.
- Quelle: Wählen Sie 2nd gen als Quelle aus.
  
  Hinweis: Die Region Ihres Repositorys muss mit der Region Ihres Triggers übereinstimmen.
  - Repository: Wählen Sie aus der Liste der verfügbaren Repositories das Repository aus. Informationen zum Verbinden eines neuen Repositorys finden Sie unter Verbindung zu einem Bitbucket-Cloud-Repository herstellen.
  - Zweig oder Tag: Geben Sie einen regulären Ausdruck mit dem abzugleichenden Zweig- oder Tag-Wert an. Informationen zur zulässigen Syntax für reguläre Ausdrücke finden Sie unter RE2-Syntax.
  - Kommentarsteuerung: Wenn Sie Pull-Anfrage als Ereignis ausgewählt haben, wählen Sie eine der folgenden Optionen aus, um festzulegen, ob ein Build automatisch vom Trigger ausgeführt werden soll:
    
    Warnung: Jeder Nutzer mit Lesezugriff auf das Repository kann eine Pull-Anfrage senden, die möglicherweise einen Build ausführt, der Änderungen am Quellcode der Pull-Anfrage enthält. Wenn Sie dieses Verhalten deaktivieren möchten, sollten Sie manuelle Genehmigungen verwenden, um Builds zu sperren, wenn Pull-Anfragen an öffentliche Repositories gesendet werden. Weitere Informationen zu Build-Berechtigungen von Triggern finden Sie unter Build-Trigger und Cloud Build-Dienstkonto.
    - Erforderlich außer für Inhaber und Mitbearbeiter: Wenn eine Pull-Anfrage von einem Repository-Inhaber oder -Mitbearbeiter erstellt oder aktualisiert wird, werden Builds automatisch vom Trigger ausgeführt. Wenn ein externer Beitragender die Aktion initiiert, werden Builds erst ausgeführt, nachdem ein Inhaber oder Mitbearbeiter /gcbrun in der Pull-Anfrage kommentiert hat.
    - Erforderlich: Wenn eine Pull-Anfrage von einem Beitragenden erstellt oder aktualisiert wird, werden Builds erst ausgeführt, nachdem ein Inhaber oder Mitbearbeiter /gcbrun in der Pull-Anfrage kommentiert hat. Builds werden jedes Mal ausgeführt, wenn eine Änderung an einer Pull-Anfrage vorgenommen wird.
    - Nicht erforderlich: Wenn eine Pull-Anfrage von einem Beitragenden erstellt oder aktualisiert wird, werden Builds automatisch durch Trigger ausgeführt.
- Konfiguration: Wählen Sie die Build-Konfigurationsdatei in Ihrem Repository aus oder konfigurieren Sie Ihren Build inline im Trigger.
- Typ: Wählen Sie den Konfigurationstyp aus, der für Ihren Build verwendet werden soll.
  - Cloud Build-Konfigurationsdatei (YAML oder JSON): Verwenden Sie eine Build-Konfigurationsdatei für Ihre Konfiguration.
  - Dockerfile: Verwenden Sie für Ihre Konfiguration eine Dockerfile.
- Speicherort: Geben Sie den Speicherort für Ihre Konfiguration an.
  - Repository: Wenn sich die Konfigurationsdatei in Ihrem Repository befindet, geben Sie den Speicherort der Build-Konfigurationsdatei oder das Verzeichnis Dockerfile und einen Namen für das resultierende Image an. Wenn Ihre Konfiguration eine Dockerfile ist, können Sie optional ein Zeitlimit für Ihren Build angeben. Wenn Sie Dockerfile und den Image-Namen angegeben haben, sehen Sie eine Vorschau des Befehls docker build für Ihren Build.
  - Inline: Wenn Sie die Cloud Build-Konfigurationsdatei (YAML oder JSON) als Konfigurationsoption ausgewählt haben, können Sie die Build-Konfiguration inline angeben. Klicken Sie auf Editor öffnen, um Ihre Build-Konfigurationsdatei in der Google Cloud Console mit der YAML- oder JSON-Syntax zu schreiben. Klicken Sie auf Fertig, um die Build-Konfiguration zu speichern.
    
    Hinweis: Die Unterstützung für Inline-Build-Konfigurationen ist für Dockerfile nicht verfügbar.
Klicken Sie auf Erstellen, um Ihren Bitbucket Cloud-Trigger zu erstellen.

gcloud

Erstellen Sie mit dem folgenden Befehl einen Trigger für ein Repository-Push-Ereignis:

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

Wobei:

TRIGGER-NAME ist der Name, den Sie dem Build-Trigger geben möchten.
PROJECT_ID ist Ihre Google Cloud-Projekt-ID.
REGION ist die Region für Ihren Trigger.
CONNECTION_NAME ist der Name Ihrer Hostverbindung.
REPO_NAME ist der Name Ihres verbundenen Repositorys in Bitbucket Cloud.
CONFIG_NAME ist der Name der Konfigurationsschemadatei.

Nachdem der Trigger erstellt wurde, überwacht Cloud Build alle Push-Ereignisse in allen Zweigen. Wenn Sie einen Commit an das Repository übertragen, wird der Trigger aufgerufen. Sie können sich die Build-Ergebnisse auf der Seite Build-Verlauf ansehen.

Mithilfe der von Cloud Build an Bitbucket Cloud gesendeten Daten können Sie Trigger anhand ihrer Namen identifizieren und Build-Ergebnisse in Ihren Bitbucket Cloud-Repositories ansehen.

Die folgenden Daten werden zwischen Cloud Build und Ihrem Bitbucket-Cloud-Host geteilt:

Google Cloud-Projekt-ID
Triggername