Questo tutorial mostra come utilizzare le funzioni Cloud Run, l'API Vision e ImageMagick per rilevare e sfumare le immagini offensive caricate in un bucket Cloud Storage.
Obiettivi
- Esegui il deployment di una funzione CloudEvent attivata da Cloud Storage.
- Utilizza l'API Vision per rilevare contenuti violenti o per adulti.
- Utilizza ImageMagick per sfocare le immagini offensive.
- Testa la funzione caricando un'immagine di uno zombie cannibale.
Costi
In questo documento utilizzi i seguenti componenti fatturabili di Google Cloud:
- Cloud Run functions
- Cloud Storage
- Cloud Vision
- Cloud Build
- Pub/Sub
- Artifact Registry
- Eventarc
- Cloud Logging
For details, see Cloud Run functions pricing.
Per generare una stima dei costi basata sull'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
- Prepara l'ambiente di sviluppo.
Se hai già installato gcloud CLI, aggiornalo eseguendo il seguente comando:
gcloud components update
Visualizzare il flusso di dati
Il flusso di dati nell'applicazione del tutorial di ImageMagick prevede diversi passaggi:
- Un'immagine viene caricata in un bucket Cloud Storage.
- La funzione Cloud Run analizza l'immagine utilizzando l'API Cloud Vision.
- Se vengono rilevati contenuti violenti o per adulti, la funzione Cloud Run 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 univoco a livello globale eREGION
è la regione in cui prevedi di eseguire il deployment della funzione:gcloud storage buckets create gs://YOUR_INPUT_BUCKET_NAME --location=REGION
Crea un bucket Cloud Storage regionale per ricevere le immagini sfocate, dove
YOUR_OUTPUT_BUCKET_NAME
è un nome di bucket unico a livello mondiale eREGION
è la regione in cui prevedi di eseguire il deployment della funzione:gcloud storage buckets create gs://YOUR_OUTPUT_BUCKET_NAME --location=REGION
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.
Vai
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 delle funzioni Cloud Run:
Node.js
cd nodejs-docs-samples/functions/v2/imagemagick/
Python
cd python-docs-samples/functions/v2/imagemagick/
Vai
cd golang-samples/functions/functionsv2/imagemagick/
Java
cd java-docs-samples/functions/v2/imagemagick/
comprendi il codice
L'esempio ImageMagick include dipendenze e due funzioni diverse. La prima funzione analizza l'immagine e la seconda la sfoca se contiene contenuti violenti o per adulti.
Importa le dipendenze
L'applicazione deve importare diverse dipendenze per interagire con i servizi Google Cloud, ImageMagick e il file system:
ImageMagick e il relativo strumento a riga di comando convert
sono inclusi per impostazione predefinita
nell'ambiente di esecuzione di Cloud Run Functions per la maggior parte dei
runtime. Per PHP, potrebbe essere necessario eseguire alcune
configurazioni manuali.
Tieni presente che Cloud Run Functions non supporta l'installazione di pacchetti personalizzati a livello di sistema.
Node.js
Python
Vai
Java
Analizzare le immagini
La seguente funzione viene richiamata quando un'immagine viene caricata nel bucket Cloud Storage creato per l'input dell'immagine. La funzione utilizza l'API Vision per rilevare contenuti violenti o per adulti nelle immagini caricate.
Node.js
Python
Vai
Java
Sfocare le immagini
La seguente funzione viene chiamata quando vengono rilevati contenuti violenti o per adulti in un'immagine caricata. La funzione scarica l'immagine offensiva, utilizza ImageMagick per sfocare l'immagine e poi carica l'immagine sfocata nel bucket di output.
Node.js
Python
Vai
Java
esegui il deployment della funzione
Per eseguire il deployment della funzione Cloud Run con un trigger di archiviazione, esegui il seguente
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
Vai
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 ambiente di 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 Cloud Run, specifica solo il nome del bucket senza il carattere iniziale gs://
, ad esempio --trigger-event-filters="bucket=my-bucket"
.
Carica un'immagine
Caricare un'immagine offensiva, ad esempio questa di un zombie cannibale:
gcloud storage cp zombie.jpg gs://YOUR_INPUT_BUCKET_NAME
dove
YOUR_INPUT_BUCKET_NAME
è il bucket Cloud Storage che hai creato in precedenza per il caricamento delle immagini.Dovresti vedere l'analisi dell'immagine nei log:
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 funzione Cloud Run
L'eliminazione delle funzioni Cloud Run non rimuove le risorse archiviate in Cloud Storage.
Per eliminare la funzione di cui hai eseguito il deployment in questo tutorial, esegui il seguente comando:
Node.js
gcloud functions delete nodejs-blur-function --gen2 --region REGION
Python
gcloud functions delete python-blur-function --gen2 --region REGION
Vai
gcloud functions delete go-blur-function --gen2 --region REGION
Java
gcloud functions delete java-blur-function --gen2 --region REGION
Puoi anche eliminare le funzioni Cloud Run dalla console Google Cloud.