Cloud Functions-Funktion (1st gen) mithilfe der Google Cloud CLI erstellen und bereitstellen

Kurzanleitung: Cloud Functions-Funktion (1st gen) mithilfe der Google Cloud CLI erstellen und bereitstellen

Cloud Functions-Funktion (1st gen) mithilfe der Google Cloud CLI erstellen und bereitstellen

Auf dieser Seite erfahren Sie, wie Sie eine Cloud Functions-Funktion der 1. Generation mit der Google Cloud CLI erstellen und bereitstellen. Informationen zu den ersten Schritten mit Cloud Functions (2. Generation) finden Sie in der Anleitung zu Cloud Functions-Funktionen (2. Generation).

Vorbereitung

1. 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.

2. Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

   Hinweis: Wenn Sie die Ressourcen, die Sie in diesem Verfahren erstellen, nicht behalten möchten, erstellen Sie ein Projekt, anstatt ein vorhandenes Projekt auszuwählen. Wenn Sie fertig sind, können Sie das Projekt löschen und dadurch alle mit dem Projekt verknüpften Ressourcen entfernen.

   Zur Projektauswahl

3. Die Abrechnung für das Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für ein Projekt aktiviert ist.

4. Cloud Functions and Cloud Build APIs aktivieren.

   Aktivieren Sie die APIs

5. Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

   Hinweis: Wenn Sie die Ressourcen, die Sie in diesem Verfahren erstellen, nicht behalten möchten, erstellen Sie ein Projekt, anstatt ein vorhandenes Projekt auszuwählen. Wenn Sie fertig sind, können Sie das Projekt löschen und dadurch alle mit dem Projekt verknüpften Ressourcen entfernen.

   Zur Projektauswahl

6. Die Abrechnung für das Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für ein Projekt aktiviert ist.

7. Cloud Functions and Cloud Build APIs aktivieren.

   Aktivieren Sie die APIs

8. Installieren und initialisieren Sie die gcloud CLI.
9. Aktualisieren Sie gcloud-Komponenten:

   gcloud components update

Benötigen Sie eine Eingabeaufforderung? Dazu steht die Google Cloud Shell zur Verfügung. Google Cloud Shell ist eine Befehlszeilenumgebung, in der die Google Cloud CLI bereits enthalten ist und daher nicht installiert werden muss. Die Google Cloud CLI ist außerdem auf den virtuellen Maschinen von Google Compute Engine vorinstalliert.

10. Bereiten Sie die Entwicklungsumgebung vor.

    Node.js

    Einrichtungsleitfaden für Node.js aufrufen

    Python

    Einrichtungsleitfaden für Python aufrufen

    Go

    Zum Einrichtungsleitfaden für Go

    Java

    Einrichtungsleitfaden für Java aufrufen

    C#

    Einrichtungsleitfaden für .NET aufrufen

    Ruby

    Einrichtungsleitfaden für Ruby aufrufen

    PHP

    PHP in Google Cloud verwenden

Beispielcode abrufen

1. Klonen Sie das Beispiel-Repository 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.

2. 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/get/

   PHP

   cd php-docs-samples/functions/helloworld_get/

3. Sehen Sie sich den Beispielcode an:

   Node.js

   functions/helloworld/index.js

   Auf GitHub ansehen Feedback

   const functions = require('@google-cloud/functions-framework');
   
   // Register an HTTP function with the Functions Framework that will be executed
   // when you make an HTTP request to the deployed function's endpoint.
   functions.http('helloGET', (req, res) => {
     res.send('Hello World!');
   });

   Python

   functions/helloworld/main.py

   Auf GitHub ansehen Feedback

   import functions_framework
   @functions_framework.http
   def hello_get(request):
       """HTTP Cloud Function.
       Args:
           request (flask.Request): The request object.
           <https://flask.palletsprojects.com/en/1.1.x/api/#incoming-request-data>
       Returns:
           The response text, or any set of values that can be turned into a
           Response object using `make_response`
           <https://flask.palletsprojects.com/en/1.1.x/api/#flask.make_response>.
       Note:
           For more information on how Flask integrates with Cloud
           Functions, see the `Writing HTTP functions` page.
           <https://cloud.google.com/functions/docs/writing/http#http_frameworks>
       """
       return 'Hello World!'

   Go

   functions/helloworld/hello_world.go

   Auf GitHub ansehen Feedback

   
   // Package helloworld provides a set of Cloud Functions samples.
   package helloworld
   
   import (
   	"fmt"
   	"net/http"
   )
   
   // HelloGet is an HTTP Cloud Function.
   func HelloGet(w http.ResponseWriter, r *http.Request) {
   	fmt.Fprint(w, "Hello, World!")
   }
   

   Java

   functions/helloworld/helloworld/src/main/java/functions/HelloWorld.java

   Auf GitHub ansehen Feedback

   
   package functions;
   
   import com.google.cloud.functions.HttpFunction;
   import com.google.cloud.functions.HttpRequest;
   import com.google.cloud.functions.HttpResponse;
   import java.io.BufferedWriter;
   import java.io.IOException;
   
   public class HelloWorld implements HttpFunction {
     // Simple function to return "Hello World"
     @Override
     public void service(HttpRequest request, HttpResponse response)
         throws IOException {
       BufferedWriter writer = response.getWriter();
       writer.write("Hello World!");
     }
   }

   C#

   functions/helloworld/HelloWorld/Function.cs

   Auf GitHub ansehen Feedback

   using Google.Cloud.Functions.Framework;
   using Microsoft.AspNetCore.Http;
   using System.Threading.Tasks;
   
   namespace HelloWorld
   {
       public class Function : IHttpFunction
       {
           public async Task HandleAsync(HttpContext context)
           {
               await context.Response.WriteAsync("Hello World!");
           }
       }
   }

   Ruby

   functions/helloworld/get/app.rb

   Auf GitHub ansehen Feedback

   require "functions_framework"
   
   FunctionsFramework.http "hello_get" do |_request|
     # The request parameter is a Rack::Request object.
     # See https://www.rubydoc.info/gems/rack/Rack/Request
   
     # Return the response body as a string.
     # You can also return a Rack::Response object, a Rack response array, or
     # a hash which will be JSON-encoded into a response.
     "Hello World!"
   end

   PHP

   functions/helloworld_get/index.php

   Auf GitHub ansehen Feedback

   
   use Psr\Http\Message\ServerRequestInterface;
   
   function helloGet(ServerRequestInterface $request): string
   {
       return 'Hello, World!' . PHP_EOL;
   }
   

