Questo tutorial dimostra l'utilizzo di Cloud Functions, dell'API Google Cloud Vision e di ImageMagick per rilevare e sfocare le immagini offensive che vengono caricate in un bucket Cloud Storage.
Obiettivi
- Esegui il deployment di una funzione Cloud Functions in background attivata dall'archiviazione.
- Utilizzare l'API Cloud Vision per rilevare contenuti violenti o per adulti.
- Utilizzare ImageMagick per sfocare 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
Per generare una stima dei costi in base all'utilizzo previsto, utilizza il Calcolatore prezzi.
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 Cloud Vision.
- 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 Cloud Vision.
- 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
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 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 e può essere utilizzata.
Preparazione dell'applicazione
Crea un bucket Cloud Storage per il caricamento delle immagini, dove
YOUR_INPUT_BUCKET_NAME
è un nome di bucket univoco a livello globale:gsutil mb gs://YOUR_INPUT_BUCKET_NAME
Crea un bucket Cloud Storage per ricevere immagini sfocate, dove
YOUR_OUTPUT_BUCKET_NAME
è un nome di bucket univoco a livello globale:gsutil mb gs://YOUR_OUTPUT_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/imagemagick/
Python
cd python-docs-samples/functions/imagemagick/
Go
cd golang-samples/functions/imagemagick/
Java
cd java-docs-samples/functions/imagemagick/
C#
cd dotnet-docs-samples/functions/imagemagick/
Ruby
cd ruby-docs-samples/functions/imagemagick/
PHP
cd php-docs-samples/functions/imagemagick/
Nozioni di base sul codice
Importazione delle dipendenze
L'applicazione deve importare diverse dipendenze per poter interagire con i servizi Google Cloud Platform, ImageMagick e il file system:
Node.js
Python
Go
Java
C#
Ruby
PHP
Analisi delle immagini in corso...
La seguente funzione viene richiamata quando un'immagine viene caricata nel bucket Cloud Storage creato per l'archiviazione delle immagini. La funzione utilizza l'API Cloud Vision per rilevare contenuti violenti o per adulti nelle immagini caricate.
Node.js
Python
Go
Java
C#
Ruby
PHP
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, quindi carica l'immagine sfocata sopra l'immagine originale.
Node.js
Python
Go
Java
C#
Ruby
PHP
esegui il deployment della funzione
Per eseguire il deployment della Cloud Function 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 \ --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 \ --runtime=RUNTIME \ --trigger-bucket=YOUR_INPUT_BUCKET_NAME \ --set-env-vars=BLURRED_BUCKET_NAME=YOUR_OUTPUT_BUCKET_NAME
Go
gcloud functions deploy BlurOffensiveImages \ --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 \ --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 \ --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 \ --runtime=RUNTIME \ --trigger-bucket=YOUR_INPUT_BUCKET_NAME \ --set-env-vars=BLURRED_BUCKET_NAME=YOUR_OUTPUT_BUCKET_NAME
PHP
gcloud functions deploy blurOffensiveImages \ --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 per 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://
come parte dei nomi dei bucket nel comando deploy
.
Caricamento di un'immagine
Carica un'immagine offensiva, come questa immagine di uno zombi che mangia carne:
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.Controlla i log per assicurarti che le esecuzioni siano state completate:
gcloud functions logs read --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 è 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 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
Go
gcloud functions delete BlurOffensiveImages
Java
gcloud functions delete java-blur-function
C#
gcloud functions delete csharp-blur-function
Ruby
gcloud functions delete blur_offensive_images
PHP
gcloud functions delete blurOffensiveImages
Puoi eliminare Cloud Functions anche dalla console Google Cloud.