Cloud Storage-Anleitung

Diese einfache Anleitung zeigt das Schreiben, Bereitstellen und Auslösen einer Cloud Functions-Hintergrundfunktion mit einem Cloud Storage-Trigger.

Ziele

Kosten

In dieser Anleitung werden kostenpflichtige Komponenten der Cloud Platform verwendet, darunter:

  • Google Cloud Functions
  • Google Cloud Storage

Mit unserem Preisrechner können Sie eine Kostenschätzung für Ihre voraussichtliche Nutzung erstellen.

Neuen Cloud Platform-Nutzern steht gegebenenfalls eine kostenlose Testversion zur Verfügung.

Vorbereitung

  1. Melden Sie sich in Ihrem Google-Konto an.

    Wenn Sie noch kein Konto haben, registrieren Sie sich hier für ein neues Konto.

  2. Wählen Sie in der GCP Console auf der Projektauswahlseite ein GCP-Projekt aus oder erstellen Sie eins.

    Zur Projektauswahl

  3. Prüfen Sie, ob die Abrechnung für Ihr Google Cloud Platform-Projekt aktiviert ist. So bestätigen Sie die Abrechnung für Ihr Projekt.

  4. Aktivieren Sie die Cloud Functions and Cloud Storageerforderlichen APIs.

    APIs aktivieren

  5. Installieren und initialisieren Sie das Cloud SDK.
  6. Aktualisieren Sie alle gcloud-Komponenten:
    gcloud components update
  7. Bereiten Sie Ihre Entwicklungsumgebung vor:

Anwendung vorbereiten

  1. Erstellen Sie einen Cloud Storage-Bucket zum Hochladen einer Testdatei. Dabei sollte YOUR_TRIGGER_BUCKET_NAME ein Bucket-Name sein, der global nur einmal vorkommt:

    gsutil mb gs://YOUR_TRIGGER_BUCKET_NAME
    
  2. Klonen Sie das Repository der Beispielanwendung 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.

  3. 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/gcs/

    Go

    cd golang-samples/functions/helloworld/storage_generic/

Funktion bereitstellen und auslösen

Derzeit liegen Cloud Storage-Funktionen Pub/Sub-Benachrichtigungen von Cloud Storage zugrunde und sie unterstützen ähnliche Ereignistypen:

In den folgenden Abschnitten wird gezeigt, wie Sie für jeden dieser Ereignistypen eine Funktion bereitstellen und auslösen.

Objekt finalisieren: Ereignisse vom Typ "Object Finalize"

Object-Finalize-Ereignisse werden ausgelöst, wenn der "Schreibvorgang" eines Cloud Storage-Objekts erfolgreich abgeschlossen wurde. Dieses Ereignis wird also ausgelöst, wenn ein neues Objekt erstellt oder ein vorhandenes Objekt überschrieben wird. Archive- und Metadata-Update-Vorgänge werden von diesem Trigger ignoriert.

Objekt finalisieren: Funktion bereitstellen

Im Folgenden wird eine Beispielfunktion zur Verarbeitung von Cloud Storage-Ereignissen dargestellt:

Node.js

/**
 * Generic background Cloud Function to be triggered by Cloud Storage.
 *
 * @param {object} event The Cloud Functions event.
 * @param {function} callback The callback function.
 */
exports.helloGCSGeneric = (data, context, callback) => {
  const file = data;

  console.log(`  Event: ${context.eventId}`);
  console.log(`  Event Type: ${context.eventType}`);
  console.log(`  Bucket: ${file.bucket}`);
  console.log(`  File: ${file.name}`);
  console.log(`  Metageneration: ${file.metageneration}`);
  console.log(`  Created: ${file.timeCreated}`);
  console.log(`  Updated: ${file.updated}`);

  callback();
};

Python

def hello_gcs_generic(data, context):
    """Background Cloud Function to be triggered by Cloud Storage.
       This generic function logs relevant data when a file is changed.

    Args:
        data (dict): The Cloud Functions event payload.
        context (google.cloud.functions.Context): Metadata of triggering event.
    Returns:
        None; the output is written to Stackdriver Logging
    """

    print('Event ID: {}'.format(context.event_id))
    print('Event type: {}'.format(context.event_type))
    print('Bucket: {}'.format(data['bucket']))
    print('File: {}'.format(data['name']))
    print('Metageneration: {}'.format(data['metageneration']))
    print('Created: {}'.format(data['timeCreated']))
    print('Updated: {}'.format(data['updated']))

