Questo tutorial illustra l'utilizzo di Cloud Functions, dell'API Google Cloud Vision e di ImageMagick per rilevare e sfocare le immagini offensive caricate in un bucket Cloud Storage.
Obiettivi
- Eseguire il deployment di una funzione CloudEvent attivata dall'archiviazione.
- Utilizzare l'API Cloud Vision per rilevare contenuti violenti o per adulti.
- Utilizza ImageMagick per sfocare le immagini offensive.
- Testa la funzione caricando l'immagine di uno zombie che mangia carne.
Costi
In questo documento utilizzi i seguenti componenti fatturabili di Google Cloud:
- Cloud Functions
- Cloud Storage
- Cloud Vision
- Cloud Build
- Pub/Sub
- Artifact Registry
- Eventarc
- Cloud Logging
Per maggiori dettagli, vedi i prezzi di Cloud Functions.
Per generare una stima dei costi in base all'utilizzo previsto,
utilizza il Calcolatore prezzi.
Prima di iniziare
- 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.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Cloud Functions, Cloud Build, Artifact Registry, Eventarc, Cloud Storage, Cloud Vision, Logging, and Pub/Sub APIs.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Cloud Functions, Cloud Build, Artifact Registry, Eventarc, Cloud Storage, Cloud Vision, Logging, and Pub/Sub APIs.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
- Preparare l'ambiente di sviluppo.
Se hai già installato gcloud CLI, aggiornalo eseguendo questo comando:
gcloud components update
Visualizza il flusso di dati
Il flusso di dati nell'applicazione tutorial ImageMagick prevede diversi passaggi:
- Viene caricata un'immagine in un bucket Cloud Storage.
- La funzione Cloud Functions analizza l'immagine utilizzando l'API Cloud Vision.
- Se vengono rilevati contenuti violenti o per adulti, la Cloud Function utilizza ImageMagick per sfocare l'immagine.
- L'immagine sfocata viene caricata in un altro bucket Cloud Storage per essere utilizzata.
prepara l'applicazione
Crea un bucket Cloud Storage regionale per il caricamento delle immagini, dove
YOUR_INPUT_BUCKET_NAME
è un nome di bucket univoco a livello globale eREGION
è la regione in cui prevedi di eseguire il deployment della funzione:gsutil mb -l REGION gs://YOUR_INPUT_BUCKET_NAME
Crea un bucket Cloud Storage regionale per ricevere immagini sfocate, dove
YOUR_OUTPUT_BUCKET_NAME
è un nome di bucket univoco a livello globale eREGION
è la regione in cui prevedi di eseguire il deployment della funzione:gsutil mb -l REGION gs://YOUR_OUTPUT_BUCKET_NAME
Clona il repository dell'app di esempio sulla 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.
Passa alla directory che contiene il codice campione di Cloud Functions:
Node.js
cd nodejs-docs-samples/functions/v2/imagemagick/
Python
cd python-docs-samples/functions/v2/imagemagick/
Go
cd golang-samples/functions/functionsv2/imagemagick/
Java
cd java-docs-samples/functions/v2/imagemagick/
comprendi il codice
L'esempio di ImageMagick include dipendenze e due funzioni diverse. La prima funzione analizza l'immagine, mentre la seconda la sfoca se include contenuti violenti o per adulti.
Importa dipendenze
L'applicazione deve importare diverse dipendenze per poter interagire con i servizi Google Cloud, ImageMagick e il file system:
ImageMagick e il suo strumento a riga di comando convert
sono inclusi per impostazione predefinita nell'ambiente di esecuzione di Cloud Functions per la maggior parte dei runtime. Per PHP, potrebbe essere necessario eseguire una configurazione manuale.
Tieni presente che Cloud Functions non supporta l'installazione di pacchetti personalizzati a livello di sistema.
Node.js
Python
Go
Java
Analizza le immagini
La seguente funzione viene richiamata quando un'immagine viene caricata nel bucket Cloud Storage creato per l'input dell'immagine. La funzione usa l'API Cloud Vision per rilevare contenuti violenti o per adulti nelle immagini caricate.
Node.js
Python
Go
Java
Sfoca le immagini
La seguente funzione viene richiamata quando un'immagine caricata contiene contenuti violenti o per adulti. La funzione scarica l'immagine offensiva, utilizza ImageMagick per sfocare l'immagine, quindi carica l'immagine sfocata nel bucket di output.
Node.js
Python
Go
Java
Esegui il deployment della funzione
Per eseguire il deployment della Cloud Function con un trigger di archiviazione, esegui questo comando nella directory contenente il codice campione (o, nel caso di Java, il file pom.xml
):
Node.js
gcloud functions deploy nodejs-blur-function \ --gen2 \ --runtime=RUNTIME \ --region=REGION \ --source=. \ --entry-point=blurOffensiveImages \ --trigger-bucket=YOUR_INPUT_BUCKET_NAME \ --set-env-vars=BLURRED_BUCKET_NAME=YOUR_OUTPUT_BUCKET_NAME
Python
gcloud functions deploy python-blur-function \ --gen2 \ --runtime=RUNTIME \ --region=REGION \ --source=. \ --entry-point=blur_offensive_images \ --trigger-bucket=YOUR_INPUT_BUCKET_NAME \ --set-env-vars=BLURRED_BUCKET_NAME=YOUR_OUTPUT_BUCKET_NAME
Go
gcloud functions deploy go-blur-function \ --gen2 \ --runtime=RUNTIME \ --region=REGION \ --source=. \ --entry-point=blur-offensive-images \ --trigger-bucket=YOUR_INPUT_BUCKET_NAME \ --set-env-vars=BLURRED_BUCKET_NAME=YOUR_OUTPUT_BUCKET_NAME
Java
gcloud functions deploy java-blur-function \ --gen2 \ --runtime=RUNTIME \ --region=REGION \ --source=. \ --entry-point=functions.ImageMagick \ --trigger-bucket=YOUR_INPUT_BUCKET_NAME \ --set-env-vars=BLURRED_BUCKET_NAME=YOUR_OUTPUT_BUCKET_NAME
Sostituisci quanto segue:
- RUNTIME: un runtime basato su Ubuntu 18.04 o versioni successive
- REGION: il nome della regione Google Cloud in cui vuoi eseguire il deployment della funzione (ad esempio
us-west1
). - YOUR_INPUT_BUCKET_NAME: il nome del bucket Cloud Storage per il caricamento delle immagini.
- YOUR_OUTPUT_BUCKET_NAME: il nome del bucket in cui devono essere salvate le immagini sfocate.
Quando esegui il deployment delle funzioni di 2ª generazione, specifica solo il nome del bucket senza l'elemento gs://
principale; ad esempio, --trigger-event-filters="bucket=my-bucket"
.
Carica un'immagine
Carica un'immagine offensiva, come questa immagine di uno zombie in carne e ossa:
gsutil cp zombie.jpg gs://YOUR_INPUT_BUCKET_NAME
dove
YOUR_INPUT_BUCKET_NAME
è il bucket Cloud Storage creato in precedenza per caricare le immagini.Nei log dovrebbe essere visualizzata l'analisi dell'immagine:
gcloud beta functions logs read YOUR_FUNCTION_NAME --gen2 --limit=100
Puoi visualizzare le immagini sfocate nel
YOUR_OUTPUT_BUCKET_NAME
bucket Cloud Storage che hai creato in precedenza.
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 è eliminare il progetto che hai creato per il tutorial.
Per eliminare il progetto:
- In the Google Cloud console, go to the Manage resources page.
- In the project list, select the project that you want to delete, and then click Delete.
- In the dialog, type the project ID, and then click Shut down to delete the project.
Elimina la Cloud Function
L'eliminazione di Cloud Functions non rimuove le risorse archiviate in Cloud Storage.
Per eliminare la funzione di cui hai eseguito il deployment in questo tutorial, esegui questo comando:
Node.js
gcloud functions delete nodejs-blur-function --gen2 --region REGION
Python
gcloud functions delete python-blur-function --gen2 --region REGION
Go
gcloud functions delete go-blur-function --gen2 --region REGION
Java
gcloud functions delete java-blur-function --gen2 --region REGION
Puoi anche eliminare Cloud Functions dalla console Google Cloud.