Tutorial su Cloud Storage (2ª generazione)

---

Nota: Questi contenuti si applicano solo a Cloud Functions (2nd gen). Consulta Cloud Functions confronto tra versioni per ulteriori informazioni.

Per la versione 1ª generazione. di questo documento, consulta Tutorial su Cloud Storage (1ª generazione).

Questo semplice tutorial illustra la scrittura, il deployment e l'attivazione di una funzione Cloud Functions Functions basata su eventi con un trigger di Cloud Storage per rispondere agli eventi di Cloud Storage.

Nota: gli eventi vengono inviati utilizzando le notifiche Pub/Sub da Cloud Storage. Un bucket può avere fino a 10 notifiche configurazioni impostate per attivare un evento specifico. Configurazione eccessiva è possibile che le notifiche per lo stesso bucket superino il limite di notifiche per bucket e rendere impossibile creare una funzione, come indicato dall'errore Cloud Storage bucket ...: Pub/Sub notification limit reached. Se raggiungi il limite, non potrai creare una funzione finché non intervieni su un'azione correttiva, ad esempio rimuovendo le notifiche.

Visita il browser di esempio Google Cloud esempi di codice per l'utilizzo di Cloud Storage.

Obiettivi

• Scrivi ed esegui il deployment di una funzione Cloud Functions basata su eventi.
• Attiva la funzione caricando un file in Cloud Storage.

Costi

In questo documento vengono utilizzati i seguenti componenti fatturabili di Google Cloud:

• Cloud Functions
• Cloud Build
• Pub/Sub
• Cloud Storage
• Artifact Registry
• Eventarc
• Cloud Logging

For details, see Cloud Functions pricing.

Per generare una stima dei costi basata sull'utilizzo previsto, utilizza il Calcolatore prezzi. I nuovi utenti di Google Cloud potrebbero essere idonei per una prova gratuita.

---

Per seguire una guida passo passo per questa attività direttamente nel Editor di Cloud Shell, fai clic su Procedura guidata:

Procedura guidata

---

Prima di iniziare

1. Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

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. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

4. Abilita le API Cloud Functions, Cloud Build, Artifact Registry, Eventarc, Logging, and Pub/Sub.

   Abilita le API

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. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

9. Abilita le API Cloud Functions, Cloud Build, Artifact Registry, Eventarc, Logging, and Pub/Sub.

   Abilita le API

10. Install the Google Cloud CLI.

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

    gcloud init

Se hai già installato gcloud CLI, aggiornalo eseguendo il seguente comando:

gcloud components update

Nota: assicurati che la chiave dell'account di servizio di runtime che stai utilizzando per il tuo Credenziali predefinite dell'applicazione ha il ruolo cloudfunctions.serviceAgent o storage.buckets.{get, update} e Autorizzazioni resourcemanager.projects.get. Per ulteriori informazioni sull'impostazione di queste autorizzazioni, consulta Concedi, la modifica e la revoca dell'accesso alle risorse.
12. Prepara l'ambiente di sviluppo:

    Node.js

    Vai alla guida alla configurazione di Node.js

    Python

    Vai alla guida alla configurazione di Python

    Vai

    Vai alla guida alla configurazione di Go

    Java

    Vai alla guida alla configurazione di Java

    C#

    Vai alla guida alla configurazione di .NET

    Ruby

    Vai alla guida alla configurazione di Ruby

    PHP

    Vai a Utilizzo di PHP su Google Cloud

Prerequisiti

1. Crea un bucket a livello di regione in cui YOUR_BUCKET_NAME è un nome di bucket univoco a livello globale, mentre REGION è regione in cui prevedi di eseguire il deployment della funzione:

   gcloud storage buckets create gs://YOUR_BUCKET_NAME --location=REGION
   

2. Per utilizzare le funzioni di Cloud Storage, concedi il ruolo pubsub.publisher alla Account di servizio Cloud Storage:

   PROJECT_ID=$(gcloud config get-value project)
   PROJECT_NUMBER=$(gcloud projects list --filter="project_id:$PROJECT_ID" --format='value(project_number)')
   
   SERVICE_ACCOUNT=$(gcloud storage service-agent --project=$PROJECT_NUMBER)
   
   gcloud projects add-iam-policy-binding $PROJECT_ID \
     --member serviceAccount:$SERVICE_ACCOUNT \
     --role roles/pubsub.publisher
   

prepara l'applicazione