Go


// Package helloworld provides a set of Cloud Functions samples.
package helloworld

import (
	"context"
	"fmt"
	"log"
	"time"

	"cloud.google.com/go/functions/metadata"
)

// GCSEvent is the payload of a GCS event.
type GCSEvent struct {
	Bucket         string    `json:"bucket"`
	Name           string    `json:"name"`
	Metageneration string    `json:"metageneration"`
	ResourceState  string    `json:"resourceState"`
	TimeCreated    time.Time `json:"timeCreated"`
	Updated        time.Time `json:"updated"`
}

// HelloGCSInfo prints information about a GCS event.
func HelloGCSInfo(ctx context.Context, e GCSEvent) error {
	meta, err := metadata.FromContext(ctx)
	if err != nil {
		return fmt.Errorf("metadata.FromContext: %v", err)
	}
	log.Printf("Event ID: %v\n", meta.EventID)
	log.Printf("Event type: %v\n", meta.EventType)
	log.Printf("Bucket: %v\n", e.Bucket)
	log.Printf("File: %v\n", e.Name)
	log.Printf("Metageneration: %v\n", e.Metageneration)
	log.Printf("Created: %v\n", e.TimeCreated)
	log.Printf("Updated: %v\n", e.Updated)
	return nil
}

Zur Bereitstellung der Funktion führen Sie den folgenden Befehl in dem Verzeichnis aus, in dem sich der Beispielcode befindet:

Node.js

gcloud functions deploy helloGCSGeneric --runtime nodejs8 --trigger-resource YOUR_TRIGGER_BUCKET_NAME --trigger-event google.storage.object.finalize
Die folgenden Werte für das Flag --runtime können für die jeweilige Node.js-Version verwendet werden:
  • nodejs6 (verworfen)
  • nodejs8
  • nodejs10 (Beta)

Python

gcloud functions deploy hello_gcs_generic --runtime python37 --trigger-resource YOUR_TRIGGER_BUCKET_NAME --trigger-event google.storage.object.finalize

Go

gcloud functions deploy HelloGCSInfo --runtime go111 --trigger-resource YOUR_TRIGGER_BUCKET_NAME --trigger-event google.storage.object.finalize

Dabei ist YOUR_TRIGGER_BUCKET_NAME der Name des Cloud Storage-Buckets, der die Funktion auslöst.

Objekt finalisieren: Funktion auslösen

So lösen Sie die Funktion aus:

  1. Erstellen Sie eine leere Datei gcf-test.txt in dem Verzeichnis, in dem sich der Beispielcode befindet.

  2. Laden Sie die Datei in Cloud Storage hoch, um die Funktion auszulösen:

    gsutil cp gcf-test.txt gs://YOUR_TRIGGER_BUCKET_NAME
    

    Dabei ist YOUR_TRIGGER_BUCKET_NAME der Name des Cloud Storage-Buckets, in den die Testdatei hochgeladen werden soll.

  3. Prüfen Sie anhand der Logs, ob die Vorgänge abgeschlossen wurden:

    gcloud functions logs read --limit 50
    

Objekt löschen: Ereignisse vom Typ "Object Delete"

Object-Delete-Ereignisse sind besonders hilfreich für Buckets ohne Versionsverwaltung. Sie werden ausgelöst, wenn eine alte Version eines Objekts gelöscht wird. Außerdem werden sie ausgelöst, wenn ein Objekt überschrieben wird. Object-Delete-Trigger können auch mit Buckets mit Versionsverwaltung verwendet werden. Sie werden ausgelöst, wenn eine Version eines Objekts endgültig gelöscht wird.

Objekt löschen: Funktion bereitstellen

Verwenden Sie denselben Beispielcode wie im Finalize-Beispiel, um die Funktion mit dem Triggerereignis "Object Delete" bereitzustellen. Führen Sie den folgenden Befehl in dem Verzeichnis aus, in dem sich der Beispielcode befindet:

Node.js

