Code in Quellcode-Repositories manuell erstellen

Auf dieser Seite wird erläutert, wie Sie manuelle Trigger erstellen, um Code in Quell-Repositories zu erstellen. Manuelle Trigger können verwendet werden, um Builds manuell aufzurufen. Damit haben Sie die Möglichkeit, die definierten Substitutionsvariablen vor dem Ausführen eines Builds zu überschreiben. Sie können auch manuelle Trigger für die automatische Ausführung zu einem bestimmten Zeitpunkt planen.

Weitere Informationen zum manuellen Starten von Builds mit der gcloud CLI oder der Cloud Build API finden Sie unter Builds manuell starten.

Hinweis

  • Aktivieren Sie die Cloud Build API.

    Rollen, die zum Aktivieren von APIs erforderlich sind

    Zum Aktivieren von APIs benötigen Sie die IAM-Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin), die die Berechtigung serviceusage.services.enable enthält. Weitere Informationen zum Zuweisen von Rollen

    API aktivieren

  • Halten Sie Ihren Quellcode bereit.

Manuelle Trigger

Mit manuellen Triggern können Sie Builds einrichten, die nur ausgeführt werden, wenn Sie den Trigger in verbundenen Repositories aufrufen. Angenommen, Sie erstellen eine Pipeline zum Bereitstellen Ihres Quellcodes in einer Staging- oder Produktionsumgebung. Sie können Ihren Workflow automatisieren, aber nur Builds manuell ausführen. Sie können manuelle Trigger dafür definieren.

Mit manuellen Triggern können Sie Builds manuell auslösen, indem Sie:

  • Quellcode aus einem gehosteten Repository mit einem angegebenen Zweig oder Tag abrufen.
  • Ihren Build mit Substitutionen parametrisieren, die nicht jedes Mal manuell eingegeben werden müssen, wenn Sie einen Build ausführen.
  • Definierte Substitutionsvariablewerte zum Zeitpunkt des Aufrufs vor der Ausführung eines Builds überschreiben.

Wenn Sie Builds aus Ihrem lokalen Arbeitsverzeichnis anstelle eines gehosteten Repositories ausführen oder Builds einreichen möchten, ohne einen Trigger zu erstellen, können Sie den folgenden gcloud-Befehl in Ihrem Arbeitsverzeichnis ausführen:

gcloud builds submit --config BUILD_CONFIG SOURCE_CODE

Wobei:

  • BUILD_CONFIG ist der Pfad zur Build-Konfigurationsdatei.
  • SOURCE_CODE ist der Pfad oder die URL zum Quellcode.

Weitere Informationen zur Verwendung des Befehls gcloud zum manuellen Starten von Builds in Ihrem lokalen Verzeichnis finden Sie unter Builds manuell starten.

Manuelle Trigger erstellen

Console

So erstellen Sie einen manuellen Trigger:

  1. Seite "Trigger" aufrufen

    Seite "Trigger" aufrufen

  2. Wählen Sie das Projekt oben auf der Seite aus und klicken Sie auf Öffnen.

  3. Klicken Sie auf Trigger erstellen.

  4. 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 Sie global als Region auswählen, verwendet Cloud Build den Standardpool, um Ihren Build auszuführen.
      • Wenn Sie eine nicht globale Region auswählen und in der mit dem Trigger verknüpften Build-Konfigurationsdatei ein privater Pool angegeben ist, verwendet Cloud Build den privaten Pool, um den Build auszuführen. In diesem Fall muss die Region, die Sie in Ihrem Trigger angeben, mit der Region übereinstimmen, in der Sie Ihren privaten Pool erstellt haben.
      • Wenn Sie eine nicht globale Region auswählen und 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 Manueller Aufruf aus, um den Trigger so einzurichten, dass Builds nur ausgeführt werden, wenn der Trigger manuell aufgerufen wird.

    • Quelle: Wählen Sie das Repository aus, das bei Ausführung des manuellen Triggers erstellt werden soll.

    • Repository-Generation: Wählen Sie 2. Generation aus.

    • Branch (Zweig) oder Tag: Legen Sie eine der folgenden Optionen fest:

      • Branch: Legen Sie einen Trigger fest, der auf diesem Zweig erstellt werden soll. Sie müssen einen Literalwert angeben. Reguläre Ausdrücke werden nicht unterstützt.
      • Tag: Legen Sie einen Trigger fest, der auf diesem Tag basiert. Sie müssen einen Literalwert angeben. Reguläre Ausdrücke werden nicht unterstützt.

    • Konfiguration: Wählen Sie die Build-Konfigurationsdatei aus, die sich in Ihrem Remote-Repository befindet, oder erstellen Sie eine Inline-Build-Konfigurationsdatei für den Build.

      • 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 Ihre Konfigurationsdatei in Ihrem Remote-Repository befindet, geben Sie den Speicherort Ihrer Build-Konfigurationsdatei, das Verzeichnis der Dockerfile oder das Verzeichnis der Buildpacks an. Wenn Ihr Build-Konfigurationstyp eine Dockerfile oder ein Buildpack ist, müssen Sie einen Namen für das resultierende Image und optional ein Zeitlimit für den Build angeben. Wenn Sie den Image-Namen der Dockerfile oder des Buildpacks angegeben haben, sehen Sie eine Vorschau des Befehls docker build oder pack, den Ihr Build ausführen wird.
        • 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 Konsole in der YAML- oder JSON-Syntax zu schreiben. Klicken Sie auf Fertig, um die Build-Konfiguration zu speichern.

  5. Klicken Sie auf Erstellen, um den manuellen Trigger zu erstellen.

