In diesem Thema wird das Schreiben, Bereitstellen und Auslösen einer Cloud Functions-HTTP-Funktion veranschaulicht.
Ziele
- Cloud Functions-HTTP-Funktionen schreiben, bereitstellen und auslösen
Kosten
In dieser Anleitung werden die folgenden kostenpflichtigen Komponenten von Google Cloud verwendet:
- Cloud Functions
Mit dem Preisrechner können Sie eine Kostenschätzung für Ihre voraussichtliche Nutzung vornehmen.
Hinweis
- Melden Sie sich bei Ihrem Google Cloud-Konto an. Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.
-
Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.
-
Die Abrechnung für das Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für ein Projekt aktiviert ist.
-
Cloud Functions and Cloud Build APIs aktivieren.
- Installieren und initialisieren Sie Google Cloud CLI.
-
Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.
-
Die Abrechnung für das Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für ein Projekt aktiviert ist.
-
Cloud Functions and Cloud Build APIs aktivieren.
- Installieren und initialisieren Sie Google Cloud CLI.
- Bereiten Sie die Entwicklungsumgebung vor.
Node.js
Python
Go
Java
C#
Ruby
PHP
Wenn Sie die gcloud CLI bereits installiert haben, aktualisieren Sie sie mit dem folgenden Befehl:
gcloud components update
Anwendung vorbereiten
Klonen Sie das Repository der Beispiel-App auf Ihren lokalen Computer:
Node.js
git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples.git
Sie können auch das Beispiel als ZIP-Datei herunterladen und extrahieren.
Python
git clone https://github.com/GoogleCloudPlatform/python-docs-samples.git
Sie können auch das Beispiel als ZIP-Datei herunterladen und extrahieren.
Go
git clone https://github.com/GoogleCloudPlatform/golang-samples.git
Sie können auch das Beispiel als ZIP-Datei herunterladen und extrahieren.
Java
git clone https://github.com/GoogleCloudPlatform/java-docs-samples.git
Sie können auch das Beispiel als ZIP-Datei herunterladen und extrahieren.
C#
git clone https://github.com/GoogleCloudPlatform/dotnet-docs-samples.git
Sie können auch das Beispiel als ZIP-Datei herunterladen und extrahieren.
Ruby
git clone https://github.com/GoogleCloudPlatform/ruby-docs-samples.git
Sie können auch das Beispiel als ZIP-Datei herunterladen und extrahieren.
PHP
git clone https://github.com/GoogleCloudPlatform/php-docs-samples.git
Sie können auch das Beispiel als ZIP-Datei herunterladen und extrahieren.
Wechseln Sie in das Verzeichnis, das den Cloud Functions-Beispielcode enthält:
Node.js
cd nodejs-docs-samples/functions/helloworld/
Python
cd python-docs-samples/functions/helloworld/
Go
cd golang-samples/functions/helloworld/
Java
cd java-docs-samples/functions/helloworld/helloworld/
C#
cd dotnet-docs-samples/functions/helloworld/HelloWorld/
Ruby
cd ruby-docs-samples/functions/helloworld/
PHP
cd php-docs-samples/functions/helloworld_get/
Sehen Sie sich den Beispielcode an:
Node.js
Python
Go
Java
C#
Ruby
PHP
Funktion bereitstellen
Führen Sie den folgenden Befehl im dem Verzeichnis aus, das den Beispielcode (oder im Fall von Java die Datei pom.xml
) enthält, um die Funktion mit einem HTTP-Trigger bereitzustellen:
Node.js
gcloud functions deploy helloGET \ --runtime nodejs16 --trigger-http --allow-unauthenticatedMit den folgenden Werten für das Flag
--runtime
können Sie Ihre bevorzugte Version von Node.js festlegen:nodejs16
(empfohlen).nodejs14
nodejs12
nodejs10
Python
gcloud functions deploy hello_get \ --runtime python39 --trigger-http --allow-unauthenticatedMit den folgenden Werten für das Flag
--runtime
können Sie Ihre bevorzugte Version von Python festlegen:python310
(Vorschau)python39
(empfohlen).python38
python37
Go
gcloud functions deploy HelloGet \ --runtime go116 --trigger-http --allow-unauthenticatedMit diesen Werten für das Flag
--runtime
können Sie Ihre bevorzugte Version von Go festlegen:
go116
(empfohlen).go113
go111
Java
gcloud functions deploy java-http-function \ --entry-point functions.HelloWorld \ --runtime java11 \ --memory 512MB --trigger-http --allow-unauthenticatedMit den folgenden Werten für das Flag
--runtime
können Sie Ihre bevorzugte Version von Java festlegen:
java17
(Vorschau)java11
(empfohlen).
C#
gcloud functions deploy csharp-http-function \ --entry-point HelloWorld.Function \ --runtime dotnet3 --trigger-http --allow-unauthenticated
Ruby
gcloud functions deploy hello_get --runtime ruby30 --trigger-http --allow-unauthenticatedMit den folgenden Werten für das Flag
--runtime
können Sie Ihre bevorzugte Version von Ruby festlegen:
ruby30
(empfohlen).ruby27
ruby26
PHP
gcloud functions deploy helloGet --runtime php74 --trigger-http --allow-unauthenticatedMit den folgenden Werten für das Flag
--runtime
können Sie Ihre bevorzugte Version von PHP festlegen:php81
(Vorschau)php74
(empfohlen).
Mit dem Flag --allow-unauthenticated
können Sie die Funktion ohne Authentifizierung aufrufen.
Wenn Sie eine Authentifizierung anfordern möchten, lassen Sie das Flag weg.
Funktion auslösen
Führen Sie den folgenden Befehl aus, um eine HTTP-Anfrage an die Funktion zu senden:
Node.js
curl "https://REGION-PROJECT_ID.cloudfunctions.net/helloGET"
Python
curl "https://REGION-PROJECT_ID.cloudfunctions.net/hello_get"
Go
curl "https://REGION-PROJECT_ID.cloudfunctions.net/HelloGet"
Java
curl "https://REGION-PROJECT_ID.cloudfunctions.net/java-http-function"
C#
curl "https://REGION-PROJECT_ID.cloudfunctions.net/csharp-http-function"
Ruby
curl "https://REGION-PROJECT_ID.cloudfunctions.net/hello_get"
PHP
curl "https://REGION-PROJECT_ID.cloudfunctions.net/helloGet"
Dabei gilt:
REGION
ist die Region, in der die Funktion bereitgestellt wird. Der Wert ist in Ihrem Terminal sichtbar, wenn die Bereitstellung der Funktion abgeschlossen ist.PROJECT_ID
die ID Ihres Cloud-Projekts. Der Wert ist in Ihrem Terminal zu sehen, wenn die Bereitstellung der Funktion abgeschlossen ist.
Sie können den Endpunkt der bereitgestellten Funktion auch in einem Browser aufrufen, um die Nachricht "Hello World!" anzusehen.
Bereinigen
Damit Ihrem Google Cloud-Konto die in dieser Anleitung verwendeten Ressourcen nicht in Rechnung gestellt werden, löschen Sie entweder das Projekt, das die Ressourcen enthält, oder Sie behalten das Projekt und löschen die einzelnen Ressourcen.
Projekt löschen
Am einfachsten vermeiden Sie weitere Kosten, wenn Sie das zum Ausführen der Anleitung erstellte Projekt löschen.
So löschen Sie das Projekt:
- Wechseln Sie in der Cloud Console zur Seite Ressourcen verwalten.
- Wählen Sie in der Projektliste das Projekt aus, das Sie löschen möchten, und klicken Sie dann auf Löschen.
- Geben Sie im Dialogfeld die Projekt-ID ein und klicken Sie auf Shut down (Beenden), um das Projekt zu löschen.
Cloud Functions-Funktion löschen
Durch das Löschen von Cloud Functions-Funktionen werden keine in Cloud Storage gespeicherten Ressourcen entfernt.
Führen Sie den folgenden Befehl aus, um die in dieser Anleitung erstellte Cloud Functions-Funktion zu löschen:
Node.js
gcloud functions delete helloGET
Python
gcloud functions delete hello_get
Go
gcloud functions delete HelloGet
Java
gcloud functions delete java-http-function
C#
gcloud functions delete csharp-http-function
Ruby
gcloud functions delete hello_get
PHP
gcloud functions delete helloGet
Sie können Cloud Functions-Funktionen auch über die Google Cloud Console löschen.