Questo tutorial mostra l'utilizzo delle funzioni Cloud Run, dell'API Cloud Vision e di ImageMagick per rilevare e sfocare le immagini offensive caricate in un bucket Cloud Storage.
Obiettivi
- Esegui il deployment di una funzione Cloud Run in background attivata da Cloud Storage.
- Utilizza l'API Cloud Vision per rilevare contenuti violenti o per adulti.
- Utilizza ImageMagick per sfocare le immagini offensive.
- Testa la funzione caricando un'immagine di uno zombie mangiacarne.
Costi
In questo documento, utilizzi i seguenti componenti fatturabili di Google Cloud:
- Cloud Run functions
- Cloud Storage
- Cloud Vision
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, Cloud Storage, and Cloud Vision APIs.
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
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, Cloud Storage, and Cloud Vision APIs.
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
- Prepara l'ambiente di sviluppo.
Se hai già installato gcloud CLI, aggiornala eseguendo il seguente comando:
gcloud components update
Visualizzare il flusso di dati
Il flusso di dati nell'applicazione tutorial su ImageMagick prevede diversi passaggi:
- Un'immagine viene caricata in un bucket Cloud Storage.
- La funzione analizza l'immagine utilizzando l'API Vision.
- Se vengono rilevati contenuti violenti o per adulti, la funzione utilizza ImageMagick per sfocare l'immagine.
- L'immagine sfocata viene caricata in un altro bucket Cloud Storage per l'utilizzo.
Preparazione della richiesta
Crea un bucket Cloud Storage per caricare le immagini, dove
YOUR_INPUT_BUCKET_NAME
è un nome di bucket univoco a livello globale:gcloud storage buckets create gs://YOUR_INPUT_BUCKET_NAME
Crea un bucket Cloud Storage per ricevere le immagini sfocate, dove
YOUR_OUTPUT_BUCKET_NAME
è un nome di bucket univoco a livello globale:gcloud storage buckets create 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 il campione come file ZIP ed estrarlo.
Python
git clone https://github.com/GoogleCloudPlatform/python-docs-samples.git
In alternativa, puoi scaricare il campione come file ZIP ed estrarlo.
Vai
git clone https://github.com/GoogleCloudPlatform/golang-samples.git
In alternativa, puoi scaricare il campione come file ZIP ed estrarlo.
Java
git clone https://github.com/GoogleCloudPlatform/java-docs-samples.git
In alternativa, puoi scaricare il campione come file ZIP ed estrarlo.
Ruby
git clone https://github.com/GoogleCloudPlatform/ruby-docs-samples.git
In alternativa, puoi scaricare il campione come file ZIP ed estrarlo.
Passa alla directory che contiene il codice campione delle funzioni Cloud Run:
Node.js
cd nodejs-docs-samples/functions/imagemagick/
Python
cd python-docs-samples/functions/imagemagick/
Vai
cd golang-samples/functions/imagemagick/
Java
cd java-docs-samples/functions/imagemagick/
Ruby
cd ruby-docs-samples/functions/imagemagick/
Nozioni di base sul codice
Importazione delle dipendenze
L'applicazione deve importare diverse dipendenze per interagire con i serviziGoogle Cloud , ImageMagick e il file system:
Node.js
Python
Go
Java
Ruby
Analisi delle immagini
La seguente funzione viene richiamata quando un'immagine viene caricata nel bucket Cloud Storage che hai creato per archiviare le immagini. La funzione utilizza l'API Vision per rilevare contenuti violenti o per adulti nelle immagini caricate.
Node.js
Python
Go
Java
Ruby
Sfocatura delle 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 sfocarla e poi carica l'immagine sfocata sopra l'immagine originale.
Node.js
Python
Go
Java
Ruby
Deployment della funzione
Per eseguire il deployment della funzione con un trigger di archiviazione, esegui questo comando nella directory che contiene il codice campione (o, nel caso di Java, il file pom.xml
):
Node.js
gcloud functions deploy blurOffensiveImages \ --no-gen2 \ --runtime=RUNTIME \ --trigger-bucket=YOUR_INPUT_BUCKET_NAME \ --set-env-vars=BLURRED_BUCKET_NAME=YOUR_OUTPUT_BUCKET_NAME
Python
gcloud functions deploy blur_offensive_images \ --no-gen2 \ --runtime=RUNTIME \ --trigger-bucket=YOUR_INPUT_BUCKET_NAME \ --set-env-vars=BLURRED_BUCKET_NAME=YOUR_OUTPUT_BUCKET_NAME
Vai
gcloud functions deploy BlurOffensiveImages \ --no-gen2 \ --runtime=RUNTIME \ --trigger-bucket=YOUR_INPUT_BUCKET_NAME \ --set-env-vars=BLURRED_BUCKET_NAME=YOUR_OUTPUT_BUCKET_NAME
Java
gcloud functions deploy java-blur-function \ --no-gen2 \ --entry-point=functions.ImageMagick \ --runtime=RUNTIME \ --memory 512MB \ --trigger-bucket=YOUR_INPUT_BUCKET_NAME \ --set-env-vars=BLURRED_BUCKET_NAME=YOUR_OUTPUT_BUCKET_NAME
C#
gcloud functions deploy csharp-blur-function \ --no-gen2 \ --entry-point=ImageMagick.Function \ --runtime=RUNTIME \ --trigger-bucket=YOUR_INPUT_BUCKET_NAME \ --set-env-vars=BLURRED_BUCKET_NAME=YOUR_OUTPUT_BUCKET_NAME
Ruby
gcloud functions deploy blur_offensive_images \ --no-gen2 \ --runtime=RUNTIME \ --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 (i runtime successivi non includono il supporto di ImageMagick).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 salvare le immagini sfocate.
Per questo esempio specifico, non includere gs://
nei nomi dei bucket
nel comando deploy
.
Caricamento di un'immagine
Carica un'immagine offensiva, ad esempio questa immagine di uno zombie mangiacarne:
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 caricare le immagini.Guarda i log per assicurarti che le esecuzioni siano state completate:
gcloud functions logs read --limit 100
Puoi visualizzare le immagini sfocate nel bucket
YOUR_OUTPUT_BUCKET_NAME
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.
Eliminazione del progetto
Il modo più semplice per eliminare la fatturazione è quello di eliminare il progetto 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.
Eliminazione della funzione
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 questo comando:
Node.js
gcloud functions delete blurOffensiveImages
Python
gcloud functions delete blur_offensive_images
Vai
gcloud functions delete BlurOffensiveImages
Java
gcloud functions delete java-blur-function
Ruby
gcloud functions delete blur_offensive_images
Puoi anche eliminare le funzioni Cloud Run dalla consoleGoogle Cloud .