Funktionen erstellen

Für Cloud Functions erstellte Funktionen können mit den Buildpacks von Google Cloud erstellt werden.

Auf dieser Seite werden zwei Möglichkeiten zum Erstellen von Funktionen für die Bereitstellung in Cloud Run beschrieben:

• pack-Befehlszeile verwenden
• Cloud Build als Remote-Build-System verwenden

Funktionseinstiegspunkt

So erstellen Sie Funktionen mit Buildpacks:

• Fügen Sie die Bibliothek Functions Framework ein.

• Legen Sie die Umgebungsvariable GOOGLE_FUNCTION_TARGET auf den Namen der Funktion fest, die Sie als Einstiegspunkt verwenden. Dazu fügen Sie eine project.toml-Datei in denselben Ordner wie den Quellcode ein. Die Datei project.toml muss die folgende Konfiguration haben:

[[build.env]]
    name = "GOOGLE_FUNCTION_TARGET"
    value =  "ENTRY_POINT"

Ersetzen Sie ENTRY_POINT durch die Funktionsmethode.

Weitere Informationen zur Verwendung von Umgebungsvariablen mit Cloud Functions finden Sie unter Cloud Functions-Dienste konfigurieren.

Builders

Funktionen basieren auf Basis-Images, die unter den Buildpacks von Google Cloud verwaltet und veröffentlicht werden.

Builder sind Images, die aus Buildpacks und Betriebssystempaketen (auch als Stacks bezeichnet) bestehen. Mithilfe von Builders wird der Quellcode Ihrer Funktion in einen ausführbaren Container umgewandelt.

Sie können aus der Liste der unterstützten Buildpacks-Builders von Google Cloud auswählen.

Mit pack erstellen

Pack ist ein Befehlszeilentool, das vom CNB-Projekt verwaltet wird, um die Verwendung von Buildpacks zu unterstützen. Verwenden Sie die pack-Befehlszeile, um Ihre Funktionen lokal in einem Container-Image zu erstellen.

Hinweise

1. Installieren Sie die Docker Community Edition (CE) auf Ihrer Workstation. Docker wird von pack als OCI-Image-Builder verwendet.
2. Installieren Sie die Pack-Befehlszeile.
3. Installieren Sie das Tool Git Source Control, um die Beispielanwendung von GitHub herunterzuladen.

Funktion lokal erstellen

Verwenden Sie den pack build-Befehl und geben Sie den Standard-Builder --builder=gcr.io/buildpacks/builder an, um Ihre Container-Images lokal zu erstellen.

pack build --builder=gcr.io/buildpacks/builder IMAGE_NAME

Ersetzen Sie IMAGE_NAME durch den Namen Ihres Container-Images.

Sie können das Container-Image anpassen. Dazu erweitern Sie die Build- und Ausführungs-Images.

Beispielfunktion lokal erstellen

In den folgenden Beispielen wird gezeigt, wie ein Sample lokal erstellt wird.

1. Klonen Sie das Beispiel-Repository auf Ihren lokalen Computer:

   git clone https://github.com/GoogleCloudPlatform/buildpack-samples.git

2. Wechseln Sie in das Verzeichnis, das den Workflows-Beispielcode enthält:

   Go

   cd buildpack-samples/sample-functions-framework-go

   Java

   cd buildpack-samples/sample-functions-framework-java-mvn

   Node.js

   cd buildpack-samples/sample-functions-framework-node

   Python

   cd buildpack-samples/sample-functions-framework-python

   Ruby

   cd buildpack-samples/sample-functions-framework-ruby

3. Erstellen Sie die Beispielfunktion mit pack:

   Go

   pack build --builder=gcr.io/buildpacks/builder sample-functions-framework-go

   Java

   pack build --builder gcr.io/buildpacks/builder:v1 sample-functions-java-mvn

   Node.js

   pack build --builder=gcr.io/buildpacks/builder sample-functions-framework-node

   Python

   pack build --builder=gcr.io/buildpacks/builder sample-functions-framework-python

   Ruby

   pack build --builder=gcr.io/buildpacks/builder sample-functions-framework-ruby