gcloud functions deploy helloGCSGeneric --runtime nodejs8 --trigger-resource YOUR_TRIGGER_BUCKET_NAME --trigger-event google.storage.object.delete
Die folgenden Werte für das Flag --runtime können für die jeweilige Node.js-Version verwendet werden:
  • nodejs6 (verworfen)
  • nodejs8
  • nodejs10 (Beta)

Python

gcloud functions deploy hello_gcs_generic --runtime python37 --trigger-resource YOUR_TRIGGER_BUCKET_NAME --trigger-event google.storage.object.delete

Go

gcloud functions deploy HelloGCSInfo --runtime go111 --trigger-resource YOUR_TRIGGER_BUCKET_NAME --trigger-event google.storage.object.delete

Dabei ist YOUR_TRIGGER_BUCKET_NAME der Name des Cloud Storage-Buckets, der die Funktion auslöst.

Objekt löschen: Funktion auslösen

So lösen Sie die Funktion aus:

  1. Erstellen Sie eine leere Datei gcf-test.txt in dem Verzeichnis, in dem sich der Beispielcode befindet.

  2. Prüfen Sie, ob die Versionsverwaltung des Buckets deaktiviert ist:

    gsutil versioning set off gs://YOUR_TRIGGER_BUCKET_NAME
    
  3. Laden Sie die Datei in Cloud Storage hoch:

    gsutil cp gcf-test.txt gs://YOUR_TRIGGER_BUCKET_NAME
    

    Dabei ist YOUR_TRIGGER_BUCKET_NAME der Name des Cloud Storage-Buckets, in den die Testdatei hochgeladen werden soll. An diesem Punkt sollte die Funktion noch nicht ausgeführt werden.

  4. Löschen Sie die Datei, um die Funktion auszulösen:

    gsutil rm gs://YOUR_TRIGGER_BUCKET_NAME/gcf-test.txt
    
  5. Prüfen Sie anhand der Logs, ob die Vorgänge abgeschlossen wurden:

    gcloud functions logs read --limit 50
    

Die Ausführung der Funktion kann einige Zeit in Anspruch nehmen.

Objekt archivieren: Ereignisse vom Typ "Object Archive"

Object-Archive-Ereignisse können nur mit Buckets mit Versionsverwaltung verwendet werden. Sie werden ausgelöst, wenn eine alte Version eines Objekts archiviert wird. Ein Archive-Ereignis wird also ausgelöst, wenn ein Objekt überschrieben oder gelöscht wird.

Objekt archivieren: Funktion bereitstellen

Verwenden Sie denselben Beispielcode wie im Finalize-Beispiel, um die Funktion mit dem Triggerereignis "Object Archive" bereitzustellen. Führen Sie den folgenden Befehl in dem Verzeichnis aus, in dem sich der Beispielcode befindet:

Node.js

gcloud functions deploy helloGCSGeneric --runtime nodejs8 --trigger-resource YOUR_TRIGGER_BUCKET_NAME --trigger-event google.storage.object.archive
Die folgenden Werte für das Flag --runtime können für die jeweilige Node.js-Version verwendet werden:
  • nodejs6 (verworfen)
  • nodejs8
  • nodejs10 (Beta)

Python

gcloud functions deploy hello_gcs_generic --runtime python37 --trigger-resource YOUR_TRIGGER_BUCKET_NAME --trigger-event google.storage.object.archive

Go

gcloud functions deploy HelloGCSInfo --runtime go111 --trigger-resource YOUR_TRIGGER_BUCKET_NAME --trigger-event google.storage.object.archive

Dabei ist YOUR_TRIGGER_BUCKET_NAME der Name des Cloud Storage-Buckets, der die Funktion auslöst.

Objekt archivieren: Funktion auslösen

