Auf dieser Seite wird erläutert, wie Sie manuelle Trigger zum Erstellen von Code erstellen. in Quell-Repositories. 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. Du kannst auch manuelle automatisch zu einer bestimmten Zeit ausgeführt werden.
Hier erfahren Sie, wie Sie Builds manuell über die gcloud CLI oder der Cloud Build API finden Sie unter Builds manuell starten
Hinweise
-
Cloud Build 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 statt aus einem gehosteten Repository ausführen möchten
oder Builds senden möchten, ohne einen Trigger zu erstellen, können Sie folgenden Befehl ausführen:
gcloud
-Befehl in Ihrem Arbeitsverzeichnis:
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:
Seite "Trigger" aufrufen
Wählen Sie das Projekt oben auf der Seite 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 den Trigger aus.
- Wenn Sie als Region global auswählen, Cloud Build verwendet die Standardeinstellung zur Ausführung Ihres Builds.
- Wenn Sie eine nicht globale Region auswählen und das Feld Mit dem Trigger verknüpfte Build-Konfigurationsdatei einen privaten Pool angibt, verwendet Cloud Build den privaten Pool zur Ausführung Ihres Builds. In diesem Fall muss die im Trigger angegebene Region mit der Region übereinstimmen, in der Sie den privaten Pool erstellt haben.
- Wenn Sie eine nicht globale Region auswählen und das Feld Mit dem Trigger verknüpfte Build-Konfigurationsdatei keinen privaten Pool angibt. Cloud Build verwendet die Standardeinstellung Pool, um den Build in derselben Region auszuführen als Trigger festlegen.
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. Sie können Geben Sie 1st generation oder 2nd generation als Quelle an.
Version: Wählen Sie den Zweig 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.
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 die Konfigurationsdatei in der
Remote-Repository, geben Sie den Speicherort Ihres
Build-Konfigurationsdatei, die
Dockerfile
oder im Verzeichnis buildpacks. Wenn Ihr Build-Konfigurationstyp eineDockerfile
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 derDockerfile
oder des Buildpacks angegeben haben, sehen Sie eine Vorschau des Befehlsdocker build
oderpack
, den Ihr Build ausführen wird. - Inline: Wenn Sie Cloud Build-Konfigurationsdatei (YAML oder JSON) als Konfigurationsoption auswählen, können Sie Ihre Build-Konfiguration inline angeben. Klicken Sie auf Editor öffnen, um die Build-Konfigurationsdatei mithilfe der YAML- oder JSON-Syntax in der Google Cloud Console zu schreiben. Klicken Sie auf Fertig, um die Build-Konfiguration zu speichern.
- Repository: Wenn sich die Konfigurationsdatei in der
Remote-Repository, geben Sie den Speicherort Ihres
Build-Konfigurationsdatei, die
- Typ: Wählen Sie den Konfigurationstyp aus, der für Ihren Build verwendet werden soll.
Klicken Sie auf Erstellen, um den manuellen Trigger zu erstellen.
gcloud
Eine vollständige Liste der Flags finden Sie in der Referenz zu gcloud
zum Erstellen manueller Trigger.
Manuelle Trigger ausführen
Console
So führen Sie einen manuellen Trigger mit der Google Cloud Console aus:
Öffnen Sie in der Google Cloud Console die Seite Trigger.
Suchen Sie den Trigger in der Liste.
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 auszuführen.
Informationen zum manuellen Ausführen von Triggern nach Zeitplan finden Sie unter Builds planen.
gcloud
Führen Sie folgenden Befehl aus, um mit dem gcloud
-Befehlszeilentool einen manuellen Trigger auszuführen:
Befehl:
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 den Trigger.BRANCH_NAME
ist der Name Ihres Zweigs. Sie können Geben Sie außerdem ein Tag mit--tag
oder eine Commit-ID mit--sha
an.- [Optional]
SUBSTITUTION_VAR
ist der Variablenname für den Ersatzwert. - [Optional]
SUBSTITUTION_VALUE
ist der mit der Ersetzung verknüpfte Wert .
Informationen zum Ausführen manueller Trigger nach Zeitplan finden Sie unter Builds planen.
Nächste Schritte
- Builds manuell starten mit
gcloud
-Befehlen oder der Cloud Build API. - Builds planen
- Trigger erstellen und verwalten
- Build-Ergebnisse aufrufen
- Build-Fehler beheben