Auf dieser Seite wird erläutert, wie Sie Anwendungen mithilfe von Cloud Build Wenn Sie Cloud Build noch nicht kennen, lesen Sie zuerst die Kurzanleitungen sowie Build-Konfiguration – Überblick.
Cloud Functions ist eine serverlose Ausführungsumgebung zum Erstellen und Verbinden von Cloud-Diensten. Mit Cloud Functions schreiben Sie einfache Funktionen, die einem einzigen Zweck dienen und an Ereignisse gebunden sind, die von Ihrer Cloud-Infrastruktur und Ihren Diensten ausgegeben werden. Die Funktion wird ausgelöst, wenn ein beobachtetes Ereignis initiiert wird. Weitere Informationen zu Cloud Functions finden Sie in der Cloud Functions-Dokumentation.
Hinweis
Aktivieren Sie die Cloud Functions API.
Weisen Sie dem Cloud Build-Dienstkonto die Rolle Cloud Functions-Entwickler zu:
Rufen Sie die Cloud Build-Seite Einstellungen auf:
Setzen Sie den Status der Rolle Cloud Functions-Entwickler auf Aktiviert.
Zum Ausführen der
gcloud
-Befehle auf dieser Seite installieren Sie den Google Cloud CLIHalten Sie den Anwendungsquellcode bereit, den Sie erstellen und in Cloud Functions bereitstellen möchten. Ihr Quellcode muss in einem Repository gespeichert sein, z. B. Cloud Source Repositories, GitHub oder Bitbucket.
Bereitstellung konfigurieren
Mit Cloud Build können Sie jedes öffentlich verfügbare Container-Image zur Ausführung Ihrer Aufgaben verwenden. Geben Sie dazu in der Cloud Build-Konfigurationsdatei das Image in einem Build-step
an.
Cloud Functions bietet den Befehl gcloud functions deploy
, mit dem Ihre Funktion aus dem Verzeichnis, das Ihren Funktionscode enthält, bereitgestellt wird.
Sie können die
cloud-sdk
Bild
als Build-Schritt in Ihrer Konfigurationsdatei zum Aufrufen von gcloud
-Befehlen im Image.
Argumente, die an diesen Build-Schritt übergeben werden,
werden direkt an die Google Cloud CLI übergeben.
So können Sie in diesem Image jeden gcloud
-Befehl ausführen.
Führen Sie die folgenden Schritte aus, um eine Anwendung in Cloud Functions bereitzustellen:
- Erstellen Sie im Stammverzeichnis Ihres Projekts die Cloud Build-Konfigurationsdatei mit dem Namen
cloudbuild.yaml
odercloudbuild.json
. In der Konfigurationsdatei:
- Fügen Sie das Feld
name
ein und geben Sie dengcloud
-Build-Schritt an. - Fügen Sie den Wert
functions deploy
zum Feldargs
hinzu, um den Befehlgcloud functions deploy
aufzurufen. Informationen zu verfügbaren Konfigurationsoptionen finden Sie in der Referenz zugcloud functions deploy
. --source=.
gibt an, dass sich der Quellcode im aktuellen Arbeitsverzeichnis befindet.
YAML
steps: - name: 'gcr.io/google.com/cloudsdktool/cloud-sdk' args: - gcloud - functions - deploy - FUNCTION_NAME - --region=FUNCTION_REGION - --source=. - --trigger-http - --runtime=RUNTIME
JSON
{ "steps": [ { "name": "gcr.io/google.com/cloudsdktool/cloud-sdk", "args": [ "gcloud", "functions", "deploy", [ "FUNCTION_NAME" ], "--region=FUNCTION_REGION", "--source=.", "--trigger-http", "--runtime=RUNTIME" ] } ] }
Ersetzen Sie die Platzhalterwerte in der obigen Konfigurationsdatei durch Folgendes:
FUNCTION_NAME
ist der Name der Cloud Functions-Funktionen, die Sie bereitstellen. Wenn Sie eine vorhandene Funktion aktualisieren, muss dieser Wert mit dem Namen der zu aktualisierenden Funktion übereinstimmen.FUNCTION_REGION
ist die Region, in der Sie Cloud Functions bereitstellen. Eine Liste der unterstützten Regionen finden Sie unter Cloud Functions-Standorte.--trigger-http
ist der Triggertyp der Funktion, in diesem Fall eine HTTP-Anfrage (Webhook).RUNTIME
ist die Laufzeit, in der die Funktion ausgeführt werden soll.
Weitere Informationen zur Verwendung von
gcloud functions deploy
finden Sie in der Cloud Functions-Dokumentation.- Fügen Sie das Feld
Starten Sie den Build mit der im vorherigen Schritt erstellten Konfigurationsdatei:
gcloud builds submit --region=REGION --config CONFIG_FILE_PATH SOURCE_DIRECTORY
Ersetzen Sie die Platzhalterwerte in der obigen Konfigurationsdatei durch Folgendes:
CONFIG_FILE_PATH
ist der Pfad zur Build-Konfigurationsdatei.SOURCE_DIRECTORY
ist der Pfad oder die URL zum Quellcode.REGION
ist eine der unterstützten Build-Regionen.
Wenn Sie
CONFIG_FILE_PATH
undSOURCE_DIRECTORY
im Befehlgcloud builds submit
nicht angeben, geht Cloud Build davon aus, dass sich die Konfigurationsdatei und der Quellcode im aktuellen Arbeitsverzeichnis befinden.
Kontinuierliche Bereitstellung
Sie können die Bereitstellung Ihrer Software in Cloud Functions automatisieren. Erstellen Sie hierfür Cloud Build-Trigger. Sie können die Trigger so konfigurieren, dass Images immer dann erstellt und bereitgestellt werden, wenn Sie den Quellcode aktualisieren.
So automatisieren Sie die Bereitstellung in Cloud Functions:
Fügen Sie in Ihrem Repository-Stammverzeichnis eine Konfigurationsdatei mit Schritten zum Aufrufen des Befehls
gcloud functions deploy
hinzu:YAML
steps: - name: 'gcr.io/google.com/cloudsdktool/cloud-sdk' args: - gcloud - functions - deploy - FUNCTION_NAME - --region=FUNCTION_REGION - --source=. - --trigger-http - --runtime=RUNTIME
JSON
{ "steps": [ { "name": "gcr.io/google.com/cloudsdktool/cloud-sdk", "args": [ "gcloud", "functions", "deploy", [ "FUNCTION_NAME" ], "--region=FUNCTION_REGION", "--source=.", "--trigger-http", "--runtime=RUNTIME" ] } ] }
Ersetzen Sie die Platzhalterwerte in der obigen Konfigurationsdatei durch Folgendes:
FUNCTION_NAME
ist der Name der Cloud Functions-Funktionen, die Sie bereitstellen. Wenn Sie eine vorhandene Funktion aktualisieren, muss dieser Wert mit dem Namen der zu aktualisierenden Funktion übereinstimmen.FUNCTION_REGION
ist die Region, in der Sie Cloud Functions bereitstellen. Eine Liste der unterstützten Regionen finden Sie unter Cloud Functions-Standorte.--trigger-http
ist der Triggertyp der Funktion, in diesem Fall eine HTTP-Anfrage (Webhook).RUNTIME
ist die Laufzeit, in der die Funktion ausgeführt werden soll.
Erstellen Sie mit der im vorherigen Schritt erstellten Konfigurationsdatei einen Build-Trigger:
Öffnen Sie in der Google Cloud Console die Seite Trigger:
Wählen Sie oben auf der Seite im Drop-down-Menü für die Projektauswahl Ihr Projekt aus.
Klicken Sie auf Trigger erstellen.
Geben Sie im Feld Name einen Namen für den Trigger ein.
Wählen Sie unter Region die Region für den Trigger aus.
Wählen Sie unter Ereignis das Repository-Ereignis aus, um den Trigger zu starten.
Wählen Sie unter Quelle Ihr Repository und den Branch- oder Tag-Namen aus, der den Trigger auslöst. Weitere Informationen zum Angeben, welche Branches automatisch erstellt werden sollen, finden Sie unter Build-Trigger erstellen.
Wählen Sie unter Konfiguration die Option Cloud Build Konfigurationsdatei (YAML oder JSON).
Geben Sie im Feld Speicherort der Cloud Build-Konfigurationsdatei
cloudbuild.yaml
nach/
ein.Klicken Sie auf Erstellen, um den Build-Trigger zu speichern.
Jedes Mal, wenn Sie neuen Code in Ihr Repository übertragen, lösen Sie automatisch einen Build aus und stellen diesen in Cloud Functions bereit.
Weitere Informationen zum Erstellen von Cloud Build-Triggern finden Sie unter Build-Trigger erstellen und verwalten.
Nächste Schritte
- Blau/Grün-Bereitstellungen in Compute Engine ausführen
- Mehr zum Bereitstellen in Cloud Run
- Mehr zum Bereitstellen in GKE
- Mehr zum Bereitstellen in Firebase
- Mehr zum Bereitstellen in App Engine
- Build-Fehler beheben