Diese Seite wurde von der Cloud Translation API übersetzt.
Switch to English

Manuelle Trigger erstellen

Auf dieser Seite wird erläutert, wie Sie manuelle Trigger 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 dem gcloud-Befehlszeilentool oder der Cloud Build API finden Sie unter Builds manuell starten.

Hinweis

  • Aktivieren Sie die Cloud Build API.

    Aktivieren Sie die API

  • 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 aufrufen. 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.
  • den Build mit Substitutionen parametrisieren, die nicht bei jedem Aufruf eines Builds manuell übergeben werden müssen.
  • Definierte Substitutionsvariablewerte zum Zeitpunkt des Aufrufs vor der Ausführung eines Builds überschreiben.

Wenn Sie Builds aus Ihrem lokalen Arbeitsverzeichnis anstelle eines gehosteten Repositories aufrufen 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

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
    • Beschreibung Optional: Eine Beschreibung für Ihren Trigger.
    • Wann: Wählen Sie Manuell ausführen 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.
    • Revision: Wählen Sie den Branch oder das Tag aus, der erstellt werden soll, wenn der manuelle Trigger ausgeführt wird.
      • Branch: Legen Sie einen Trigger fest, der auf diesem Zweig erstellt werden soll. Sie müssen einen Literalwert angeben. Reguläre Ausdrücke werden derzeit 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 derzeit nicht unterstützt.
    • Configuration (Konfiguration): Wählen Sie die Build-Konfigurationsdatei in Ihrem Remote-Repository aus oder erstellen Sie eine Inline-Build-Konfigurationsdatei für Ihren Build.

      • Typ: Wählen Sie den Konfigurationstyp für den Build aus.
        • Cloud Build-Konfigurationsdatei (YAML oder JSON): Verwenden Sie eine Build-Konfigurationsdatei für Ihre Konfiguration.
        • Dockerfile: Dockerfile für Ihre Konfiguration verwenden.
      • Speicherort: Geben Sie den Standort für Ihre Konfiguration an.

        • Repository Wenn sich die Konfigurationsdatei in Ihrem Remote-Repository befindet, geben Sie den Speicherort IhrerBuild-Konfigurationsdatei oder dieDockerfile Verzeichnis und einen Namen für das resultierende Bild. Wenn Ihre Konfiguration ein Dockerfile ist, können Sie optional eine Zeitüberschreitung für Ihren Build angeben. Wenn Sie das Dockerfile und den Image-Namen angegeben haben, sehen Sie eine Vorschau des docker build-Befehls, den Ihr Build ausführen wird.
        • Inline: Wenn Sie als Konfigurationsoption Cloud Build-Konfigurationsdatei (yaml oder json) ausgewählt haben, können Sie Ihre Build-Konfiguration inline angeben. Klicken Sie auf Open Editor (Editor öffnen), um die Build-Konfigurationsdatei in der Google Cloud Console mithilfe 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.

Build planen

