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.
Ziele
- Eine durch Cloud Storage ausgelöste Hintergrundfunktion von Cloud Functions bereitstellen
- Gewalttätige 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 dieser Anleitung werden kostenpflichtige Komponenten der Cloud Platform verwendet, darunter:
- Google Cloud Functions
- Google Cloud Storage
- Google Cloud Vision API
Mit unserem Preisrechner können Sie eine Kostenschätzung für Ihre voraussichtliche Nutzung erstellen.
Neuen Cloud Platform-Nutzern steht möglicherweise eine kostenlose Testversion zur Verfügung.Hinweis
-
Melden Sie sich bei Ihrem Google-Konto an.
Wenn Sie noch kein Konto haben, melden Sie sich hier für ein neues Konto an.
-
Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.
-
Die Abrechnung für das Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für Ihr Projekt aktiviert ist.
- Cloud Functions, Cloud Build, Cloud Storage, and Cloud Vision APIs aktivieren.
- Installieren und initialisieren Sie das Cloud SDK.
- Bereiten Sie die Entwicklungsumgebung vor.
Wenn Sie das Cloud SDK bereits installiert haben, aktualisieren Sie es 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 Cloud Storage-Bucket zum Hochladen von Bildern. Dabei sollte
YOUR_INPUT_BUCKET_NAME
ein global eindeutiger Bucket-Name sein:gsutil mb gs://YOUR_INPUT_BUCKET_NAME
Erstellen Sie einen Cloud Storage-Bucket zum Ablegen unkenntlich gemachter Bilder. Dabei sollte
YOUR_OUTPUT_BUCKET_NAME
ein global eindeutiger Bucket-Name sein:gsutil mb 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.
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.
C#
git clone https://github.com/GoogleCloudPlatform/dotnet-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/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/
Code verstehen
Abhängigkeiten importieren
Die Anwendung muss mehrere Abhängigkeiten importieren, um mit Google Cloud Platform-Diensten, ImageMagick und dem Dateisystem zu kommunizieren:
Node.js
Python
Go
Java
C#
Bilder analysieren
Die folgende Funktion wird aufgerufen, wenn ein Bild in den Cloud Storage-Bucket hochgeladen wird, den Sie zum Speichern von Bildern erstellt haben. Die Funktion verwendet die Cloud Vision API, um gewalttätige oder nicht jugendfreie Inhalte in hochgeladenen Bildern zu erkennen.
Node.js
Python
Go
Java
C#
Bilder unkenntlich machen
Die folgende Funktion wird aufgerufen, wenn in einem hochgeladenen Bild gewalttätige 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 hoch, um das Originalbild zu überschreiben.
Node.js
Python
Go
Java
C#
Funktion bereitstellen
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 blurOffensiveImages \ --runtime nodejs10 \
Mit den folgenden Werten für das Flag
--trigger-bucket YOUR_INPUT_BUCKET_NAME \
--set-env-vars BLURRED_BUCKET_NAME=YOUR_OUTPUT_BUCKET_NAME--runtime
können Sie Ihre bevorzugte Version von Node.js festlegen:nodejs10
nodejs12
nodejs14
(öffentliche Vorschau)
Python
gcloud functions deploy blur_offensive_images \ --runtime python38 \
Mit den folgenden Werten für das Flag
--trigger-bucket YOUR_INPUT_BUCKET_NAME \
--set-env-vars BLURRED_BUCKET_NAME=YOUR_OUTPUT_BUCKET_NAME--runtime
können Sie Ihre bevorzugte Version von Python festlegen:python37
python38
python39
(öffentliche Vorschau)
Go
gcloud functions deploy BlurOffensiveImages \ --runtime go113 \
Mit diesen Werten für das Flag
--trigger-bucket YOUR_INPUT_BUCKET_NAME \
--set-env-vars BLURRED_BUCKET_NAME=YOUR_OUTPUT_BUCKET_NAME--runtime
können Sie Ihre bevorzugte Version von Go festlegen:go111
(veraltet)go113
Java
gcloud functions deploy java-blur-function \ --entry-point functions.ImageMagick \ --runtime java11 \ --memory 512MB \
--trigger-bucket YOUR_INPUT_BUCKET_NAME \
--set-env-vars BLURRED_BUCKET_NAME=YOUR_OUTPUT_BUCKET_NAMEC#
gcloud functions deploy csharp-blur-function \ --entry-point ImageMagick.Function \ --runtime dotnet3 \
--trigger-bucket YOUR_INPUT_BUCKET_NAME \
--set-env-vars BLURRED_BUCKET_NAME=YOUR_OUTPUT_BUCKET_NAMEDabei ist
YOUR_INPUT_BUCKET_NAME
der Name des Cloud Storage-Buckets zum Hochladen von Bildern undYOUR_OUTPUT_BUCKET_NAME
der Name des Buckets, in dem die unkenntlich gemachten Bilder gespeichert werden sollen.Mit dem Flag
--allow-unauthenticated
können Sie die Funktion ohne Authentifizierung aufrufen. Wenn Sie eine Authentifizierung anfordern möchten, lassen Sie das Flag weg.
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.Prüfen Sie in den Logs, dass die Ausführungen abgeschlossen wurden:
gcloud functions logs read --limit 100
Sie können 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 behalten Sie das Projekt und löschen Sie die einzelnen Ressourcen.
Projekt löschen
Am einfachsten vermeiden Sie weitere Kosten, wenn Sie das zum Ausführen der Anleitung erstellte Projekt löschen.
So löschen Sie das Projekt:
- Wechseln Sie in der Cloud Console zur Seite Ressourcen verwalten.
- Wählen Sie in der Projektliste das Projekt aus, das Sie löschen möchten, und klicken Sie dann auf Löschen.
- Geben Sie im Dialogfeld die Projekt-ID ein und klicken Sie auf Shut down (Beenden), um das Projekt zu löschen.
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 Cloud Functions-Funktion zu löschen:
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
Sie können Cloud Functions-Funktionen auch über die Google Cloud Console löschen.