1. Clona il repository dell'app di esempio nella tua macchina locale:

   Node.js

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

   In alternativa, puoi scarica l'esempio come file ZIP ed estrarlo.

   Python

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

   In alternativa, puoi scarica l'esempio come file ZIP ed estrarlo.

   Vai

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

   In alternativa, puoi scarica l'esempio come file ZIP ed estrarlo.

   Java

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

   In alternativa, puoi scarica l'esempio come file ZIP ed estrarlo.

   C#

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

   In alternativa, puoi scarica l'esempio come file ZIP ed estrarlo.

   Ruby

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

   In alternativa, puoi scarica l'esempio come file ZIP ed estrarlo.

   PHP

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

   In alternativa, puoi scarica l'esempio come file ZIP ed estrarlo.

2. Passa alla directory che contiene il codice campione di Cloud Functions:

   Node.js

   cd nodejs-docs-samples/functions/v2/helloGCS/

   Python

   cd python-docs-samples/functions/v2/storage/

   Vai

   cd golang-samples/functions/functionsv2/hellostorage/

   Java

   cd java-docs-samples/functions/v2/hello-gcs/

   C#

   cd dotnet-docs-samples/functions/helloworld/HelloGcs/

   Ruby

   cd ruby-docs-samples/functions/helloworld/storage/

   PHP

   cd php-docs-samples/functions/helloworld_storage/

Esegui il deployment della funzione e attivala

Le funzioni di Cloud Storage si basano Notifiche Pub/Sub da Cloud Storage e supportano tipi di eventi simili:

• finalizzare

• elimina

• archivio

• aggiornamento dei metadati

Le sezioni seguenti descrivono come eseguire il deployment e attivare una funzione per ciascuno di questi tipi di eventi.

Finalizzazione oggetto

Gli eventi di finalizzazione degli oggetti vengono attivati quando viene eseguito un di Oggetto Cloud Storage è finalizzato correttamente. Nello specifico, ciò significa che la creazione di un nuovo oggetto la sovrascrittura di un oggetto esistente attiva questo evento. Archivio e metadati le operazioni di aggiornamento vengono ignorate da questo attivatore.

Finalizzazione oggetto: deployment della funzione

Dai un'occhiata alla funzione di esempio che gestisce gli eventi di Cloud Storage:

Node.js

const functions = require('@google-cloud/functions-framework');

