Ce tutoriel décrit l'utilisation de Cloud Functions, de l'API Google Cloud Vision et de l'outil ImageMagick pour détecter et flouter les images choquantes importées dans un bucket Cloud Storage.
Objectifs
- Déployer une fonction CloudEvent déclenchée par Storage
- Utiliser l'API Cloud Vision pour détecter les contenus violents ou réservés aux adultes
- Utiliser ImageMagick pour flouter les images choquantes
- Tester la fonction en important une image d'un zombie mangeur de chair
Coûts
Dans ce document, vous utilisez les composants facturables suivants de Google Cloud :
- Cloud Functions
- Cloud Storage
- Cloud Vision
- Cloud Build
- Pub/Sub
- Artifact Registry
- Eventarc
- Cloud Logging
Pour en savoir plus, consultez la page Tarifs de Cloud Functions.
Obtenez une estimation des coûts en fonction de votre utilisation prévue à l'aide du simulateur de coût.
Avant de commencer
- Connectez-vous à votre compte Google Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.
-
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
- Préparez votre environnement de développement.
Si la gcloud CLI est déjà installée, mettez-le à jour en exécutant la commande suivante :
gcloud components update
Visualiser le flux de données
Le flux de données dans l'application du tutoriel ImageMagick comprend plusieurs étapes :
- Une image est importée dans un bucket Cloud Storage.
- Cloud Function analyse l'image à l'aide de l'API Cloud Vision.
- Si un contenu violent ou réservé aux adultes est détecté, la fonction Cloud utilise ImageMagick pour flouter l'image.
- L'image floue est importée dans un autre bucket Cloud Storage pour être utilisée.
Préparer l'application
Créez un bucket Cloud Storage régional pour importer des images, où
YOUR_INPUT_BUCKET_NAME
est un nom de bucket unique etREGION
est la région dans laquelle vous prévoyez de déployer votre fonction :gsutil mb -l REGION gs://YOUR_INPUT_BUCKET_NAME
Créez un bucket Cloud Storage régional destiné à recevoir les images floues, où
YOUR_OUTPUT_BUCKET_NAME
est un nom de bucket unique etREGION
est la région dans laquelle vous prévoyez de déployer votre fonction :gsutil mb -l REGION gs://YOUR_OUTPUT_BUCKET_NAME
Clonez le dépôt de l'exemple d'application sur votre machine locale :
Node.js
git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples.git
Vous pouvez également télécharger l'exemple en tant que fichier ZIP et l'extraire.
Python
git clone https://github.com/GoogleCloudPlatform/python-docs-samples.git
Vous pouvez également télécharger l'exemple en tant que fichier ZIP et l'extraire.
Go
git clone https://github.com/GoogleCloudPlatform/golang-samples.git
Vous pouvez également télécharger l'exemple en tant que fichier ZIP et l'extraire.
Java
git clone https://github.com/GoogleCloudPlatform/java-docs-samples.git
Vous pouvez également télécharger l'exemple en tant que fichier ZIP et l'extraire.
Accédez au répertoire qui contient l'exemple de code de 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/
Comprendre le code
L'exemple ImageMagick inclut des dépendances et deux fonctions différentes. La première fonction analyse l'image et la seconde la floute si elle comporte du contenu violent ou réservé aux adultes.
Importer des dépendances
L'application doit importer plusieurs dépendances afin d'interagir avec les services Google Cloud, ImageMagick et le système de fichiers :
convert
Remarque : ImageMagick et son outil de ligne de commande sont inclus par défaut dans l'environnement d'exécution Cloud Functions pour la plupart des environnements d'exécution. Pour PHP, vous devrez peut-être effectuer une configuration manuelle.
Notez que Cloud Functions n'est pas compatible avec l'installation de packages personnalisés au niveau du système.
Node.js
Python
Go
Java
Analysez des images
La fonction suivante est appelée lorsqu'une image est importée dans le bucket Cloud Storage que vous avez créé pour l'entrée d'images. La fonction utilise l'API Cloud Vision pour détecter le contenu violent ou réservé aux adultes dans les images importées.
Node.js
Python
Go
Java
Flouter des images
La fonction suivante est appelée lorsqu'un contenu violent ou réservé aux adultes est détecté dans une image importée. La fonction télécharge l'image choquante, utilise ImageMagick pour flouter l'image, puis importe l'image floutée dans votre bucket de sortie.
Node.js
Python
Go
Java
Déployer la fonction
Pour déployer votre fonction Cloud avec un déclencheur Cloud Storage, exécutez la commande suivante dans le répertoire contenant l'exemple de code (ou, dans le cas de Java, le fichier 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
Remplacez les éléments suivants :
- RUNTIME: environnement d'exécution basé sur Ubuntu 18.04 ou une version ultérieure
- REGION : nom de la région Google Cloud dans laquelle vous souhaitez déployer votre fonction (par exemple,
us-west1
). - YOUR_INPUT_BUCKET_NAME : nom du bucket Cloud Storage pour l'importation d'images.
- YOUR_OUTPUT_BUCKET_NAME : nom du bucket dans lequel les images floutées doivent être enregistrées.
Lorsque vous déployez des fonctions de 2e génération, spécifiez uniquement le nom du bucket, sans le gs://
initial ; par exemple : --trigger-event-filters="bucket=my-bucket"
.
Importer une image
Importez une image choquante, telle que cette image d'un zombie mangeur de chair :
gsutil cp zombie.jpg gs://YOUR_INPUT_BUCKET_NAME
où
YOUR_INPUT_BUCKET_NAME
est le bucket Cloud Storage que vous avez créé précédemment pour importer des images.L'analyse de l'image doit s'afficher dans les journaux :
gcloud beta functions logs read YOUR_FUNCTION_NAME --gen2 --limit=100
Vous pouvez afficher les images floues dans le bucket Cloud Storage
YOUR_OUTPUT_BUCKET_NAME
que vous avez créé précédemment.
Nettoyer
Pour éviter que les ressources utilisées lors de ce tutoriel soient facturées sur votre compte Google Cloud, supprimez le projet contenant les ressources, ou conservez le projet et supprimez les ressources individuelles.
Supprimer le projet
Le moyen le plus simple d'empêcher la facturation est de supprimer le projet que vous avez créé pour ce tutoriel.
Pour supprimer le projet :
- 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.
Supprimer la fonction Cloud
La suppression de fonctions Cloud Functions ne supprime pas les ressources stockées dans Cloud Storage.
Pour supprimer la fonction que vous avez déployée dans ce tutoriel, exécutez la commande suivante :
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
Vous pouvez également supprimer des fonctions Cloud Functions à partir de Google Cloud Console.