Funktion bereitstellen

Zum Bereitstellen der Funktion mit einem HTTP-Trigger führen Sie den folgenden Befehl in dem Verzeichnis aus, in dem sich die Funktion befindet:

Node.js

gcloud functions deploy helloGET \
--runtime nodejs16 --trigger-http --allow-unauthenticated

Mit 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-unauthenticated

Mit den folgenden Werten für das Flag --runtime können Sie Ihre bevorzugte Version von Python festlegen:

• python39(empfohlen).
• python38
• python37

Go

gcloud functions deploy HelloGet \
--runtime go116 --trigger-http --allow-unauthenticated

Mit 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-helloworld \
--entry-point functions.HelloWorld \
--runtime java11 \
--memory 512MB --trigger-http --allow-unauthenticated

Mit 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-helloworld \
--entry-point HelloWorld.Function \
--runtime dotnet3 --trigger-http --allow-unauthenticated

Ruby

gcloud functions deploy hello_get --runtime ruby27 --trigger-http --allow-unauthenticated

Mit den folgenden Werten für das Flag --runtime können Sie Ihre bevorzugte Version von Ruby festlegen:

• ruby30 (Vorschau)
• ruby27(empfohlen).
• ruby26

PHP

gcloud functions deploy helloGet --runtime php74 --trigger-http --allow-unauthenticated

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 testen

1. Wenn die Bereitstellung der Funktion abgeschlossen ist, notieren Sie sich das Attribut url von httpsTrigger oder suchen es mit dem folgenden Befehl:

   Node.js

   gcloud functions describe helloGET

   Python

   gcloud functions describe hello_get

   Go

   gcloud functions describe HelloGet

   Java

   gcloud functions describe java-helloworld

   C#

   gcloud functions describe csharp-helloworld

   Ruby

   gcloud functions describe hello_get

   PHP

   gcloud functions describe helloGet

   Das sollte so aussehen:

   Node.js

   https://GCP_REGION-PROJECT_ID.cloudfunctions.net/helloGET

   Python

   https://GCP_REGION-PROJECT_ID.cloudfunctions.net/hello_get

   Go

   https://GCP_REGION-PROJECT_ID.cloudfunctions.net/HelloGet

   Java

   https://GCP_REGION-PROJECT_ID.cloudfunctions.net/java-helloworld

   C#

   https://GCP_REGION-PROJECT_ID.cloudfunctions.net/csharp-helloworld

   Ruby

   https://GCP_REGION-PROJECT_ID.cloudfunctions.net/hello_get

   PHP

   https://GCP_REGION-PROJECT_ID.cloudfunctions.net/helloGet

2. Rufen Sie diese URL in Ihrem Browser auf: Es sollte die Meldung Hello World! angezeigt werden.

Funktion löschen

Führen Sie den folgenden Befehl aus, um die 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-helloworld 

C#

gcloud functions delete csharp-helloworld 

Ruby

gcloud functions delete hello_get 

PHP

gcloud functions delete helloGet 

Nächste Schritte

• Mehr über das Schreiben von Cloud-Funktionen erfahren
• Weitere Informationen zum Bereitstellen von Cloud Functions
• Weitere Informationen zum Aufrufen von Cloud Functions
• Weitere Informationen zum Überwachen von Cloud Functions
• Weitere Informationen zum lokalen Ausführen von Cloud Functions
• Weiterführende Anleitungen für Cloud Functions