HTTP-Anleitung

In dieser einfachen Anleitung wird veranschaulicht, wie eine HTTP-Cloud Run-Funktion erstellt, bereitgestellt und ausgelöst wird.

Lernziele

Kosten

In diesem Dokument verwenden Sie die folgenden kostenpflichtigen Komponenten von Google Cloud:

  • Cloud Run 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.

Hinweise

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Cloud Functions and Cloud Build APIs.

    Enable the APIs

  5. Install the Google Cloud CLI.

  6. Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

  7. Führen Sie folgenden Befehl aus, um die gcloud CLI zu initialisieren: 

    gcloud init

  8. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  9. Verify that billing is enabled for your Google Cloud project.

  10. Enable the Cloud Functions and Cloud Build APIs.

    Enable the APIs

  11. Install the Google Cloud CLI.

  12. Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

  13. Führen Sie folgenden Befehl aus, um die gcloud CLI zu initialisieren: 

    gcloud init

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

    gcloud components update
  14. Bereiten Sie die Entwicklungsumgebung vor.

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

      Ruby 

      git clone https://github.com/GoogleCloudPlatform/ruby-docs-samples.git

      Sie können auch das Beispiel als ZIP-Datei herunterladen und extrahieren.

    2. Wechseln Sie in das Verzeichnis, das den Beispielcode für Cloud Run-Funktionen 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/

      Ruby 

      cd ruby-docs-samples/functions/helloworld/

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

      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!");
  }
}

      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

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

    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-http-function \
--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.

    Ruby 

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

    Verwenden Sie das Flag --runtime, um die Laufzeit-ID einer unterstützten Ruby-Version anzugeben, um 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 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"

    Ruby 

    curl "https://REGION-PROJECT_ID.cloudfunctions.net/hello_get"

    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. In the Google Cloud console, go to the Manage resources page.

      Go to Manage resources

    2. In the project list, select the project that you want to delete, and then click Delete.
    3. In the dialog, type the project ID, and then click Shut down to delete the project.

    Funktion löschen

    Durch das Löschen von Cloud Run-Funktionen werden keine in Cloud Storage gespeicherten Ressourcen entfernt.

    Führen Sie den folgenden Befehl aus, um die in dieser Anleitung erstellte Cloud Run-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

    Ruby 

    gcloud functions delete hello_get

    Sie können Cloud Run-Funktionen auch über die Google Cloud Console löschen.