So lösen Sie die Funktion aus:

  1. Erstellen Sie eine leere Datei gcf-test.txt in dem Verzeichnis, in dem sich der Beispielcode befindet.

  2. Prüfen Sie, ob die Versionsverwaltung des Buckets aktiviert ist:

    gsutil versioning set on gs://YOUR_TRIGGER_BUCKET_NAME
    
  3. Laden Sie die Datei in Cloud Storage hoch:

    gsutil cp gcf-test.txt gs://YOUR_TRIGGER_BUCKET_NAME
    

    Dabei ist YOUR_TRIGGER_BUCKET_NAME der Name des Cloud Storage-Buckets, in den die Testdatei hochgeladen werden soll. An diesem Punkt sollte die Funktion noch nicht ausgeführt werden.

  4. Archivieren Sie die Datei, um die Funktion auszulösen:

    gsutil rm gs://YOUR_TRIGGER_BUCKET_NAME/gcf-test.txt
    
  5. Prüfen Sie anhand der Logs, ob die Vorgänge abgeschlossen wurden:

    gcloud functions logs read --limit 50
    

Objektmetadaten aktualisieren: Ereignisse vom Typ "Object Metadata Update"

Object-Metadata-Update-Ereignisse werden ausgelöst, wenn die Metadaten vorhandener Objekte aktualisiert werden.

Objektmetadaten aktualisieren: Funktion bereitstellen

Verwenden Sie denselben Beispielcode wie im Finalize-Beispiel, um die Funktion mit dem Triggerereignis "Metadata Update" bereitzustellen. Führen Sie den folgenden Befehl in dem Verzeichnis aus, in dem sich der Beispielcode befindet:

Node.js

gcloud functions deploy helloGCSGeneric --runtime nodejs8 --trigger-resource YOUR_TRIGGER_BUCKET_NAME --trigger-event google.storage.object.metadataUpdate
Die folgenden Werte für das Flag --runtime können für die jeweilige Node.js-Version verwendet werden:
  • nodejs6 (verworfen)
  • nodejs8
  • nodejs10 (Beta)

Python

gcloud functions deploy hello_gcs_generic --runtime python37 --trigger-resource YOUR_TRIGGER_BUCKET_NAME --trigger-event google.storage.object.metadataUpdate

Go

gcloud functions deploy HelloGCSInfo --runtime go111 --trigger-resource YOUR_TRIGGER_BUCKET_NAME --trigger-event google.storage.object.metadataUpdate

Dabei ist YOUR_TRIGGER_BUCKET_NAME der Name des Cloud Storage-Buckets, der die Funktion auslöst.

Objektmetadaten aktualisieren: Funktion auslösen

So lösen Sie die Funktion aus:

  1. Erstellen Sie eine leere Datei gcf-test.txt in dem Verzeichnis, in dem sich der Beispielcode befindet.

  2. Prüfen Sie, ob die Versionsverwaltung des Buckets deaktiviert ist:

    gsutil versioning set off gs://YOUR_TRIGGER_BUCKET_NAME
    
  3. Laden Sie die Datei in Cloud Storage hoch:

    gsutil cp gcf-test.txt gs://YOUR_TRIGGER_BUCKET_NAME
    

    Dabei ist YOUR_TRIGGER_BUCKET_NAME der Name des Cloud Storage-Buckets, in den die Testdatei hochgeladen werden soll. An diesem Punkt sollte die Funktion noch nicht ausgeführt werden.

  4. Aktualisieren Sie die Metadaten der Datei:

    gsutil -m setmeta -h "Content-Type:text/plain" gs://YOUR_TRIGGER_BUCKET_NAME/gcf-test.txt
    
  5. Prüfen Sie anhand der Logs, ob die Vorgänge abgeschlossen wurden:

    gcloud functions logs read --limit 50
    

Bereinigen

So vermeiden Sie, dass Ihrem Google Cloud Platform-Konto die in dieser Anleitung verwendeten Ressourcen in Rechnung gestellt werden:

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. Rufen Sie in der GCP Console die Seite Ressourcen verwalten auf.

    Zur Seite "Ressourcen verwalten"

  2. Wählen Sie in der Projektliste das Projekt aus, das Sie löschen möchten, und klicken Sie auf Löschen .
  3. Geben Sie im Dialogfeld die Projekt-ID ein und klicken Sie auf 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 helloGCSGeneric 

Python

gcloud functions delete hello_gcs_generic 

Go

gcloud functions delete HelloGCSInfo 

Sie können Cloud Functions-Funktionen auch aus der Google Cloud Console löschen.

Hat Ihnen diese Seite weitergeholfen? Teilen Sie uns Ihr Feedback mit:

Feedback geben zu...

Cloud Functions-Dokumentation