gcloud

So erstellen Sie einen manuellen Trigger:

  1. Öffnen Sie ein Terminalfenster.

  2. Führen Sie den folgenden gcloud-Befehl aus, um in Ihrem Projekt einen Build-Trigger zu erstellen:

    gcloud builds triggers create manual \
  --region=REGION \
  --name=TRIGGER_NAME \
  --repository=projects/PROJECT_ID/locations/REGION/connections/CONNECTION_NAME/repositories/REPO_NAME \
  --branch=BRANCH_NAME \
  --build-config=BUILD_CONFIG_FILE \
  --service-account=SERVICE_ACCOUNT

Wobei:

  • REGION ist die Region für Ihren Trigger.
  • TRIGGER_NAME ist der Name des Triggers.
  • PROJECT_ID ist die Google Cloud Projekt-ID.
  • CONNECTION_NAME ist der Name Ihrer Hostverbindung.
  • REPO_NAME ist der Name Ihres Repositorys.
  • BRANCH_NAME ist der Name Ihres Zweigs. Sie können auch ein Tag mit --tag oder eine Commit-ID mit --sha angeben.
  • BUILD_CONFIG_FILE ist der Pfad zu Ihrer Build-Konfigurationsdatei. Sie können auch eine Inline-Build-Konfigurationsdatei mit --inline-config oder ein Dockerfile mit --dockerfile, --dockerfile-dir und dockerfile-image angeben.
  • SERVICE_ACCOUNT ist die mit Ihrem Dienstkonto verknüpfte E-Mail-Adresse. Wenn Sie dieses Flag nicht angeben, wird ein Standarddienstkonto verwendet.

Eine vollständige Liste der Flags finden Sie in der gcloud-Referenz zum Erstellen manueller Trigger.

Manuelle Trigger ausführen

Console

So führen Sie einen manuellen Trigger mit der Google Cloud Console aus:

  1. Öffnen Sie in der Google Cloud Console die Seite Trigger.

    Zur Seite "Trigger"

  2. Suchen Sie den Trigger in der Liste.

  3. Klicken Sie auf Trigger ausführen.

    Nachdem Sie auf Trigger ausführen geklickt haben, wird rechts der Fensterbereich Trigger ausführen angezeigt. Wenn Sie Felder wie "Branch-Name", "Tag-Name" oder "Substitutionsvariablen" angegeben haben, können Sie diese Felder zum Zeitpunkt des Aufrufs überschreiben.

    Wenn der Trigger ein Repository mit mehr als 500 Branches oder Tags verwendet, fehlen möglicherweise einige davon in den Vorschlägen. Sie können einen Branch- oder Tag-Namen weiterhin manuell eingeben.

    Wenn Sie neue Variablenwerte für die Substitution angegeben haben, klicken Sie auf Trigger ausführen, um den Build auszuführen.

    Informationen zum manuellen Ausführen von Triggern nach Zeitplan finden Sie unter Builds planen.

gcloud

Führen Sie den folgenden Befehl aus, um einen manuellen Trigger mit dem gcloud-Befehlszeilentool auszuführen:

      gcloud builds triggers run TRIGGER_NAME \
         --region=REGION \
         --branch=BRANCH_NAME \
         --substitutions=SUBSTITUTION_VAR=SUBSTITUTION_VALUE

Wobei:

  • TRIGGER_NAME ist der Name des Triggers.
  • REGION ist die Region für Ihren Trigger.
  • BRANCH_NAME ist der Name Ihres Zweigs. Sie können auch ein Tag mit --tag oder eine Commit-ID mit --sha angeben.
  • SUBSTITUTION_VAR (optional) ist der Variablenname für den Substitutionswert.
  • SUBSTITUTION_VALUE (optional) ist der Wert, der mit Ihrer Substitutionsvariablen verknüpft ist.

Informationen zum manuellen Ausführen von Triggern nach Zeitplan finden Sie unter Builds planen.

Nächste Schritte