Mit manuellen Triggern in der Google Cloud Console können Sie Builds für einen bestimmten Zeitpunkt planen. Derzeit können Builds mit gcloud-Befehlen oder über API-Aufrufe nicht geplant werden. Wenn Sie keinen manuellen Trigger erstellt haben, finden Sie weitere Informationen unter Manuelle Trigger erstellen.

  1. Seite "Trigger" aufrufen

    Seite "Trigger" aufrufen

  2. Klicken Sie auf den Namen des manuellen Triggers, für den Sie Builds planen möchten.

    Sie sehen die Seite Trigger bearbeiten.

  3. Klicken Sie auf Im Zeitplan ausführen, um den Build zu planen.

    Auf der rechten Seite wird der Bereich Trigger nach Zeitplan ausführen angezeigt.

  4. Cloud Scheduler API aktivieren

    Sie werden nur zur Aktivierung der Cloud Scheduler API aufgefordert, wenn Sie zum ersten Mal einen Build planen

  5. Wählen Sie ein Dienstkonto aus, das von Cloud Scheduler verwendet wird, um den Trigger aufzurufen.

    Sie sehen das Standarddienstkonto für die Planung im folgenden Format, wobei project-id die Projekt-ID für Ihr Projekt ist:

     cloud-build-trigger-scheduler@project-id.iam.gserviceaccount.com
    

    Wenn dies ausgewählt ist, wird das Standarddienstkonto automatisch für Sie erstellt. Die Rolle Cloud Build-Bearbeiter wird dem Dienstkonto bei der Erstellung zugewiesen. Wir empfehlen, das Standarddienstkonto, das von Cloud Scheduler zum Aufrufen des Triggers verwendet wurde, nicht zu löschen. Wenn das Dienstkonto gelöscht oder die mit dem Dienstkonto verknüpften Berechtigungen bearbeitet werden, können Sie die IAM-Seite aufrufen, um das Dienstkonto manuell hinzuzufügen und die Rolle Rolle Cloud Build-Bearbeiter Es kann bis zu eine Stunde dauern, bis vorhandene Cloud Scheduler-Jobs fortgesetzt werden, nachdem das Dienstkonto neu erstellt wurde.

    Klicken Sie auf Weiter.

  6. Geben Sie die folgenden Cloud Scheduler-Jobeinstellungen ein:

    • Name: Ein Name für den Cloud Scheduler-Job.
    • Beschreibung (optional): Eine Beschreibung für Ihren Cloud Scheduler-Job.
    • Häufigkeit: Legen Sie fest, wie oft der Trigger ausgeführt werden soll. Sie können eine Häufigkeit im Drop-down-Menü auswählen oder einen benutzerdefinierten Wert über die Cron-Syntax eingeben. Wenn der manuelle Trigger täglich um 6:00 Uhr ausgeführt werden soll, können Sie die Häufigkeit in der Cron-Syntax als 0 6 * * * angeben. Weitere Informationen zur Cron-Syntax finden Sie unter Cron-Jobpläne konfigurieren.
    • Zeitzone: Wählen Sie Ihre Zeitzone aus.
  7. Klicken Sie auf Erstellen, um den Cloud Scheduler-Job zu erstellen.

  8. Wenn Sie Ihren Cloud Scheduler-Job ansehen möchten, klicken Sie auf Ansehen. Klicken Sie andernfalls auf Fertig, um die Ansicht zu schließen.

Wenn Sie die mit Ihrem manuellen Trigger verknüpfte Überarbeitung aktualisieren, müssen Sie den Cloud Scheduler-Job, der mit Ihrem Trigger verknüpft ist, manuell aktualisieren. Wenn Sie beispielsweise den Branch-Namen für den manuellen Trigger aktualisieren, müssen Sie den Namen des Branch in Ihrem Job manuell aktualisieren. Sie können die Aktualisierungen im Body des Cloud Scheduler-Jobs aktualisieren, indem Sie den ausgewählten Job auf der Cloud Scheduler-Seite bearbeiten. Geben Sie die Trigger-ID in der Filterleiste oben auf der Seite ein, um den mit Ihrem Trigger verknüpften Cloud Scheduler zu identifizieren.

Wenn Sie einen Planerjob löschen, der mit Ihrem Trigger verknüpft ist, wird er nicht mehr zur angegebenen Zeit ausgeführt. Wenn Sie einen Trigger löschen, werden nicht automatisch alle mit Ihrem Trigger verknüpften Jobs gelöscht. Wenn Sie einen Trigger deaktivieren, ist der Job weiterhin vorhanden und Builds werden weiterhin aufgerufen.

Informationen zum Löschen eines Jobs finden Sie unter Job löschen. Informationen zum Löschen oder Deaktivieren eines Triggers finden Sie unter Build-Trigger löschen oder Build-Trigger deaktivieren.

Manuelle Trigger ausführen

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 Sie neue Variablenwerte für die Substitution angegeben haben, klicken Sie auf Trigger ausführen, um den Build aufzurufen.

Nächste Schritte