Questo semplice tutorial illustra la scrittura, il deployment e l'attivazione di una funzione Cloud Functions basata su eventi con un trigger di Cloud Storage per rispondere agli eventi Cloud Storage.
Se stai cercando esempi di codice per l'utilizzo di Cloud Storage, visita il browser di esempio Google Cloud.
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, utilizzi i seguenti componenti fatturabili di Google Cloud:
- Cloud Functions
- Cloud Storage
Per generare una stima dei costi in base all'utilizzo previsto, utilizza il Calcolatore prezzi.
Per seguire le indicazioni dettagliate per questa attività direttamente nell'editor di Cloud Shell, fai clic su Procedura guidata:
Prima di iniziare
- 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.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
Abilita le API Cloud Functions, Cloud Build, Cloud Storage, and Eventarc.
- Installa Google Cloud CLI.
-
Per initialize gcloud CLI, esegui questo comando:
gcloud init
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
Abilita le API Cloud Functions, Cloud Build, Cloud Storage, and Eventarc.
- Installa Google Cloud CLI.
-
Per initialize gcloud CLI, esegui questo comando:
gcloud init
-
Prepara l'ambiente di sviluppo:
Node.js
Python
Go
Java
C#
Ruby
PHP
Se hai già installato gcloud CLI, aggiornalo eseguendo questo comando:
gcloud components update
Preparazione dell'applicazione
Crea un bucket Cloud Storage per caricare un file di test, dove
YOUR_TRIGGER_BUCKET_NAME
è un nome di bucket univoco a livello globale:gsutil mb gs://YOUR_TRIGGER_BUCKET_NAME
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 scaricare l'esempio come file ZIP ed estrarlo.
Python
git clone https://github.com/GoogleCloudPlatform/python-docs-samples.git
In alternativa, puoi scaricare l'esempio come file ZIP ed estrarlo.
Go
git clone https://github.com/GoogleCloudPlatform/golang-samples.git
In alternativa, puoi scaricare l'esempio come file ZIP ed estrarlo.
Java
git clone https://github.com/GoogleCloudPlatform/java-docs-samples.git
In alternativa, puoi scaricare l'esempio come file ZIP ed estrarlo.
C#
git clone https://github.com/GoogleCloudPlatform/dotnet-docs-samples.git
In alternativa, puoi scaricare l'esempio come file ZIP ed estrarlo.
Ruby
git clone https://github.com/GoogleCloudPlatform/ruby-docs-samples.git
In alternativa, puoi scaricare l'esempio come file ZIP ed estrarlo.
PHP
git clone https://github.com/GoogleCloudPlatform/php-docs-samples.git
In alternativa, puoi scaricare l'esempio come file ZIP ed estrarlo.
Passa alla directory che contiene il codice campione di Cloud Functions:
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/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/
Deployment e attivazione della funzione
Attualmente, le funzioni di Cloud Storage si basano sulle notifiche Pub/Sub di Cloud Storage e supportano tipi di eventi simili:
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 la "scrittura" di un oggetto Cloud Storage viene completata correttamente. In particolare, questo evento attiva la creazione di un nuovo oggetto o la sovrascrittura di un oggetto esistente. Le operazioni di aggiornamento dell'archivio e dei metadati vengono ignorate da questo trigger.
Finalizzazione oggetto: deployment della funzione
Dai un'occhiata alla funzione di esempio che gestisce gli eventi di Cloud Storage:
Node.js
Python
Go
Java
C#
Ruby
PHP
Per eseguire il deployment della funzione, esegui questo comando nella directory in cui si trova il codice campione:
Node.js
gcloud functions deploy helloGCS \ --runtime nodejs20 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.finalize
Utilizza il flag --runtime
per specificare l'ID runtime di una versione Node.js supportata per eseguire la funzione.
Python
gcloud functions deploy hello_gcs \ --runtime python312 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.finalize
Utilizza il flag --runtime
per specificare l'ID runtime di una versione Python supportata per eseguire la funzione.
Go
gcloud functions deploy HelloGCS \ --runtime go121 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.finalize
Utilizza il flag --runtime
per specificare l'ID runtime di una versione Go supportata per eseguire la funzione.
Java
gcloud functions deploy java-gcs-function \ --entry-point functions.HelloGcs \ --runtime java17 \ --memory 512MB \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.finalize
Utilizza il flag --runtime
per specificare l'ID runtime di una versione Java supportata per eseguire la funzione.
C#
gcloud functions deploy csharp-gcs-function \ --entry-point HelloGcs.Function \ --runtime dotnet6 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.finalize
Utilizza il flag --runtime
per specificare l'ID runtime di una versione .NET supportata per eseguire la funzione.
Ruby
gcloud functions deploy hello_gcs --runtime ruby32 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.finalize
Utilizza il flag --runtime
per specificare l'ID runtime di una versione Ruby supportata per eseguire la funzione.
PHP
gcloud functions deploy helloGCS --runtime php82 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.finalize
Utilizza il flag --runtime
per specificare l'ID runtime di una
versione PHP supportata per eseguire
la funzione.
dove YOUR_TRIGGER_BUCKET_NAME
è il nome del bucket Cloud Storagee che attiva la funzione.
Finalizzazione oggetto: attivazione della funzione
Per attivare la funzione:
Crea un file
gcf-test.txt
vuoto nella directory in cui si trova il codice campione.Carica il file in Cloud Storage per attivare la funzione:
gsutil cp gcf-test.txt gs://YOUR_TRIGGER_BUCKET_NAME
dove
YOUR_TRIGGER_BUCKET_NAME
è il nome del bucket Cloud Storage in cui caricherai un file di test.Controlla i log per assicurarti che le esecuzioni siano state completate:
gcloud functions logs read --limit 50
Eliminazione oggetto
Gli eventi di eliminazione degli oggetti sono utili soprattutto per i bucket non relativi al controllo delle versioni. Vengono attivati quando viene eliminata una versione precedente di un oggetto. Vengono inoltre attivati quando un oggetto viene sovrascritto. I trigger di eliminazione degli oggetti possono essere utilizzati anche con i bucket di controllo delle versioni, che attivano i trigger quando una versione di un oggetto viene eliminata definitivamente.
Eliminazione oggetto: deployment della funzione
Utilizzando lo stesso codice campione dell'esempio di finalizzazione, esegui il deployment della funzione con eliminazione oggetto come evento trigger. Esegui questo comando nella directory in cui si trova il codice campione:
Node.js
gcloud functions deploy helloGCS \ --runtime nodejs20 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.delete
Utilizza il flag --runtime
per specificare l'ID runtime di una versione Node.js supportata per eseguire la funzione.
Python
gcloud functions deploy hello_gcs \ --runtime python312 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.delete
Utilizza il flag --runtime
per specificare l'ID runtime di una versione Python supportata per eseguire la funzione.
Go
gcloud functions deploy HelloGCS \ --runtime go121 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.delete
Utilizza il flag --runtime
per specificare l'ID runtime di una versione Go supportata per eseguire la funzione.
Java
gcloud functions deploy java-gcs-function \ --entry-point functions.HelloGcs \ --runtime java17 \ --memory 512MB \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.delete
Utilizza il flag --runtime
per specificare l'ID runtime di una versione Java supportata per eseguire la funzione.
C#
gcloud functions deploy csharp-gcs-function \ --entry-point HelloGcs.Function \ --runtime dotnet6 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.delete
Utilizza il flag --runtime
per specificare l'ID runtime di una versione .NET supportata per eseguire la funzione.
Ruby
gcloud functions deploy hello_gcs --runtime ruby32 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.delete
Utilizza il flag --runtime
per specificare l'ID runtime di una versione Ruby supportata per eseguire la funzione.
PHP
gcloud functions deploy helloGCS --runtime php82 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.delete
Utilizza il flag --runtime
per specificare l'ID runtime di una
versione PHP supportata per eseguire
la funzione.
dove YOUR_TRIGGER_BUCKET_NAME
è il nome del bucket Cloud Storagee che attiva la funzione.
Eliminazione oggetto: attivazione della funzione
Per attivare la funzione:
Crea un file
gcf-test.txt
vuoto nella directory in cui si trova il codice campione.Assicurati che il tuo bucket non sia sottoposto al controllo delle versioni:
gsutil versioning set off gs://YOUR_TRIGGER_BUCKET_NAME
Carica il file su Cloud Storage:
gsutil cp gcf-test.txt gs://YOUR_TRIGGER_BUCKET_NAME
dove
YOUR_TRIGGER_BUCKET_NAME
è il nome del bucket Cloud Storage in cui caricherai un file di test. A questo punto la funzione non dovrebbe ancora essere eseguita.Elimina il file per attivare la funzione:
gsutil rm gs://YOUR_TRIGGER_BUCKET_NAME/gcf-test.txt
Controlla i log per assicurarti che le esecuzioni siano state completate:
gcloud functions logs read --limit 50
Tieni presente che l'esecuzione della funzione potrebbe richiedere del tempo.
Archiviazione oggetto
Gli eventi di archiviazione degli oggetti possono essere utilizzati solo con i bucket di controllo delle versioni. Vengono attivati quando viene archiviata una versione precedente di un oggetto. In particolare, ciò significa che quando un oggetto viene sovrascritto o eliminato, viene attivato un evento di archiviazione.
Archivio oggetti: deployment della funzione
Utilizzando lo stesso codice campione dell'esempio di finalizzazione, esegui il deployment della funzione con l'archivio di oggetti come evento trigger. Esegui questo comando nella directory in cui si trova il codice campione:
Node.js
gcloud functions deploy helloGCS \ --runtime nodejs20 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.archive
Utilizza il flag --runtime
per specificare l'ID runtime di una versione Node.js supportata per eseguire la funzione.
Python
gcloud functions deploy hello_gcs \ --runtime python312 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.archive
Utilizza il flag --runtime
per specificare l'ID runtime di una versione Python supportata per eseguire la funzione.
Go
gcloud functions deploy HelloGCS \ --runtime go121 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.archive
Utilizza il flag --runtime
per specificare l'ID runtime di una versione Go supportata per eseguire la funzione.
Java
gcloud functions deploy java-gcs-function \ --entry-point functions.HelloGcs \ --runtime java17 \ --memory 512MB \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.archive
Utilizza il flag --runtime
per specificare l'ID runtime di una versione Java supportata per eseguire la funzione.
C#
gcloud functions deploy csharp-gcs-function \ --entry-point HelloGcs.Function \ --runtime dotnet6 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.archive
Utilizza il flag --runtime
per specificare l'ID runtime di una versione .NET supportata per eseguire la funzione.
Ruby
gcloud functions deploy hello_gcs --runtime ruby32 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.archive
Utilizza il flag --runtime
per specificare l'ID runtime di una versione Ruby supportata per eseguire la funzione.
PHP
gcloud functions deploy helloGCS --runtime php82 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.archive
Utilizza il flag --runtime
per specificare l'ID runtime di una
versione PHP supportata per eseguire
la funzione.
dove YOUR_TRIGGER_BUCKET_NAME
è il nome del bucket Cloud Storagee che attiva la funzione.
Archivio oggetti: attivazione della funzione
Per attivare la funzione:
Crea un file
gcf-test.txt
vuoto nella directory in cui si trova il codice campione.Assicurati che il controllo delle versioni sia abilitato nel tuo bucket:
gsutil versioning set on gs://YOUR_TRIGGER_BUCKET_NAME
Carica il file su Cloud Storage:
gsutil cp gcf-test.txt gs://YOUR_TRIGGER_BUCKET_NAME
dove
YOUR_TRIGGER_BUCKET_NAME
è il nome del bucket Cloud Storage in cui caricherai un file di test. A questo punto la funzione non dovrebbe ancora essere eseguita.Archivia il file per attivare la funzione:
gsutil rm gs://YOUR_TRIGGER_BUCKET_NAME/gcf-test.txt
Controlla i log per assicurarti che le esecuzioni siano state completate:
gcloud functions logs read --limit 50
Aggiornamento metadati oggetto
Gli eventi di aggiornamento dei metadati vengono attivati quando i metadati dell'oggetto esistente vengono aggiornati.
Aggiornamento dei metadati degli oggetti: deployment della funzione
Utilizzando lo stesso codice campione dell'esempio finalizzato, esegui il deployment della funzione con l'aggiornamento dei metadati come evento trigger. Esegui questo comando nella directory in cui si trova il codice campione:
Node.js
gcloud functions deploy helloGCS \ --runtime nodejs20 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.metadataUpdate
Utilizza il flag --runtime
per specificare l'ID runtime di una versione Node.js supportata per eseguire la funzione.
Python
gcloud functions deploy hello_gcs \ --runtime python312 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.metadataUpdate
Utilizza il flag --runtime
per specificare l'ID runtime di una versione Python supportata per eseguire la funzione.
Go
gcloud functions deploy HelloGCS \ --runtime go121 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.metadataUpdate
Utilizza il flag --runtime
per specificare l'ID runtime di una versione Go supportata per eseguire la funzione.
Java
gcloud functions deploy java-gcs-function \ --entry-point functions.HelloGcs \ --runtime java17 \ --memory 512MB \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.metadataUpdate
Utilizza il flag --runtime
per specificare l'ID runtime di una versione Java supportata per eseguire la funzione.
C#
gcloud functions deploy csharp-gcs-function \ --entry-point HelloGcs.Function \ --runtime dotnet6 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.metadataUpdate
Utilizza il flag --runtime
per specificare l'ID runtime di una versione .NET supportata per eseguire la funzione.
Ruby
gcloud functions deploy hello_gcs --runtime ruby32 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.metadataUpdate
Utilizza il flag --runtime
per specificare l'ID runtime di una versione Ruby supportata per eseguire la funzione.
PHP
gcloud functions deploy helloGCS --runtime php82 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.metadataUpdate
Utilizza il flag --runtime
per specificare l'ID runtime di una
versione PHP supportata per eseguire
la funzione.
dove YOUR_TRIGGER_BUCKET_NAME
è il nome del bucket Cloud Storagee che attiva la funzione.
Aggiornamento metadati oggetto: attivazione della funzione
Per attivare la funzione:
Crea un file
gcf-test.txt
vuoto nella directory in cui si trova il codice campione.Assicurati che il tuo bucket non sia sottoposto al controllo delle versioni:
gsutil versioning set off gs://YOUR_TRIGGER_BUCKET_NAME
Carica il file su Cloud Storage:
gsutil cp gcf-test.txt gs://YOUR_TRIGGER_BUCKET_NAME
dove
YOUR_TRIGGER_BUCKET_NAME
è il nome del bucket Cloud Storage in cui caricherai un file di test. A questo punto la funzione non dovrebbe ancora essere eseguita.Aggiorna i metadati del file:
gsutil -m setmeta -h "Content-Type:text/plain" gs://YOUR_TRIGGER_BUCKET_NAME/gcf-test.txt
Controlla i log per assicurarti che le esecuzioni siano state completate:
gcloud functions logs read --limit 50
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 è quello di eliminare il progetto che hai creato per il tutorial.
Per eliminare il progetto:
- Nella console Google Cloud, vai alla pagina Gestisci risorse.
- Nell'elenco dei progetti, seleziona il progetto che vuoi eliminare, quindi fai clic su Elimina.
- Nella finestra di dialogo, digita l'ID del progetto e fai clic su Chiudi per eliminare il progetto.
Eliminazione della Cloud Function
L'eliminazione di Cloud Functions non rimuove le risorse archiviate in Cloud Storage.
Per eliminare la Cloud Function creata in questo tutorial, esegui questo comando:
Node.js
gcloud functions delete helloGCS
Python
gcloud functions delete hello_gcs
Go
gcloud functions delete HelloGCS
Java
gcloud functions delete java-gcs-function
C#
gcloud functions delete csharp-gcs-function
Ruby
gcloud functions delete hello_gcs
PHP
gcloud functions delete helloGCS
Puoi eliminare Cloud Functions anche dalla console Google Cloud.