Cloud Functions-Funktion der 1. Generation mithilfe der Google Cloud CLI erstellen

Cloud Functions-Funktion der 1. Generation mithilfe der Google Cloud CLI erstellen

Hinweis: Dieser Inhalt gilt nur für Cloud Functions (1. Generation). Weitere Informationen finden Sie unter Versionsvergleich von Cloud Functions.

Informationen zur Version des Dokuments für die zweite Generation finden Sie unter Cloud Functions-Funktion (2. Generation) 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.

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 Google Cloud-Projekt muss aktiviert sein.

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 Google Cloud-Projekt muss aktiviert sein.

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.

   Einfach loslegen (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/

   Einfach loslegen (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

   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

   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!"
   
   

   Einfach loslegen (Go)

   
   // 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

   
   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#

   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

   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

   
   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 nodejs20 --trigger-http

Verwenden Sie das Flag --runtime, um die Laufzeit-ID einer unterstützten Node.js-Version anzugeben und die Funktion auszuführen.

Python

gcloud functions deploy hello_get \
--runtime python312 --trigger-http

Verwenden Sie das Flag --runtime, um die Laufzeit-ID einer unterstützten Python-Version anzugeben und die Funktion auszuführen.

Einfach loslegen (Go)

gcloud functions deploy HelloGet \
--runtime go121 --trigger-http

Verwenden Sie das Flag --runtime, um die Laufzeit-ID einer unterstützten Go-Version anzugeben und die Funktion auszuführen.

Java

gcloud functions deploy java-helloworld \
--entry-point functions.HelloWorld \
--runtime java17 \
--memory 512MB --trigger-http

Verwenden Sie das Flag --runtime, um die Laufzeit-ID einer unterstützten Java-Version anzugeben und die Funktion auszuführen.

C#

gcloud functions deploy csharp-helloworld \
--entry-point HelloWorld.Function \
--runtime dotnet6 --trigger-http

Verwenden Sie das Flag --runtime, um die Laufzeit-ID einer unterstützten .NET-Version anzugeben, um Ihre Funktion auszuführen.

Ruby

gcloud functions deploy hello_get --runtime ruby32 --trigger-http

Verwenden Sie das Flag --runtime, um die Laufzeit-ID einer unterstützten Ruby-Version anzugeben, um die Funktion auszuführen.

PHP

 gcloud functions deploy helloGet --runtime php82 --trigger-http

Verwenden Sie das Flag --runtime, um die Laufzeit-ID einer unterstützten PHP-Version anzugeben und die Funktion auszuführen.

Optional können Sie das Flag --allow-unauthenticated verwenden, um die Funktion ohne Authentifizierung zu erreichen. Dies ist zum Testen hilfreich, aber wir empfehlen, diese Einstellung nicht in der Produktion zu verwenden, es sei denn, Sie erstellen eine öffentliche API oder Website. Abhängig von Ihren Unternehmensrichtlinieneinstellungen funktioniert es möglicherweise nicht für Sie. Weitere Informationen zum Aufrufen einer Funktion, die authentifiziert werden muss, finden Sie unter Für Aufruf authentifizieren.

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

   Einfach loslegen (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

   Einfach loslegen (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 

Einfach loslegen (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

In der entsprechenden Anleitung zu Ihre erste Funktion für die Laufzeit Ihrer Wahl erfahren Sie, wie Sie Ihre Entwicklungsumgebung einrichten, eine neue Funktion erstellen, Abhängigkeiten angeben, Ihre Funktion bereitstellen, die Funktion testen und Logs aufrufen: Beachten Sie, dass sich diese Leitfäden nur für Cloud Functions (1. Generation) beziehen:

• Die erste Funktion: Node.js
• Ihre erste Funktion: Python
• Ihre erste Funktion: Go
• Ihre erste Funktion: Java
• Ihre erste Funktion: .NET
• Ihre erste Funktion: Ruby
• Ihre erste Funktion: PHP