4. Führen Sie das Image mit docker aus:

   Go

   docker run -p8080:8080 sample-functions-framework-go

   Java

   docker run -it -ePORT=8080 -p8080:8080 sample-functions-java-mvn

   Node.js

   docker run -it -ePORT=8080 -p8080:8080 sample-functions-framework-node

   Python

   docker run -it -ePORT=8080 -p8080:8080 sample-functions-framework-python

   Ruby

   docker run -it -ePORT=8080 -p8080:8080 sample-functions-framework-ruby

5. Um die ausgeführte Funktion auszuführen, rufen Sie localhost:8080 auf.

Mit einem Remote-Build-System erstellen

Verwenden Sie Cloud Build, um Ihre Funktion in einem Container-Image zu erstellen, und Artifact Registry als Container-Repository, um jedes Image zu speichern und bereitzustellen.

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.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Cloud Build and Artifact Registry APIs.

   Enable the APIs

5. Install the Google Cloud CLI.

6. To initialize the gcloud CLI, run the following command:

   gcloud init

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

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

8. Make sure that billing is enabled for your Google Cloud project.

9. Enable the Cloud Build and Artifact Registry APIs.

   Enable the APIs

10. Install the Google Cloud CLI.

11. To initialize the gcloud CLI, run the following command:

    gcloud init

Wenn Sie die Google Cloud CLI bereits installiert haben, prüfen Sie, ob Sie die neueste verfügbare Version nutzen. Führen Sie dazu gcloud components update aus.

12. Ihr Google Cloud-Projekt muss Zugriff auf ein Container-Image-Repository haben.

    So konfigurieren Sie den Zugriff auf ein Docker-Repository in Artifact Registry:

    1. Erstellen Sie ein neues Docker-Repository an dem Speicherort, an dem sich auch Ihr Google Cloud-Projekt befindet.

       gcloud artifacts repositories create REPO_NAME \
       --repository-format=docker \
       --location=REGION --description="DESCRIPTION"
       

       Ersetzen Sie::
       • REPO_NAME durch den Namen, den Sie für Ihr Docker-Repository wählen.
       • REGION durch einen Standort direkt im oder maximal nahe am Google Cloud-Projekt.
       • DESCRIPTION mit einer Beschreibung Ihrer Wahl.

       Beispiel: Um ein docker-Repository in us-west2 mit der Beschreibung "Docker repository" zu erstellen, führen Sie folgenden Befehl aus:

       gcloud artifacts repositories create buildpacks-docker-repo --repository-format=docker \
       --location=us-west2 --description="Docker repository"
       

    2. Prüfen Sie, ob das Repository erstellt wurde:

       gcloud artifacts repositories list
       

       Der Name, den Sie für Ihr Docker-Repository wählen, sollte in der Liste angezeigt werden.

Funktion per Remote-Zugriff erstellen

Mit dem gcloud builds submit-Befehl können Sie Ihr Container-Image erstellen und in Ihr Repository hochladen.

Sie können das Container-Image im Befehl selbst angeben oder eine Konfigurationsdatei verwenden.

Build mit Befehl

Für die Erstellung ohne Konfigurationsdatei geben Sie das image-Flag an:

gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/IMAGE_NAME

Ersetzen Sie:

• LOCATION durch den Namen der Region Ihres Container-Repositorys, z. B. us-west2
• Ersetzen Sie PROJECT_ID durch die ID Ihres Google Cloud-Projekts.
• REPO_NAME durch den Namen des Docker-Repositorys.
• IMAGE_NAME durch den Namen Ihres Container-Images

Beispiel:

gcloud builds submit --pack image=us-west2-docker.pkg.dev/my-project-id/my-buildpacks-docker-repo

Build mit Konfigurationsdateien erstellen

Sie können eine Konfigurationsdatei verwenden, um die Details der Image-Repository-Konfiguration zu definieren und den Build-Befehl zu vereinfachen. Die Konfigurationsdatei verwendet das YAML-Dateiformat und muss einen Build-Schritt enthalten, der die pack-Befehlszeile verwendet.

