コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。
クイックスタート: Cloud Storage から直接イベントを受信する（gcloud CLI）

Cloud Storage から直接イベントを受信する（gcloud CLI）

このクイックスタートでは、Cloud Audit Logs を使用せずに、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 CLI をインストールします。

  3. gcloud CLI を初期化するには:

    gcloud init

  4. Google Cloud プロジェクトを作成または選択します。

    • Cloud プロジェクトを作成します。

      gcloud projects create PROJECT_ID

    • 作成した Cloud プロジェクトを選択します。

      gcloud config set project PROJECT_ID

  5. Cloud プロジェクトに対して課金が有効になっていることを確認します。詳しくは、プロジェクトで課金が有効になっているかどうかを確認する方法をご覧ください。

  6. Cloud Build, Cloud Logging, Cloud Run, Cloud Storage, Eventarc, and Pub/Sub API を有効にします。 

    gcloud services enable run.googleapis.comlogging.googleapis.comcloudbuild.googleapis.comstorage.googleapis.compubsub.googleapis.comeventarc.googleapis.com
    7.
  7. Google Cloud CLI をインストールします。

  8. gcloud CLI を初期化するには:

    gcloud init

  9. Google Cloud プロジェクトを作成または選択します。

    • Cloud プロジェクトを作成します。

      gcloud projects create PROJECT_ID

    • 作成した Cloud プロジェクトを選択します。

      gcloud config set project PROJECT_ID

  10. Cloud プロジェクトに対して課金が有効になっていることを確認します。詳しくは、プロジェクトで課金が有効になっているかどうかを確認する方法をご覧ください。

  11. Cloud Build, Cloud Logging, Cloud Run, Cloud Storage, Eventarc, and Pub/Sub API を有効にします。 

    gcloud services enable run.googleapis.comlogging.googleapis.comcloudbuild.googleapis.comstorage.googleapis.compubsub.googleapis.comeventarc.googleapis.com
    12.

  12. gcloud コンポーネントを更新します。
    gcloud components update

  13. 自分のアカウントでログインします。 
    gcloud auth login

  14. このクイックスタートで使用する構成変数を設定します。
    gcloud config set run/region us-central1
gcloud config set run/platform managed
gcloud config set eventarc/location us-central1

  15. 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'

  16. 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 の [ダッシュボード] ページで確認できます。

  17. 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

    Java

    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 プロジェクトを削除します。

サービスが使用されていない場合、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 またはプロジェクト番号に置き換えます。

次のステップ