HTTP-Anleitung

In diesem Thema wird das Schreiben, Bereitstellen und Auslösen einer Cloud Functions-HTTP-Funktion veranschaulicht.

Ziele

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. Neuen Google Cloud-Nutzern steht möglicherweise eine kostenlose Testversion zur Verfügung.

Hinweis

  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.

    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. Installieren und initialisieren Sie Google Cloud CLI.

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

    Zur Projektauswahl

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

  8. Cloud Functions and Cloud Build APIs aktivieren.

    Aktivieren Sie die APIs

  9. Installieren und initialisieren Sie Google Cloud CLI.

    10. Wenn Sie die gcloud CLI bereits installiert haben, aktualisieren Sie sie mit dem folgenden Befehl:

    gcloud components update
  10. Bereiten Sie die Entwicklungsumgebung vor.

Anwendung vorbereiten

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

  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/

    PHP 

    cd php-docs-samples/functions/helloworld_get/

  3. Sehen Sie sich den Beispielcode an:

    Node.js

    functions/helloworld/index.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

    functions/helloworld/main.py 
    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 
    
// 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 
    
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 
    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 
    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 
    
use Psr\Http\Message\ServerRequestInterface;

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

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-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:
  • python310 (Vorschau)
  • 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-http-function \
--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-http-function \
--entry-point HelloWorld.Function \
--runtime dotnet3 --trigger-http --allow-unauthenticated

Ruby 

gcloud functions deploy hello_get --runtime ruby30 --trigger-http --allow-unauthenticated
Mit 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-unauthenticated
Mit 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:

  1. Wechseln Sie in der Cloud Console zur Seite Ressourcen verwalten.

    Zur Seite „Ressourcen verwalten“

  2. Wählen Sie in der Projektliste das Projekt aus, das Sie löschen möchten, und klicken Sie dann auf Löschen.
  3. 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.