이 튜토리얼에서는 Cloud Run Functions, Cloud Vision API, ImageMagick을 사용하여 Cloud Storage 버킷에 업로드되는 이미지 중 불쾌감을 주는 이미지를 감지하고 이를 흐리게 처리하는 방법을 설명합니다.
목표
- 저장소에서 트리거된 백그라운드 Cloud Run 함수를 배포합니다.
- Vision API를 사용하여 폭력적인 콘텐츠 또는 성인 콘텐츠 탐지하기
- ImageMagick을 사용하여 불쾌감을 주는 이미지를 흐리게 처리합니다.
- 살점을 뜯어먹는 좀비 이미지를 업로드하여 해당 함수 테스트하기
비용
이 문서에서는 비용이 청구될 수 있는 다음과 같은 Google Cloud 구성요소를 사용합니다.
- Cloud Run functions
- Cloud Storage
- Cloud Vision
프로젝트 사용량을 기준으로 예상 비용을 산출하려면 가격 계산기를 사용하세요.
시작하기 전에
- 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, Cloud Storage, and Cloud Vision 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, Cloud Storage, and Cloud Vision APIs.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
개발 환경을 준비합니다.
Node.js
Python
Go
Java
C#
Ruby
PHP
gcloud CLI가 이미 설치되어 있으면 다음 명령어를 실행하여 업데이트합니다.
gcloud components update
데이터 흐름 시각화
ImageMagick 튜토리얼 애플리케이션의 데이터 흐름 단계는 다음과 같습니다.
- 이미지가 Cloud Storage 버킷에 업로드됩니다.
- 이 함수는 Vision API를 사용하여 이미지를 분석합니다.
- 폭력적인 콘텐츠 또는 성인 콘텐츠가 감지될 경우 함수는 ImageMagick을 사용하여 해당 이미지를 흐리게 처리합니다.
- 흐리게 처리된 이미지는 다른 Cloud Storage 버킷에 업로드되어 사용됩니다.
애플리케이션 준비
이미지를 업로드할 Cloud Storage 버킷을 만듭니다.
YOUR_INPUT_BUCKET_NAME
은 전역적으로 고유한 버킷 이름입니다.gcloud storage buckets create gs://YOUR_INPUT_BUCKET_NAME
흐리게 처리된 이미지를 수신할 Cloud Storage 버킷을 만듭니다.
YOUR_OUTPUT_BUCKET_NAME
은 전역적으로 고유한 버킷 이름입니다.gcloud storage buckets create gs://YOUR_OUTPUT_BUCKET_NAME
샘플 앱 저장소를 로컬 머신에 클론합니다.
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 파일로 샘플을 다운로드하고 압축을 풀 수 있습니다.
C#
git clone https://github.com/GoogleCloudPlatform/dotnet-docs-samples.git
또는 zip 파일로 샘플을 다운로드하고 압축을 풀 수 있습니다.
Ruby
git clone https://github.com/GoogleCloudPlatform/ruby-docs-samples.git
또는 zip 파일로 샘플을 다운로드하고 압축을 풀 수 있습니다.
PHP
git clone https://github.com/GoogleCloudPlatform/php-docs-samples.git
또는 zip 파일로 샘플을 다운로드하고 압축을 풀 수 있습니다.
Cloud Run Functions 샘플 코드가 포함된 디렉터리로 변경합니다.
Node.js
cd nodejs-docs-samples/functions/imagemagick/
Python
cd python-docs-samples/functions/imagemagick/
Go
cd golang-samples/functions/imagemagick/
자바
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/
코드 이해하기
종속 항목 가져오기
애플리케이션은 Google Cloud 서비스, ImageMagick, 파일 시스템과 상호 작용하기 위해 몇 가지 종속 항목을 가져와야 합니다.
Node.js
Python
Go
자바
C#
Ruby
PHP
이미지 분석
다음 함수는 이미지를 저장하기 위해 만든 Cloud Storage 버킷에 이미지가 업로드될 때 호출됩니다. 해당 함수는 Vision API를 사용하여 업로드된 이미지에서 폭력적인 콘텐츠 또는 성인 콘텐츠를 감지합니다.
Node.js
Python
Go
자바
C#
Ruby
PHP
이미지 흐리게 처리하기
업로드된 이미지에서 폭력적인 콘텐츠나 성인 콘텐츠가 감지되면 다음 함수가 호출됩니다. 해당 함수는 불쾌감을 주는 이미지를 다운로드하고 ImageMagick을 사용하여 이미지를 흐리게 처리한 다음, 해당 이미지를 업로드하여 원본 이미지를 덮어씁니다.
Node.js
Python
Go
자바
C#
Ruby
PHP
함수 배포
스토리지 트리거를 사용하여 함수를 배포하려면 샘플 코드가 포함된 디렉터리(또는 Java의 경우 pom.xml
파일)에서 다음 명령어를 실행합니다.
Node.js
gcloud functions deploy blurOffensiveImages \ --no-gen2 \ --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 \ --no-gen2 \ --runtime=RUNTIME \ --trigger-bucket=YOUR_INPUT_BUCKET_NAME \ --set-env-vars=BLURRED_BUCKET_NAME=YOUR_OUTPUT_BUCKET_NAME
Go
gcloud functions deploy BlurOffensiveImages \ --no-gen2 \ --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 \ --no-gen2 \ --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 \ --no-gen2 \ --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 \ --no-gen2 \ --runtime=RUNTIME \ --trigger-bucket=YOUR_INPUT_BUCKET_NAME \ --set-env-vars=BLURRED_BUCKET_NAME=YOUR_OUTPUT_BUCKET_NAME
PHP
gcloud functions deploy blurOffensiveImages \ --no-gen2 \ --runtime=RUNTIME \ --trigger-bucket=YOUR_INPUT_BUCKET_NAME \ --set-env-vars=BLURRED_BUCKET_NAME=YOUR_OUTPUT_BUCKET_NAME
다음을 바꿉니다.
RUNTIME
: Ubuntu 18.04를 기반으로 하는 런타임(이후 런타임에는 ImageMagick에 대한 지원이 포함되지 않음)YOUR_INPUT_BUCKET_NAME
: 이미지를 업로드할 Cloud Storage 버킷의 이름YOUR_OUTPUT_BUCKET_NAME
: 흐리게 처리된 이미지를 저장할 버킷의 이름
이 특정 예시에서는 deploy
명령어에 버킷 이름의 일부로 gs://
를 포함하지 마세요.
이미지 업로드
살점을 뜯어먹는 좀비와 같은 불쾌감을 주는 이미지를 업로드합니다.
gcloud storage cp zombie.jpg gs://YOUR_INPUT_BUCKET_NAME
여기서,
YOUR_INPUT_BUCKET_NAME
은 이미지를 업로드하기 위해 앞서 만든 Cloud Storage 버킷입니다.로그를 확인하여 실행이 완료되었는지 확인합니다.
gcloud functions logs read --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 Storage에 저장된 리소스는 삭제되지 않습니다.
이 튜토리얼에서 배포한 함수를 삭제하려면 다음 명령어를 실행합니다.
Node.js
gcloud functions delete blurOffensiveImages
Python
gcloud functions delete blur_offensive_images
Go
gcloud functions delete BlurOffensiveImages
자바
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
Google Cloud 콘솔에서 Cloud Run Functions를 삭제할 수도 있습니다.