1. Erstellen Sie eine YAML-Datei mit dem Namen cloudbuild.yaml, die den URI Ihres Container-Image-Repositorys enthält.

   options:
     logging: CLOUD_LOGGING_ONLY
     pool: {}
   projectId: PROJECT_ID
   steps:
   - name: gcr.io/k8s-skaffold/pack
     entrypoint: pack
     args:
     - build
     - LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/IMAGE_NAME
     - --builder
     - gcr.io/buildpacks/builder:latest
     - --network
     - cloudbuild
   

   Ersetzen Sie:

   • LOCATION durch den Namen der Region Ihres Container-Repositorys. Beispiel:us-west2
   • Ersetzen Sie PROJECT_ID durch die ID Ihres Google Cloud-Projekts.
   • REPO_NAME durch den Namen des Docker-Repositorys.
   • IMAGE_NAME durch den Namen Ihres Container-Images

2. Erstellen Sie die Anwendung.

   Wenn Sie Ihre Konfigurationsdatei cloudbuild.yaml genannt haben, können Sie folgenden Befehl ausführen:

   gcloud builds submit .
   

   Tipp: Wenn Sie für die Konfigurationsdatei einen eindeutigen Namen verwenden, können Sie das Flag --config verwenden.

Beispiel: Beispielfunktion remote erstellen

In folgenden Beispielen wird gezeigt, wie Sie ein Beispiel für einen Remote-Build erstellen und dann prüfen, ob das Container-Image per Push in Ihr Repository in Artifact Registry übertragen wurde.

1. Klonen Sie das Beispiel-Repository auf Ihren lokalen Computer:

   git clone https://github.com/GoogleCloudPlatform/buildpack-samples.git

2. Wechseln Sie in das Verzeichnis, das den Workflows-Beispielcode enthält:

   Go

   cd buildpack-samples/sample-functions-framework-go

   Java

   cd buildpack-samples/sample-functions-framework-java-mvn

   Node.js

   cd buildpack-samples/sample-functions-framework-node

   Python

   cd buildpack-samples/sample-functions-framework-python

   Ruby

   cd buildpack-samples/sample-functions-framework-ruby

3. Verwenden Sie gcloud, um den Quellcode der Anwendung an Cloud Build zu senden:

   Go

   gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-functions-framework-go

   Java

   gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-functions-framework-gradle

   Node.js

   gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-functions-framework-node

   Python

   gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-functions-framework-python

   Ruby

   gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-functions-framework-ruby

   Ersetzen Sie:

   • LOCATION durch den Namen der Region Ihres Container-Repositorys. Beispiel: us-west2-docker.pkg.dev
   • Ersetzen Sie PROJECT_ID durch die ID Ihres Google Cloud-Projekts.
   • REPO_NAME durch den Namen des Docker-Repositorys.

4. Prüfen Sie, ob die Beispielfunktion erfolgreich in REPO_NAME veröffentlicht wurde:

   gcloud artifacts docker images list LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME

   Ersetzen Sie:

   • LOCATION durch den Namen der Region Ihres Container-Repositorys, z. B. us-west2.
   • Ersetzen Sie PROJECT_ID durch die ID Ihres Google Cloud-Projekts.
   • REPO_NAME durch den Namen des Docker-Repositorys.

Nächste Schritte

• Nachdem der Container erstellt wurde, können Sie ihn lokal testen, bevor Sie ihn in Cloud Run bereitstellen. Weitere Informationen finden Sie unter Cloud Run-Dienst lokal testen.
• Weitere Informationen zu den wichtigsten Anforderungen und Verhaltensweisen von Containern in Cloud Run finden Sie im Containervertrag.
• Unter Dienste bereitstellen wird erklärt, wie Sie Container in Cloud Run bereitstellen.
• Durch die Einrichtung einer kontinuierlichen Bereitstellung und die Verwendung von Cloud-Build-Triggern können Sie die Build-Erstellung und die Bereitstellung von Cloud Run-Diensten automatisieren.
• Informationen zum Durchführen optimaler Container-Builds für Java-Anwendungen finden Sie unter Java-Container mit Jib erstellen.