빠른 시작: Cloud Storage에서 이벤트 수신

이 빠른 시작에서는 Cloud 감사 로그를 사용하지 않고 Eventarc를 사용하여 인증되지 않은 Cloud Run 서비스의 Cloud Storage에서 이벤트를 수신하는 방법을 보여줍니다.

객체 생성, 삭제, 보관처리, 메타데이터 업데이트와 같은 Cloud Storage 버킷 내의 다양한 이벤트에 대한 응답으로 알림 트리거를 구성할 수 있습니다.

이 빠른 시작에서는 다음을 수행합니다.

  1. 이벤트 소스로 사용할 Cloud Storage 버킷을 만듭니다.

  2. Cloud Run에 이벤트 수신자 서비스를 배포합니다.

  3. Eventarc 트리거를 만듭니다.

  4. Cloud Storage 버킷에 파일을 업로드하여 이벤트를 생성하고 Cloud Run 로그에서 확인합니다.

시작하기 전에

조직에서 Google Cloud 환경에 제약조건을 적용하면 이 문서의 일부 단계가 올바르게 작동하지 않을 수 있습니다. 이 경우 공개 IP 주소 또는 서비스 계정 키 만들기와 같은 작업을 완료하지 못할 수 있습니다. 제약조건에 대한 오류를 반환하는 요청을 수행하는 경우 제한된 Google Cloud 환경에서 애플리케이션 개발 방법을 참조하세요.

  1. Google Cloud 계정에 로그인합니다. Google Cloud를 처음 사용하는 경우 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.
  2. Google Cloud Console의 프로젝트 선택기 페이지에서 Google Cloud 프로젝트를 선택하거나 만듭니다.

    프로젝트 선택기로 이동

  3. Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다. 프로젝트에 결제가 사용 설정되어 있는지 확인하는 방법을 알아보세요.

  4. Cloud Build, Cloud Logging, Cloud Run, Cloud Storage, Eventarc, and Pub/Sub API를 사용 설정합니다.

    API 사용 설정

  5. Google Cloud Console의 프로젝트 선택기 페이지에서 Google Cloud 프로젝트를 선택하거나 만듭니다.

    프로젝트 선택기로 이동

  6. Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다. 프로젝트에 결제가 사용 설정되어 있는지 확인하는 방법을 알아보세요.

  7. Cloud Build, Cloud Logging, Cloud Run, Cloud Storage, Eventarc, and Pub/Sub API를 사용 설정합니다.

    API 사용 설정

  8. gcloud 구성요소를 업데이트합니다.
    gcloud components update
  9. 계정을 사용하여 로그인합니다.
    gcloud auth login
  10. 이 빠른 시작에서 사용되는 구성 변수를 설정합니다.
    gcloud config set project PROJECT_ID
    gcloud config set run/region us-central1
    gcloud config set run/platform managed
    gcloud config set eventarc/location us-central1
    PROJECT_ID를 Google Cloud 프로젝트 ID로 바꿉니다. 프로젝트 ID는 Google Cloud Console의 대시보드 페이지에서 찾을 수 있습니다.
  11. Cloud Storage 서비스 계정에 pubsub.publisher 역할을 부여합니다.

    SERVICE_ACCOUNT="$(gsutil kms serviceaccount -p PROJECT_ID)"
    
    gcloud projects add-iam-policy-binding PROJECT_ID \
        --member="serviceAccount:${SERVICE_ACCOUNT}" \
        --role='roles/pubsub.publisher'
    

  12. 2021년 4월 8일 이전에 Pub/Sub 서비스 계정을 사용 설정한 경우 Pub/Sub 서비스 계정에 iam.serviceAccountTokenCreator 역할을 부여합니다.

    gcloud projects add-iam-policy-binding PROJECT_ID \
        --member="serviceAccount:service-PROJECT_NUMBER@gcp-sa-pubsub.iam.gserviceaccount.com" \
        --role='roles/iam.serviceAccountTokenCreator'
    

    PROJECT_NUMBER를 Google Cloud 프로젝트 번호로 바꿉니다. Google Cloud Console의 대시보드 페이지에서 프로젝트 번호를 찾을 수 있습니다.

  13. Git 소스 코드 관리 도구를 다운로드하여 설치합니다.

Cloud Storage 버킷 만들기

이벤트 소스로 사용할 Cloud Storage 버킷을 만듭니다.

gsutil mb -l us-central1 gs://PROJECT_ID-bucket/

이벤트 소스가 생성되면 Cloud Run에 이벤트 수신자 서비스를 배포할 수 있습니다.

Cloud Run에 이벤트 수신자 서비스 배포

