ImageMagick 가이드

이 가이드에서는 Cloud Functions, Google Cloud Vision API, ImageMagick을 사용하여 Cloud Storage 버킷에 업로드되는 이미지 중 불쾌감을 주는 이미지를 감지하고 이를 흐리게 처리하는 방법을 설명합니다.

목표

  • 저장소에서 트리거한 백그라운드 Cloud Functions를 배포합니다.
  • Cloud Vision API를 사용하여 폭력적인 콘텐츠 또는 성인 콘텐츠를 감지합니다.
  • ImageMagick을 사용하여 불쾌감을 주는 이미지를 흐리게 처리합니다.
  • 살점을 뜯어먹는 좀비 이미지를 업로드하여 해당 함수를 테스트합니다.

비용

이 가이드에서는 비용이 청구될 수 있는 다음과 같은 Cloud Platform 구성요소를 사용합니다.

  • Google Cloud Functions
  • Google Cloud Storage
  • Google Cloud Vision API

가격 계산기를 사용하여 예상 사용량을 기준으로 예상 비용을 산출합니다.

새 Cloud Platform 사용자는 무료 평가판을 사용할 수 있습니다.

시작하기 전에

  1. Google 계정에 로그인합니다.

    아직 계정이 없으면 새 계정을 등록하세요.

  2. Google Cloud Platform 프로젝트를 선택하거나 만듭니다.

    리소스 관리 페이지로 이동

  3. Google Cloud Platform 프로젝트에 결제가 사용 설정되어 있는지 확인하세요.

    결제 사용 설정 방법 알아보기

  4. Cloud Functions, Cloud Storage, Cloud Vision APIs를 사용 설정합니다.

    APIs 사용 설정

  5. Cloud SDK 설치 및 초기화.
  6. gcloud 구성요소를 업데이트 및 설치합니다.
    gcloud components update &&
    gcloud components install beta
  7. Node.js 개발을 위한 환경을 준비합니다.

    설정 가이드로 이동

데이터 흐름 시각화

ImageMagick 가이드 애플리케이션의 데이터 흐름 단계는 다음과 같습니다.

  1. 이미지가 Cloud Storage 버킷에 업로드됩니다.
  2. Cloud Functions는 Cloud Vision API를 사용하여 해당 이미지를 분석합니다.
  3. 폭력적인 콘텐츠 또는 성인 콘텐츠가 감지될 경우 Cloud Functions는 ImageMagick을 사용하여 해당 이미지를 흐리게 처리합니다.
  4. 흐리게 처리된 이미지가 업로드되어 Cloud Storage 버킷의 원본 이미지를 덮어씁니다.

애플리케이션 준비

  1. 이미지를 업로드할 Cloud Storage 버킷을 만듭니다. [YOUR_IMAGE_BUCKET_NAME]은/는 전역적으로 고유한 버킷 이름입니다.

    gsutil mb gs://[YOUR_IMAGE_BUCKET_NAME]
    

  2. 로컬 시스템에 애플리케이션 코드를 저장할 디렉토리를 만듭니다.

    Linux 또는 Mac OS X

    디렉토리를 만듭니다.

    mkdir ~/gcf_imagemagick

    해당 디렉토리로 이동합니다.

    cd ~/gcf_imagemagick

    Windows(CMD)

    디렉토리를 만듭니다.

    mkdir %HOMEDRIVE%%HOMEPATH%\gcf_imagemagick

    해당 디렉토리로 이동합니다.

    cd %HOMEDRIVE%%HOMEPATH%\gcf_imagemagick

  3. GitHub의 Cloud Functions 샘플 프로젝트에서 index.jspackage.json 파일을 모두 다운로드하여 gcf_imagemagick 디렉토리에 저장합니다.

코드 이해하기

종속 항목 가져오기

애플리케이션은 Google Cloud Platform 서비스, ImageMagick, 파일 시스템과 상호 작용하기 위해 몇 가지 종속성을 가져와야 합니다.

Node.js

const exec = require('child_process').exec;
const fs = require('fs');
const path = require('path');
const storage = require('@google-cloud/storage')();
const vision = require('@google-cloud/vision').v1p1beta1;

const client = new vision.ImageAnnotatorClient();

이미지 분석

다음 함수는 이미지를 저장하기 위해 만든 Cloud Storage 버킷에 이미지가 업로드될 때 호출됩니다. 해당 함수는 Cloud Vision API를 사용하여 업로드된 이미지에서 폭력적인 콘텐츠 또는 성인 콘텐츠를 감지합니다.

Node.js