// Register a CloudEvent callback with the Functions Framework that will
// be triggered by Cloud Storage.
functions.cloudEvent('helloGCS', cloudEvent => {
  console.log(`Event ID: ${cloudEvent.id}`);
  console.log(`Event Type: ${cloudEvent.type}`);

  const file = cloudEvent.data;
  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}`);
});

Python

from cloudevents.http import CloudEvent

import functions_framework


# Triggered by a change in a storage bucket
@functions_framework.cloud_event
def hello_gcs(cloud_event: CloudEvent) -> tuple:
    """This function is triggered by a change in a storage bucket.

    Args:
        cloud_event: The CloudEvent that triggered this function.
    Returns:
        The event ID, event type, bucket, name, metageneration, and timeCreated.
    """
    data = cloud_event.data

    event_id = cloud_event["id"]
    event_type = cloud_event["type"]

    bucket = data["bucket"]
    name = data["name"]
    metageneration = data["metageneration"]
    timeCreated = data["timeCreated"]
    updated = data["updated"]

    print(f"Event ID: {event_id}")
    print(f"Event type: {event_type}")
    print(f"Bucket: {bucket}")
    print(f"File: {name}")
    print(f"Metageneration: {metageneration}")
    print(f"Created: {timeCreated}")
    print(f"Updated: {updated}")

    return event_id, event_type, bucket, name, metageneration, timeCreated, updated

Vai

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

import (
	"context"
	"fmt"
	"log"

	"github.com/GoogleCloudPlatform/functions-framework-go/functions"
	"github.com/cloudevents/sdk-go/v2/event"
	"github.com/googleapis/google-cloudevents-go/cloud/storagedata"
	"google.golang.org/protobuf/encoding/protojson"
)

func init() {
	functions.CloudEvent("HelloStorage", helloStorage)
}

// helloStorage consumes a CloudEvent message and logs details about the changed object.
func helloStorage(ctx context.Context, e event.Event) error {
	log.Printf("Event ID: %s", e.ID())
	log.Printf("Event Type: %s", e.Type())

	var data storagedata.StorageObjectData
	if err := protojson.Unmarshal(e.Data(), &data); err != nil {
		return fmt.Errorf("protojson.Unmarshal: %w", err)
	}

	log.Printf("Bucket: %s", data.GetBucket())
	log.Printf("File: %s", data.GetName())
	log.Printf("Metageneration: %d", data.GetMetageneration())
	log.Printf("Created: %s", data.GetTimeCreated().AsTime())
	log.Printf("Updated: %s", data.GetUpdated().AsTime())
	return nil
}

Java

import com.google.cloud.functions.CloudEventsFunction;
import com.google.events.cloud.storage.v1.StorageObjectData;
import com.google.protobuf.InvalidProtocolBufferException;
import com.google.protobuf.util.JsonFormat;
import io.cloudevents.CloudEvent;
import java.nio.charset.StandardCharsets;
import java.util.logging.Logger;

public class HelloGcs implements CloudEventsFunction {
  private static final Logger logger = Logger.getLogger(HelloGcs.class.getName());

  @Override
  public void accept(CloudEvent event) throws InvalidProtocolBufferException {
    logger.info("Event: " + event.getId());
    logger.info("Event Type: " + event.getType());

    if (event.getData() == null) {
      logger.warning("No data found in cloud event payload!");
      return;
    }

    String cloudEventData = new String(event.getData().toBytes(), StandardCharsets.UTF_8);
    StorageObjectData.Builder builder = StorageObjectData.newBuilder();
    JsonFormat.parser().merge(cloudEventData, builder);
    StorageObjectData data = builder.build();

    logger.info("Bucket: " + data.getBucket());
    logger.info("File: " + data.getName());
    logger.info("Metageneration: " + data.getMetageneration());
    logger.info("Created: " + data.getTimeCreated());
    logger.info("Updated: " + data.getUpdated());
  }
}

C#

using CloudNative.CloudEvents;
using Google.Cloud.Functions.Framework;
using Google.Events.Protobuf.Cloud.Storage.V1;
using Microsoft.Extensions.Logging;
using System.Threading;
using System.Threading.Tasks;

namespace HelloGcs;

 /// <summary>
 /// Example Cloud Storage-triggered function.
 /// This function can process any event from Cloud Storage.
 /// </summary>
public class Function : ICloudEventFunction<StorageObjectData>
{
    private readonly ILogger _logger;

    public Function(ILogger<Function> logger) =>
        _logger = logger;

    public Task HandleAsync(CloudEvent cloudEvent, StorageObjectData data, CancellationToken cancellationToken)
    {
        _logger.LogInformation("Event: {event}", cloudEvent.Id);
        _logger.LogInformation("Event Type: {type}", cloudEvent.Type);
        _logger.LogInformation("Bucket: {bucket}", data.Bucket);
        _logger.LogInformation("File: {file}", data.Name);
        _logger.LogInformation("Metageneration: {metageneration}", data.Metageneration);
        _logger.LogInformation("Created: {created:s}", data.TimeCreated?.ToDateTimeOffset());
        _logger.LogInformation("Updated: {updated:s}", data.Updated?.ToDateTimeOffset());
        return Task.CompletedTask;
    }
}

Ruby

require "functions_framework"

FunctionsFramework.cloud_event "hello_gcs" do |event|
  # This function supports all Cloud Storage events.
  # The `event` parameter is a CloudEvents::Event::V1 object.
  # See https://cloudevents.github.io/sdk-ruby/latest/CloudEvents/Event/V1.html
  payload = event.data

  logger.info "Event: #{event.id}"
  logger.info "Event Type: #{event.type}"
  logger.info "Bucket: #{payload['bucket']}"
  logger.info "File: #{payload['name']}"
  logger.info "Metageneration: #{payload['metageneration']}"
  logger.info "Created: #{payload['timeCreated']}"
  logger.info "Updated: #{payload['updated']}"
end

PHP

use CloudEvents\V1\CloudEventInterface;
use Google\CloudFunctions\FunctionsFramework;

// Register the function with Functions Framework.
// This enables omitting the `FUNCTIONS_SIGNATURE_TYPE=cloudevent` environment
// variable when deploying. The `FUNCTION_TARGET` environment variable should
// match the first parameter.
FunctionsFramework::cloudEvent('helloGCS', 'helloGCS');

function helloGCS(CloudEventInterface $cloudevent)
{
    // This function supports all Cloud Storage event types.
    $log = fopen(getenv('LOGGER_OUTPUT') ?: 'php://stderr', 'wb');
    $data = $cloudevent->getData();
    fwrite($log, 'Event: ' . $cloudevent->getId() . PHP_EOL);
    fwrite($log, 'Event Type: ' . $cloudevent->getType() . PHP_EOL);
    fwrite($log, 'Bucket: ' . $data['bucket'] . PHP_EOL);
    fwrite($log, 'File: ' . $data['name'] . PHP_EOL);
    fwrite($log, 'Metageneration: ' . $data['metageneration'] . PHP_EOL);
    fwrite($log, 'Created: ' . $data['timeCreated'] . PHP_EOL);
    fwrite($log, 'Updated: ' . $data['updated'] . PHP_EOL);
}

Per eseguire il deployment della funzione, esegui questo comando nella directory in cui in cui si trova il codice campione:

Node.js

gcloud functions deploy nodejs-finalize-function \
--gen2 \
--runtime=nodejs20 \
--region=REGION \
--source=. \
--entry-point=helloGCS \
--trigger-event-filters="type=google.cloud.storage.object.v1.finalized" \
--trigger-event-filters="bucket=YOUR_BUCKET_NAME"

Utilizza la --runtime per specificare l'ID runtime di un versione Node.js supportata per l'esecuzione la tua funzione.

Python

gcloud functions deploy python-finalize-function \
--gen2 \
--runtime=python312 \
--region=REGION \
--source=. \
--entry-point=hello_gcs \
--trigger-event-filters="type=google.cloud.storage.object.v1.finalized" \
--trigger-event-filters="bucket=YOUR_BUCKET_NAME"

Utilizza la --runtime per specificare l'ID runtime di un versione Python supportata per l'esecuzione la tua funzione.

Vai

gcloud functions deploy go-finalize-function \
--gen2 \
--runtime=go121 \
--region=REGION \
--source=. \
--entry-point=HelloStorage \
--trigger-event-filters="type=google.cloud.storage.object.v1.finalized" \
--trigger-event-filters="bucket=YOUR_BUCKET_NAME"

Utilizza la --runtime per specificare l'ID runtime di un versione Go supportata per l'esecuzione la tua funzione.

Java

gcloud functions deploy java-finalize-function \
--gen2 \
--runtime=java17 \
--region=REGION \
--source=. \
--entry-point=functions.HelloGcs \
--memory=512MB \
--trigger-event-filters="type=google.cloud.storage.object.v1.finalized" \
--trigger-event-filters="bucket=YOUR_BUCKET_NAME"

Utilizza la --runtime per specificare l'ID runtime di un versione Java supportata per l'esecuzione la tua funzione.

C#

gcloud functions deploy csharp-finalize-function \
--gen2 \
--runtime=dotnet6 \
--region=REGION \
--source=. \
--entry-point=HelloGcs.Function \
--trigger-event-filters="type=google.cloud.storage.object.v1.finalized" \
--trigger-event-filters="bucket=YOUR_BUCKET_NAME"

Utilizza la --runtime per specificare l'ID runtime di un versione .NET supportata per l'esecuzione la tua funzione.

Ruby

gcloud functions deploy ruby-finalize-function \
--gen2 \
--runtime=ruby32 \
--region=REGION \
--source=. \
--entry-point=hello_gcs \
--trigger-event-filters="type=google.cloud.storage.object.v1.finalized" \
--trigger-event-filters="bucket=YOUR_BUCKET_NAME"

Utilizza la --runtime per specificare l'ID runtime di un versione Ruby supportata per l'esecuzione la tua funzione.

PHP

gcloud functions deploy php-finalize-function \
--gen2 \
--runtime=php82 \
--region=REGION \
--source=. \
--entry-point=helloGCS \
--trigger-event-filters="type=google.cloud.storage.object.v1.finalized" \
--trigger-event-filters="bucket=YOUR_BUCKET_NAME"

Utilizza la --runtime per specificare l'ID runtime di un versione PHP supportata per l'esecuzione la tua funzione.

Sostituisci quanto segue:

• REGION: il nome del Regione Google Cloud in cui vuoi eseguire il deployment della funzione (ad es. us-west1).
• YOUR_BUCKET_NAME: il nome del bucket Cloud Storage che attiva la funzione. Quando esegui il deployment delle funzioni di 2ª generazione, specifica il bucket nome senza il gs:// iniziale; ad esempio --trigger-event-filters="bucket=my-bucket".

Finalizzazione oggetto: attiva la funzione

Testa la funzione caricando un file nel tuo bucket:

echo "Hello World" > test-finalize.txt
gcloud storage cp test-finalize.txt gs://YOUR_BUCKET_NAME/test-finalize.txt

Nei log dovresti vedere l'evento CloudEvent ricevuto:

gcloud functions logs read YOUR_FUNCTION_NAME --region REGION --gen2 --limit=10

Eliminazione oggetto

Gli eventi di eliminazione degli oggetti sono più utili per il controllo delle versioni bucket. Vengono attivati quando viene eliminata una versione precedente di un oggetto. Inoltre, vengono attivati quando viene sovrascritto. I trigger di eliminazione degli oggetti possono essere utilizzati anche con il controllo delle versioni bucket, che si attivano quando di un oggetto viene eliminata definitivamente.

Eliminazione oggetto: esegui il deployment della funzione

Esegui il deployment della funzione utilizzando lo stesso codice campione dell'esempio finalizzato con eliminazione oggetto come evento trigger. Esegui questo comando directory in cui si trova il codice campione:

Node.js

gcloud functions deploy nodejs-delete-function \
--gen2 \
--runtime=nodejs20 \
--region=REGION \
--source=. \
--entry-point=helloGCS \
--trigger-event-filters="type=google.cloud.storage.object.v1.deleted" \
--trigger-event-filters="bucket=YOUR_BUCKET_NAME"

Utilizza la --runtime per specificare l'ID runtime di un versione Node.js supportata per l'esecuzione la tua funzione.

Python

gcloud functions deploy python-delete-function \
--gen2 \
--runtime=python312 \
--region=REGION \
--source=. \
--entry-point=hello_gcs \
--trigger-event-filters="type=google.cloud.storage.object.v1.deleted" \
--trigger-event-filters="bucket=YOUR_BUCKET_NAME"

Utilizza la --runtime per specificare l'ID runtime di un versione Python supportata per l'esecuzione la tua funzione.

Vai

gcloud functions deploy go-delete-function \
--gen2 \
--runtime=go121 \
--region=REGION \
--source=. \
--entry-point=HelloStorage \
--trigger-event-filters="type=google.cloud.storage.object.v1.deleted" \
--trigger-event-filters="bucket=YOUR_BUCKET_NAME"

Utilizza la --runtime per specificare l'ID runtime di un versione Go supportata per l'esecuzione la tua funzione.

Java

gcloud functions deploy java-delete-function \
--gen2 \
--runtime=java17 \
--region=REGION \
--source=. \
--entry-point=functions.HelloGcs \
--memory=512MB \
--trigger-event-filters="type=google.cloud.storage.object.v1.deleted" \
--trigger-event-filters="bucket=YOUR_BUCKET_NAME"

Utilizza la --runtime per specificare l'ID runtime di un versione Java supportata per l'esecuzione la tua funzione.

C#

gcloud functions deploy csharp-delete-function \
--gen2 \
--runtime=dotnet6 \
--region=REGION \
--source=. \
--entry-point=HelloGcs.Function \
--trigger-event-filters="type=google.cloud.storage.object.v1.deleted" \
--trigger-event-filters="bucket=YOUR_BUCKET_NAME"

Utilizza la --runtime per specificare l'ID runtime di un versione .NET supportata per l'esecuzione la tua funzione.

Ruby

gcloud functions deploy ruby-delete-function \
--gen2 \
--runtime=ruby32 \
--region=REGION \
--source=. \
--entry-point=hello_gcs \
--trigger-event-filters="type=google.cloud.storage.object.v1.deleted" \
--trigger-event-filters="bucket=YOUR_BUCKET_NAME"

Utilizza la --runtime per specificare l'ID runtime di un versione Ruby supportata per l'esecuzione la tua funzione.

PHP

gcloud functions deploy php-delete-function \
--gen2 \
--runtime=php82 \
--region=REGION \
--source=. \
--entry-point=helloGCS \
--trigger-event-filters="type=google.cloud.storage.object.v1.deleted" \
--trigger-event-filters="bucket=YOUR_BUCKET_NAME"

Utilizza la --runtime per specificare l'ID runtime di un versione PHP supportata per l'esecuzione la tua funzione.

Sostituisci quanto segue:

• REGION: il nome del Regione Google Cloud in cui vuoi eseguire il deployment della funzione (ad es. us-west1).
• YOUR_BUCKET_NAME: il nome del bucket Cloud Storage che attiva la funzione. Quando esegui il deployment delle funzioni di 2ª generazione, specifica il bucket nome senza il gs:// iniziale; ad esempio --trigger-event-filters="bucket=my-bucket".

Eliminazione oggetto: attiva la funzione

Per attivare la funzione:

1. Crea un file test-delete.txt vuoto nella directory in cui è visualizzato il codice campione in cui viene localizzato.

2. Assicurati che il tuo bucket non sia sottoposto al controllo delle versioni:

   gcloud storage buckets update gs://YOUR_BUCKET_NAME --no-versioning
   

3. Carica il file su Cloud Storage:

   gcloud storage cp test-delete.txt gs://YOUR_BUCKET_NAME
   

   dove YOUR_BUCKET_NAME è il nome del tuo Bucket Cloud Storage in cui caricherai un file di test. A questo punto la funzione non dovrebbe ancora essere eseguita.

4. Elimina il file per attivare la funzione:

   gcloud storage rm gs://YOUR_BUCKET_NAME/test-delete.txt
   

5. Nei log dovresti vedere l'evento CloudEvent ricevuto:

   gcloud functions logs read YOUR_FUNCTION_NAME --region REGION --gen2 --limit=10

Tieni presente che l'esecuzione della funzione potrebbe richiedere del tempo.

Archiviazione oggetto

Gli eventi di archiviazione degli oggetti possono essere utilizzati solo con bucket di controllo delle versioni. Sono Attivato quando viene archiviata una versione precedente di un oggetto. In particolare, significa che quando un oggetto viene sovrascritto o eliminato, un evento di archiviazione viene attivata.

Archivio oggetti: esegui il deployment della funzione

Esegui il deployment della funzione utilizzando lo stesso codice campione dell'esempio finalizzato con l'archivio di oggetti come evento trigger. Esegui questo comando directory in cui si trova il codice campione:

Node.js

gcloud functions deploy nodejs-archive-function \
--gen2 \
--runtime=nodejs20 \
--region=REGION \
--source=. \
--entry-point=helloGCS \
--trigger-event-filters="type=google.cloud.storage.object.v1.archived" \
--trigger-event-filters="bucket=YOUR_BUCKET_NAME"

Utilizza la --runtime per specificare l'ID runtime di un versione Node.js supportata per l'esecuzione la tua funzione.

Python

gcloud functions deploy python-archive-function \
--gen2 \
--runtime=python312 \
--region=REGION \
--source=. \
--entry-point=hello_gcs \
--trigger-event-filters="type=google.cloud.storage.object.v1.archived" \
--trigger-event-filters="bucket=YOUR_BUCKET_NAME"

Utilizza la --runtime per specificare l'ID runtime di un versione Python supportata per l'esecuzione la tua funzione.

Vai

gcloud functions deploy go-archive-function \
--gen2 \
--runtime=go121 \
--region=REGION \
--source=. \
--entry-point=HelloStorage \
--trigger-event-filters="type=google.cloud.storage.object.v1.archived" \
--trigger-event-filters="bucket=YOUR_BUCKET_NAME"

Utilizza la --runtime per specificare l'ID runtime di un versione Go supportata per l'esecuzione la tua funzione.

Java

gcloud functions deploy java-archive-function \
--gen2 \
--runtime=java17 \
--region=REGION \
--source=. \
--entry-point=functions.HelloGcs \
--memory=512MB \
--trigger-event-filters="type=google.cloud.storage.object.v1.archived" \
--trigger-event-filters="bucket=YOUR_BUCKET_NAME"

Utilizza la --runtime per specificare l'ID runtime di un versione Java supportata per l'esecuzione la tua funzione.

C#

gcloud functions deploy csharp-archive-function \
--gen2 \
--runtime=dotnet6 \
--region=REGION \
--source=. \
--entry-point=HelloGcs.Function \
--trigger-event-filters="type=google.cloud.storage.object.v1.archived" \
--trigger-event-filters="bucket=YOUR_BUCKET_NAME"

Utilizza la --runtime per specificare l'ID runtime di un versione .NET supportata per l'esecuzione la tua funzione.

Ruby

gcloud functions deploy ruby-archive-function \
--gen2 \
--runtime=ruby32 \
--region=REGION \
--source=. \
--entry-point=hello_gcs \
--trigger-event-filters="type=google.cloud.storage.object.v1.archived" \
--trigger-event-filters="bucket=YOUR_BUCKET_NAME"

Utilizza la --runtime per specificare l'ID runtime di un versione Ruby supportata per l'esecuzione la tua funzione.

PHP

gcloud functions deploy php-archive-function \
--gen2 \
--runtime=php82 \
--region=REGION \
--source=. \
--entry-point=helloGCS \
--trigger-event-filters="type=google.cloud.storage.object.v1.archived" \
--trigger-event-filters="bucket=YOUR_BUCKET_NAME"

Utilizza la --runtime per specificare l'ID runtime di un versione PHP supportata per l'esecuzione la tua funzione.

Sostituisci quanto segue:

• REGION: il nome del Regione Google Cloud in cui vuoi eseguire il deployment della funzione (ad es. us-west1).
• YOUR_BUCKET_NAME: il nome del bucket Cloud Storage che attiva la funzione. Quando esegui il deployment delle funzioni di 2ª generazione, specifica il bucket nome senza il gs:// iniziale; ad esempio --trigger-event-filters="bucket=my-bucket".

Archivio oggetti: attiva la funzione

Per attivare la funzione:

1. Crea un file test-archive.txt vuoto nella directory in cui è visualizzato il codice campione in cui viene localizzato.

2. Assicurati che il controllo delle versioni sia abilitato nel tuo bucket:

    gcloud storage buckets update gs://YOUR_BUCKET_NAME --versioning
   

3. Carica il file su Cloud Storage:

   gcloud storage cp test-archive.txt gs://YOUR_BUCKET_NAME
   

   dove YOUR_BUCKET_NAME è il nome del tuo Bucket Cloud Storage in cui caricherai un file di test. A questo punto la funzione non dovrebbe ancora essere eseguita.

4. Archivia il file per attivare la funzione:

   gcloud storage rm gs://YOUR_BUCKET_NAME/test-archive.txt
   

5. Nei log dovresti vedere l'evento CloudEvent ricevuto:

   gcloud functions logs read YOUR_FUNCTION_NAME --region REGION --gen2 --limit=10

Aggiornamento metadati oggetto

Gli eventi di aggiornamento dei metadati vengono attivati quando i metadati dell'oggetto esistente vengono aggiornato.

Aggiornamento dei metadati degli oggetti: deployment della funzione

Esegui il deployment della funzione utilizzando lo stesso codice campione dell'esempio finalizzato con l'aggiornamento dei metadati come evento di trigger. Esegui questo comando directory in cui si trova il codice campione:

Node.js

gcloud functions deploy nodejs-metadata-function \
--gen2 \
--runtime=nodejs20 \
--region=REGION \
--source=. \
--entry-point=helloGCS \
--trigger-event-filters="type=google.cloud.storage.object.v1.metadataUpdated" \
--trigger-event-filters="bucket=YOUR_BUCKET_NAME"

Utilizza la --runtime per specificare l'ID runtime di un versione Node.js supportata per l'esecuzione la tua funzione.

Python

gcloud functions deploy python-metadata-function \
--gen2 \
--runtime=python312 \
--region=REGION \
--source=. \
--entry-point=hello_gcs \
--trigger-event-filters="type=google.cloud.storage.object.v1.metadataUpdated" \
--trigger-event-filters="bucket=YOUR_BUCKET_NAME"

Utilizza la --runtime per specificare l'ID runtime di un versione Python supportata per l'esecuzione la tua funzione.

Vai

gcloud functions deploy go-metadata-function \
--gen2 \
--runtime=go121 \
--region=REGION \
--source=. \
--entry-point=HelloStorage \
--trigger-event-filters="type=google.cloud.storage.object.v1.metadataUpdated" \
--trigger-event-filters="bucket=YOUR_BUCKET_NAME"

Utilizza la --runtime per specificare l'ID runtime di un versione Go supportata per l'esecuzione la tua funzione.

Java

gcloud functions deploy java-metadata-function \
--gen2 \
--runtime=java17 \
--region=REGION \
--source=. \
--entry-point=functions.HelloGcs \
--memory=512MB \
--trigger-event-filters="type=google.cloud.storage.object.v1.metadataUpdated" \
--trigger-event-filters="bucket=YOUR_BUCKET_NAME"

Utilizza la --runtime per specificare l'ID runtime di un versione Java supportata per l'esecuzione la tua funzione.

C#

gcloud functions deploy csharp-metadata-function \
--gen2 \
--runtime=dotnet6 \
--region=REGION \
--source=. \
--entry-point=HelloGcs.Function \
--trigger-event-filters="type=google.cloud.storage.object.v1.metadataUpdated" \
--trigger-event-filters="bucket=YOUR_BUCKET_NAME"

Utilizza la --runtime per specificare l'ID runtime di un versione .NET supportata per l'esecuzione la tua funzione.

Ruby

gcloud functions deploy ruby-metadata-function \
--gen2 \
--runtime=ruby32 \
--region=REGION \
--source=. \
--entry-point=hello_gcs \
--trigger-event-filters="type=google.cloud.storage.object.v1.metadataUpdated" \
--trigger-event-filters="bucket=YOUR_BUCKET_NAME"

Utilizza la --runtime per specificare l'ID runtime di un versione Ruby supportata per l'esecuzione la tua funzione.

PHP

gcloud functions deploy php-metadata-function \
--gen2 \
--runtime=php82 \
--region=REGION \
--source=. \
--entry-point=helloGCS \
--trigger-event-filters="type=google.cloud.storage.object.v1.metadataUpdated" \
--trigger-event-filters="bucket=YOUR_BUCKET_NAME"

Utilizza la --runtime per specificare l'ID runtime di un versione PHP supportata per l'esecuzione la tua funzione.

Sostituisci quanto segue:

• REGION: il nome del Regione Google Cloud in cui vuoi eseguire il deployment della funzione (ad es. us-west1).
• YOUR_BUCKET_NAME: il nome del bucket Cloud Storage che attiva la funzione. Quando esegui il deployment delle funzioni di 2ª generazione, specifica il bucket nome senza il gs:// iniziale; ad esempio --trigger-event-filters="bucket=my-bucket".

Aggiornamento metadati oggetto: attiva la funzione

Per attivare la funzione:

1. Crea un file test-metadata.txt vuoto nella directory in cui è visualizzato il codice campione in cui viene localizzato.

2. Assicurati che il tuo bucket non sia sottoposto al controllo delle versioni:

   gcloud storage buckets update gs://YOUR_BUCKET_NAME --no-versioning
   

3. Carica il file su Cloud Storage:

   gcloud storage cp test-metadata.txt gs://YOUR_BUCKET_NAME
   

   dove YOUR_BUCKET_NAME è il nome del tuo Bucket Cloud Storage in cui caricherai un file di test. A questo punto la funzione non dovrebbe ancora essere eseguita.

4. Aggiorna i metadati del file:

   gcloud storage objects update gs://YOUR_BUCKET_NAME/test-metadata.txt --content-type=text/plain
   

5. Nei log dovresti vedere l'evento CloudEvent ricevuto:

   gcloud functions logs read YOUR_FUNCTION_NAME --region REGION --gen2 --limit=10

Esegui la pulizia

Per evitare che al tuo Account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questo tutorial, elimina il progetto che contiene le risorse oppure mantieni il progetto ed elimina le singole risorse.

Elimina il progetto

Il modo più semplice per eliminare la fatturazione creato per il tutorial.

Per eliminare il progetto:

Attenzione: l'eliminazione di un progetto ha i seguenti effetti:

• L'intero contenuto del progetto viene eliminato. Se hai utilizzato un progetto esistente per le attività in questo documento, quando lo elimini elimini anche qualsiasi altro lavoro svolto nel progetto.
• Gli ID progetto personalizzati non sono più disponibili. Quando hai creato questo progetto, potresti aver creato un ID progetto personalizzato che vuoi utilizzare in futuro. Per conservare gli URL che utilizzano l'ID progetto, ad esempio un URL appspot.com, elimina le risorse selezionate all'interno del progetto anziché eliminare l'intero progetto.

Se intendi esplorare più architetture, tutorial o guide rapide, puoi riutilizzare i progetti ed evitare così di superare i limiti di quota.

1. Nella console Google Cloud, vai alla pagina Gestisci risorse.

   Vai a Gestisci risorse

2. Nell'elenco dei progetti, seleziona il progetto che vuoi eliminare, quindi fai clic su Elimina.
3. Nella finestra di dialogo, digita l'ID del progetto e fai clic su Chiudi per eliminare il progetto.

Elimina le funzioni Cloud Functions

L'eliminazione di Cloud Functions non rimuove le risorse archiviate in Cloud Storage.

Per eliminare le funzioni Cloud Functions che hai creato in questo tutorial, esegui questo comando:

gcloud functions delete YOUR_FUNCTION_NAME --gen2 --region REGION

Puoi eliminare Cloud Functions anche dalla console Google Cloud.

Passaggi successivi

• Scopri come eseguire l'OCR sulle immagini caricate in un bucket.
• Scopri come tradurre file di testo con Cloud Functions.