이벤트를 수신하고 로깅하는 Cloud Run 서비스를 배포합니다.

  1. 저장소를 클론한 후 Cloud Run 샘플 코드가 포함된 디렉터리로 변경합니다.

    Go

    git clone https://github.com/GoogleCloudPlatform/golang-samples.git
    cd golang-samples/eventarc/audit_storage
    

    자바

    git clone https://github.com/GoogleCloudPlatform/java-docs-samples.git
    cd java-docs-samples/eventarc/audit-storage
    

    .NET

    git clone https://github.com/GoogleCloudPlatform/dotnet-docs-samples.git
    cd dotnet-docs-samples/eventarc/audit-storage
    

    Node.js

    git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples.git
    cd nodejs-docs-samples/eventarc/audit-storage
    

    Python

    git clone https://github.com/GoogleCloudPlatform/python-docs-samples.git
    cd python-docs-samples/eventarc/audit-storage
    
  2. 컨테이너를 빌드하고 Cloud Build에 업로드합니다.

     gcloud builds submit --tag gcr.io/PROJECT_ID/helloworld-events
    
  3. 컨테이너 이미지를 Cloud Run에 배포합니다.

     gcloud run deploy helloworld-events \
         --image gcr.io/PROJECT_ID/helloworld-events \
         --allow-unauthenticated
    

    배포가 성공하면 명령줄에 서비스 URL이 표시됩니다.

이제 helloworld-events라는 이벤트 수신자 서비스를 Cloud Run에 배포했으므로 트리거를 설정할 수 있습니다.

Eventarc 트리거 만들기

Eventarc 트리거는 Cloud Storage 버킷의 이벤트를 helloworld-events Cloud Run 서비스로 전송합니다.

  1. Cloud Storage 이벤트를 필터링하고 Compute Engine 기본 서비스 계정을 사용하는 트리거를 만듭니다.

     gcloud eventarc triggers create storage-events-trigger \
         --destination-run-service=helloworld-events \
         --destination-run-region=us-central1 \
         --event-filters="type=google.cloud.storage.object.v1.finalized" \
         --event-filters="bucket=PROJECT_ID-bucket" \
         --service-account=PROJECT_NUMBER-compute@developer.gserviceaccount.com
    

    그러면 storage-events-trigger라는 트리거가 생성됩니다.

  2. storage-events-trigger가 성공적으로 생성되었는지 확인하려면 다음을 실행합니다.

     gcloud eventarc triggers list --location=us-central1
    

    출력은 다음과 비슷합니다.

     NAME                    TYPE                                      DESTINATION_RUN_SERVICE  DESTINATION_RUN_PATH  ACTIVE
     storage-events-trigger  google.cloud.storage.object.v1.finalized  helloworld-events                              Yes
    

이벤트 생성 및 확인

  1. 이벤트를 생성하려면 다음 안내를 따르세요.

    텍스트 파일을 Cloud Storage에 업로드합니다.

     echo "Hello World" > random.txt
     gsutil cp random.txt gs://PROJECT_ID-bucket/random.txt
    

    업로드 시 이벤트가 생성되고 Cloud Run 서비스에서 이벤트의 메시지를 로깅합니다.

  2. 로그 항목을 보려면 다음 안내를 따르세요.

    1. 로그 항목을 필터링하고 JSON 형식으로 출력을 반환합니다.

      gcloud logging read "resource.labels.service_name=helloworld-events AND textPayload:random.txt" --format=json
      
    2. 다음과 같은 로그 항목을 찾습니다.

      "textPayload": "2021/08/09 19:04:25 Detected change in Cloud Storage bucket: objects/random.txt"
      

수고하셨습니다. Cloud Run에 이벤트 수신자 서비스를 성공적으로 배포하고, Eventarc 트리거를 만들고, Cloud Storage에서 이벤트를 생성하고, 이를 Cloud Run 로그에서 확인했습니다.

삭제

이 페이지에서 사용한 리소스 비용이 Google Cloud 계정에 청구되지 않도록 하려면 다음 단계를 수행합니다.

Cloud Run에서는 서비스를 사용하지 않을 때 비용이 청구되지 않지만 Container Registry에 파일 저장, Cloud Storage 버킷에 파일 저장, Eventarc 리소스에 대한 요금은 부과될 수 있습니다.

다음 작업을 할 수 있습니다.

  1. 이미지를 삭제합니다.

  2. 스토리지 버킷을 삭제합니다.

  3. Eventarc 트리거를 삭제합니다.

또는 Google Cloud 프로젝트를 삭제하여 프로젝트 내에 사용된 모든 리소스에 대한 비용 청구를 중지할 수 있습니다.

프로젝트를 삭제하려면 다음 단계를 따르세요.

gcloud projects delete PROJECT_ID_OR_NUMBER

PROJECT_ID_OR_NUMBER를 Google Cloud 프로젝트 ID 또는 번호로 바꿉니다.

다음 단계