// Blurs uploaded images that are flagged as Adult or Violence.
exports.blurOffensiveImages = (event) => {
  const object = event.data;

  // Exit if this is a deletion or a deploy event.
  if (object.resourceState === 'not_exists') {
    console.log('This is a deletion event.');
    return;
  } else if (!object.name) {
    console.log('This is a deploy event.');
    return;
  }

  const file = storage.bucket(object.bucket).file(object.name);
  const filePath = `gs://${object.bucket}/${object.name}`;

  console.log(`Analyzing ${file.name}.`);

  return client.safeSearchDetection(filePath)
    .catch((err) => {
      console.error(`Failed to analyze ${file.name}.`, err);
      return Promise.reject(err);
    })
    .then(([result]) => {
      const detections = result.safeSearchAnnotation;

      if (detections.adult === 'VERY_LIKELY' ||
          detections.violence === 'VERY_LIKELY') {
        console.log(`The image ${file.name} has been detected as inappropriate.`);
        return blurImage(file);
      } else {
        console.log(`The image ${file.name} has been detected as OK.`);
      }
    });
};

이미지 흐리게 처리하기

업로드된 이미지에서 폭력적인 콘텐츠나 성인 콘텐츠가 감지되면 다음 함수가 호출됩니다. 해당 함수는 불쾌감을 주는 이미지를 다운로드하고 ImageMagick을 사용하여 이미지를 흐리게 처리한 다음, 해당 이미지를 업로드하여 원본 이미지를 덮어씁니다.

Node.js

// Blurs the given file using ImageMagick.
function blurImage (file) {
  const tempLocalFilename = `/tmp/${path.parse(file.name).base}`;

  // Download file from bucket.
  return file.download({ destination: tempLocalFilename })
    .catch((err) => {
      console.error('Failed to download file.', err);
      return Promise.reject(err);
    })
    .then(() => {
      console.log(`Image ${file.name} has been downloaded to ${tempLocalFilename}.`);

      // Blur the image using ImageMagick.
      return new Promise((resolve, reject) => {
        exec(`convert ${tempLocalFilename} -channel RGBA -blur 0x24 ${tempLocalFilename}`, { stdio: 'ignore' }, (err, stdout) => {
          if (err) {
            console.error('Failed to blur image.', err);
            reject(err);
          } else {
            resolve(stdout);
          }
        });
      });
    })
    .then(() => {
      console.log(`Image ${file.name} has been blurred.`);

      // Upload the Blurred image back into the bucket.
      return file.bucket.upload(tempLocalFilename, { destination: file.name })
        .catch((err) => {
          console.error('Failed to upload blurred image.', err);
          return Promise.reject(err);
        });
    })
    .then(() => {
      console.log(`Blurred image has been uploaded to ${file.name}.`);

      // Delete the temporary file.
      return new Promise((resolve, reject) => {
        fs.unlink(tempLocalFilename, (err) => {
          if (err) {
            reject(err);
          } else {
            resolve();
          }
        });
      });
    });
}

함수 배포

  1. 저장소 트리거를 사용하여 blurOffensiveImages 함수를 배포하려면 gcf_imagemagick 디렉토리에서 다음 명령어를 실행합니다.

    gcloud beta functions deploy blurOffensiveImages --trigger-bucket [YOUR_IMAGE_BUCKET_NAME]
    

    여기에서

    • [YOUR_IMAGE_BUCKET_NAME]은 이미지를 업로드할 Cloud Storage 버킷의 이름입니다.

이미지 업로드

  1. 살점을 뜯어먹는 좀비와 같은 불쾌감을 주는 이미지를 업로드합니다.

    gsutil cp zombie.jpg gs://[YOUR_IMAGE_BUCKET_NAME]
    

    [YOUR_IMAGE_BUCKET_NAME]은/는 이미지를 업로드하기 위해 앞서 만든 Cloud Storage 버킷입니다.

  2. 로그를 확인하여 실행이 완료되었는지 확인합니다.

    gcloud beta functions logs read --limit 100
    

  3. 이미지를 업로드하기 위해 앞서 만든 Cloud Storage 버킷에서 이미지가 흐리게 처리된 것을 볼 수 있습니다.

삭제

이 가이드에서 사용한 리소스 비용이 Google Cloud Platform 계정에 청구되지 않도록 하는 방법은 다음과 같습니다.

프로젝트 삭제

청구되지 않도록 하는 가장 쉬운 방법은 가이드에서 만든 프로젝트를 삭제하는 것입니다.

프로젝트를 삭제하는 방법은 다음과 같습니다.

  1. GCP Console에서 프로젝트 페이지로 이동합니다.

    프로젝트 페이지로 이동

  2. 프로젝트 목록에서 삭제할 프로젝트를 선택하고 삭제를 클릭합니다.
  3. 대화상자에서 프로젝트 ID를 입력한 다음 종료를 클릭하여 프로젝트를 삭제합니다.

Cloud Functions 삭제

Cloud Functions를 삭제해도 Cloud Storage에 저장된 리소스는 삭제되지 않습니다.

Cloud Functions를 삭제하려면 다음 명령어를 실행하세요.

gcloud beta functions delete [NAME_OF_FUNCTION]

[NAME_OF_FUNCTION]은/는 삭제할 함수의 이름입니다.

또한 Google Cloud Platform 콘솔에서 Cloud Functions를 삭제할 수도 있습니다.

이 페이지가 도움이 되었나요? 평가를 부탁드립니다.

다음에 대한 의견 보내기...

Cloud Functions 문서