In dieser Anleitung wird gezeigt, wie Sie Cloud Functions, die Google Cloud Vision API und ImageMagick verwenden können, um anstößige Bilder, die in einen Cloud Storage-Bucket hochgeladen werden, zu erkennen und unkenntlich zu machen.
Lernziele
- Eine durch Cloud Storage ausgelöste CloudEvent-Funktion bereitstellen
- Gewaltverherrlichende oder nicht jugendfreie Inhalte mit der Cloud Vision API erkennen
- Anstößige Bilder mit ImageMagick unkenntlich machen
- Beispielbild hochladen, um die Funktion zu testen
Kosten
In diesem Dokument verwenden Sie die folgenden kostenpflichtigen Komponenten von Google Cloud:
- Cloud Functions
- Cloud Storage
- Cloud Vision
- Cloud Build
- Pub/Sub
- Artifact Registry
- Eventarc
- Cloud Logging
Weitere Informationen finden Sie unter Cloud Functions-Preise.
Mit dem Preisrechner können Sie eine Kostenschätzung für Ihre voraussichtliche Nutzung vornehmen.
Vorbereitung
- 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
- Bereiten Sie die Entwicklungsumgebung vor.
Wenn Sie die gcloud CLI bereits installiert haben, aktualisieren Sie sie mit dem folgenden Befehl:
gcloud components update
Datenfluss visualisieren
Der Datenfluss in der Anwendung der ImageMagick-Anleitung umfasst mehrere Schritte:
- Ein Bild wird in einen Cloud Storage-Bucket hochgeladen.
- Die Cloud Functions-Funktion analysiert das Bild mithilfe der Cloud Vision API.
- Wenn Inhalte mit Darstellungen von Gewalt oder Inhalte nur für Erwachsene erkannt werden, nutzt die Cloud Functions-Funktion ImageMagick, um das Bild unkenntlich zu machen.
- Das unkenntlich gemachte Bild wird zur Verwendung in einen anderen Cloud Storage-Bucket hochgeladen.
Anwendung vorbereiten
Erstellen Sie einen regionalen Cloud Storage-Bucket zum Hochladen von Bildern. Dabei ist
YOUR_INPUT_BUCKET_NAME
ein global eindeutiger Bucket-Name undREGION
die Region, in der Sie die Funktion bereitstellen möchten:gsutil mb -l REGION gs://YOUR_INPUT_BUCKET_NAME
Erstellen Sie einen regionalen Cloud Storage-Bucket, um unkenntlich gemachte Bilder zu erhalten, wobei
YOUR_OUTPUT_BUCKET_NAME
ein global eindeutiger Bucket-Name ist undREGION
die Region ist, in der Sie die Funktion bereitstellen möchten:gsutil mb -l REGION gs://YOUR_OUTPUT_BUCKET_NAME
Klonen Sie das Repository der Beispiel-App auf Ihren lokalen Computer:
Node.js
git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples.git
Sie können auch das Beispiel als ZIP-Datei herunterladen und extrahieren.
Python
git clone https://github.com/GoogleCloudPlatform/python-docs-samples.git
Sie können auch das Beispiel als ZIP-Datei herunterladen und extrahieren.
Einfach loslegen (Go)
git clone https://github.com/GoogleCloudPlatform/golang-samples.git
Sie können auch das Beispiel als ZIP-Datei herunterladen und extrahieren.
Java
git clone https://github.com/GoogleCloudPlatform/java-docs-samples.git
Sie können auch das Beispiel als ZIP-Datei herunterladen und extrahieren.
Wechseln Sie in das Verzeichnis, das den Cloud Functions-Beispielcode enthält:
Node.js
cd nodejs-docs-samples/functions/v2/imagemagick/
Python
cd python-docs-samples/functions/v2/imagemagick/
Einfach loslegen (Go)
cd golang-samples/functions/functionsv2/imagemagick/
Java
cd java-docs-samples/functions/v2/imagemagick/
Den Code verstehen
Das ImageMagick-Beispiel enthält Abhängigkeiten und zwei verschiedene Funktionen. Die erste Funktion analysiert das Bild und die zweite Funktion macht es unkenntlich, wenn es gewalttätige Inhalte oder Inhalte nur für Erwachsene enthält.
Abhängigkeiten importieren
Die Anwendung muss mehrere Abhängigkeiten importieren, um mit Google Cloud-Diensten, ImageMagick und dem Dateisystem zu kommunizieren:
ImageMagick und das zugehörige convert
-Befehlszeilentool sind für die meisten Laufzeiten standardmäßig in der Cloud Functions-Ausführungsumgebung enthalten. Für PHP müssen Sie möglicherweise eine manuelle Konfiguration vornehmen.
Beachten Sie, dass Cloud Functions keine Installation benutzerdefinierter Pakete auf Systemebene unterstützt.
Node.js
Python
Einfach loslegen (Go)
Java
Bilder analysieren
Die folgende Funktion wird aufgerufen, wenn ein Bild in den Cloud Storage-Bucket hochgeladen wird, den Sie für Bildereingaben erstellt haben. Die Funktion verwendet die Cloud Vision API, um gewaltverherrlichende oder nicht jugendfreie Inhalte in hochgeladenen Bildern zu erkennen.
Node.js
Python
Einfach loslegen (Go)
Java
Bilder unkenntlich machen
Die folgende Funktion wird aufgerufen, wenn in einem hochgeladenen Bild gewaltverherrlichende oder nicht jugendfreie Inhalte erkannt werden. Die Funktion lädt das anstößige Bild herunter, macht das Bild mit ImageMagick unkenntlich und lädt das bearbeitete Bild dann hoch in Ihren Ausgabebucket.
Node.js
Python
Einfach loslegen (Go)
Java
Funktion implementieren
Führen Sie den folgenden Befehl in dem Verzeichnis aus, das den Beispielcode (oder im Fall von Java die Datei pom.xml
) enthält, um die Cloud Functions-Funktion mit einem Speichertrigger bereitzustellen.
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
Einfach loslegen (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
Ersetzen Sie Folgendes:
- RUNTIME: eine Laufzeit, die auf Ubuntu 18.04 oder höher basiert
- REGION: Der Name der Google Cloud-Region, in der Sie die Funktion bereitstellen möchten (z. B.
us-west1
). - YOUR_INPUT_BUCKET_NAME: Der Name des Cloud Storage-Buckets zum Hochladen von Bildern.
- YOUR_OUTPUT_BUCKET_NAME: Der Name des Buckets, in dem die unkenntlich gemachten Bilder gespeichert werden sollen.
Geben Sie beim Bereitstellen von Funktionen der 2. Generation nur den Bucket-Namen ohne das führende gs://
an, z. B. --trigger-event-filters="bucket=my-bucket"
.
Bild hochladen
Laden Sie ein anstößiges Bild hoch, z. B. dieses Bild eines blutrünstigen Zombies:
gsutil cp zombie.jpg gs://YOUR_INPUT_BUCKET_NAME
Dabei ist
YOUR_INPUT_BUCKET_NAME
der Cloud Storage-Bucket, den Sie zuvor zum Hochladen von Bildern erstellt haben.Die Analyse des Bildes sollte in den Logs angezeigt werden:
gcloud beta functions logs read YOUR_FUNCTION_NAME --gen2 --limit=100
Sie können sich die unkenntlich gemachten Bilder im Cloud Storage-Bucket
YOUR_OUTPUT_BUCKET_NAME
ansehen, den Sie zuvor erstellt haben.
Bereinigen
Damit Ihrem Google Cloud-Konto die in dieser Anleitung verwendeten Ressourcen nicht in Rechnung gestellt werden, löschen Sie entweder das Projekt, das die Ressourcen enthält, oder Sie behalten das Projekt und löschen die einzelnen Ressourcen.
Projekt löschen
Am einfachsten vermeiden Sie weitere Kosten durch Löschen des für die Anleitung erstellten Projekts.
So löschen Sie das Projekt:
- 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.
Cloud Functions-Funktion löschen
Durch das Löschen von Cloud Functions-Funktionen werden keine in Cloud Storage gespeicherten Ressourcen entfernt.
Führen Sie den folgenden Befehl aus, um die in dieser Anleitung bereitgestellte Funktion zu löschen:
Node.js
gcloud functions delete nodejs-blur-function --gen2 --region REGION
Python
gcloud functions delete python-blur-function --gen2 --region REGION
Einfach loslegen (Go)
gcloud functions delete go-blur-function --gen2 --region REGION
Java
gcloud functions delete java-blur-function --gen2 --region REGION
Sie können Cloud Functions-Funktionen auch über die Google Cloud Console löschen.