本教程演示了如何使用 Cloud Run functions、Vision API 和 ImageMagick 检测上传到 Cloud Storage 存储桶的令人反感的图片并对其进行模糊处理。
目标
- 部署存储触发的 CloudEvent 函数。
- 使用 Vision API 检测暴力或成人内容。
- 使用 ImageMagick 对令人反感的图片进行模糊处理。
- 上传一张肉食僵尸的图片来测试函数。
费用
在本文档中,您将使用 Google Cloud 的以下收费组件:
- Cloud Run functions
- Cloud Storage
- Cloud Vision
- Cloud Build
- Pub/Sub
- Artifact Registry
- Eventarc
- Cloud Logging
For details, see Cloud Run functions pricing.
准备工作
- 登录您的 Google Cloud 账号。如果您是 Google Cloud 新手,请创建一个账号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金,用于运行、测试和部署工作负载。
-
In the Google Cloud console, on the project selector page, select or create a 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.
-
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
- 准备开发环境。
如果您已经安装 gcloud CLI,请运行以下命令进行更新:
gcloud components update
直观呈现数据流
ImageMagick 教程应用中的数据流涉及以下几个步骤:
- 将图片上传到 Cloud Storage 存储桶。
- Cloud Run functions 函数使用 Cloud Vision API 分析图片。
- 如果检测到暴力或成人内容,Cloud Run functions 函数会使用 ImageMagick 对图片进行模糊处理。
- 经过模糊处理的图片会上传到其他 Cloud Storage 存储桶以供使用。
准备应用
创建一个区域级 Cloud Storage 存储桶以上传图片,其中
YOUR_INPUT_BUCKET_NAME
是全局唯一的存储桶名称,REGION
是您计划在其中部署函数的区域:gcloud storage buckets create gs://YOUR_INPUT_BUCKET_NAME --location=REGION
创建一个区域级 Cloud Storage 存储桶以接收经过模糊处理的图片,其中
YOUR_OUTPUT_BUCKET_NAME
是全局唯一的存储桶名称,REGION
是您计划在其中部署函数的区域:gcloud storage buckets create gs://YOUR_OUTPUT_BUCKET_NAME --location=REGION
将示例应用代码库克隆到本地机器:
Node.js
git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples.git
或者,您也可以下载该示例的 zip 文件并将其解压缩。
Python
git clone https://github.com/GoogleCloudPlatform/python-docs-samples.git
或者,您也可以下载该示例的 zip 文件并将其解压缩。
Go
git clone https://github.com/GoogleCloudPlatform/golang-samples.git
或者,您也可以下载该示例的 zip 文件并将其解压缩。
Java
git clone https://github.com/GoogleCloudPlatform/java-docs-samples.git
或者,您也可以下载该示例的 zip 文件并将其解压缩。
切换到包含 Cloud Run 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/
了解代码
ImageMagick 示例包含依赖项和两个不同的函数。第一个函数分析图片,如果图片包含暴力或成人内容,第二个函数会对图片进行模糊处理。
导入依赖项
应用必须导入多个依赖项才能与 Google Cloud 服务、ImageMagick 和文件系统进行交互:
对于大多数运行时,ImageMagick 及其命令行工具 convert
默认包含在 Cloud Run functions 执行环境中。对于 PHP,您可能需要进行一些手动配置。请注意,Cloud Run functions 不支持安装自定义系统级软件包。
Node.js
Python
Go
Java
分析图片
当图片上传到您为图片输入创建的 Cloud Storage 存储桶时,系统会调用以下函数。该函数使用 Vision API 检测上传的图片中的暴力或成人内容。
Node.js
Python
Go
Java
对图片进行模糊处理
当在上传的图片中检测到暴力或成人内容时,系统将调用以下函数。该函数会下载令人反感的图片,使用 ImageMagick 对图片进行模糊处理,然后将经过模糊处理的图片上传到输出存储桶。
Node.js
Python
Go
Java
部署该函数
如需使用存储触发器部署 Cloud Run functions 函数,请在包含示例代码(如果是 Java,则为 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
替换以下内容:
- RUNTIME:基于 Ubuntu 18.04 或更高版本的运行时
- REGION:要在其中部署函数的 Google Cloud 区域的名称(例如
us-west1
)。 - YOUR_INPUT_BUCKET_NAME:用于上传图片的 Cloud Storage 存储桶的名称。
- YOUR_OUTPUT_BUCKET_NAME:经过模糊处理的图片应保存到的存储桶的名称。
部署 Cloud Run functions 时,请仅指定不含前导 gs://
的存储桶名称;例如 --trigger-event-filters="bucket=my-bucket"
。
上传图片
上传一张令人反感的图片,比如这张肉食僵尸图片:
gcloud storage cp zombie.jpg gs://YOUR_INPUT_BUCKET_NAME
其中
YOUR_INPUT_BUCKET_NAME
是您之前为了上传图片而创建的 Cloud Storage 存储桶。您应该会在日志中看到图片分析:
gcloud beta functions logs read YOUR_FUNCTION_NAME --gen2 --limit=100
您可以在之前创建的
YOUR_OUTPUT_BUCKET_NAME
Cloud Storage 存储桶中查看经过模糊处理的图片。
清理
为避免因本教程中使用的资源导致您的 Google Cloud 账号产生费用,请删除包含这些资源的项目,或者保留项目但删除各个资源。
删除项目
为了避免产生费用,最简单的方法是删除您为本教程创建的项目。
要删除项目,请执行以下操作:
- 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 Run functions 函数
删除 Cloud Run functions 函数不会移除存储在 Cloud Storage 中的任何资源。
如需删除您在本教程中部署的函数,请运行以下命令:
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
您也可以通过 Google Cloud 控制台删除 Cloud Run functions。