コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

Eventarc トリガー

Cloud Functions(第 2 世代)では、Eventarc トリガーを使用して、Eventarc でサポートされているイベントタイプで関数をトリガーできます。関数に Eventarc トリガーを指定するときに、イベント フィルタを設定します。フィルタに一致するイベントが発生するたびに、関数が呼び出されます。

Cloud Functions(第 2 世代)のすべてのイベント ドリブン関数は、Eventarc トリガーを使用します。詳細については、Eventarc のドキュメントの Eventarc トリガーをご覧ください。サポートされているイベントタイプの一覧については、Eventarc でサポートされているイベントタイプをご覧ください。

Eventarc トリガーを使用するには、CloudEvent 関数として実装する必要があります。イベントデータは CloudEvents 形式で関数に渡されます。CloudEvent データ ペイロードはイベントタイプに対応しています。Google イベント リポジトリには、イベントデータを処理するための追加のリソースが含まれています。

トリガーのロケーション

Eventarc トリガーは特定のロケーションにリンクされます。一般に、Eventarc トリガーのロケーションは、イベントをモニタリングする Google Cloud リソースのロケーションと一致する必要があります。ほとんどの場合、Cloud Functions の関数を同じリージョンにデプロイする必要があります。Eventarc トリガーのロケーションの詳細については、Eventarc のロケーションについてをご覧ください。

トリガー ID

Eventarc トリガーはサービス アカウントにリンクされ、関数を呼び出すときに ID として使用します。Eventarc トリガーのサービス アカウントには、関数を呼び出す権限が必要です。デフォルトでは、デフォルトのコンピューティング サービス アカウントが使用されます。

デプロイ

関数のデプロイ時に Eventarc トリガーを指定できます。関数をデプロイする一般的な手順については、Cloud Functions の関数のデプロイをご覧ください。デプロイ中に Eventarc トリガーを構成するための追加情報については、以下をご覧ください。

gcloud

gcloud CLI を使用してデプロイする場合は、以下のフラグを使用して Eventarc トリガーを構成します。

gcloud functions deploy YOUR_FUNCTION_NAME \
--gen2 \
--trigger-event-filters=EVENTARC_EVENT_FILTERS \
[--trigger-location=EVENTARC_TRIGGER_LOCATION] \
[--trigger-service-account=EVENTARC_TRIGGER_SERVICE_ACCOUNT] \
[--retry] \
...
  • --gen2 フラグは、Cloud Functions(第 2 世代)にデプロイすることを指定します。Eventarc トリガーを使用するには、Cloud Functions(第 2 世代)を使用する必要があります。
  • --trigger-event-filters フラグには、トリガーがモニタリングするイベント フィルタを指定します。フィルタに一致するイベントにより、関数の呼び出しがトリガーされます。複数のフィルタを追加するには、このフラグを複数回指定します。各フィルタは ATTRIBUTE=VALUE の形式にする必要があります。イベントタイプを指定するには、少なくともフィルタ type=EVENT_TYPE が必要です。
  • --trigger-location フラグには、Eventarc トリガーのロケーションを指定します。詳しくは、トリガーのロケーションをご覧ください。指定しない場合、関数のリージョンがトリガーのロケーションとして使用されます。
  • --trigger-service-account フラグには、Eventarc トリガーの ID として使用するサービス アカウントを指定します。詳細については、トリガー ID をご覧ください。
  • --retry フラグは、失敗した関数呼び出しを自動的に再試行するかどうかを制御します。詳細については、イベント ドリブン関数の再試行をご覧ください。

Eventarc のドキュメントには、さまざまなタイプのイベントにイベント フィルタを指定する例が記載されています。gcloud を使用してトリガーを作成するをご覧ください。

コンソール

Google Cloud コンソールを使用してデプロイする場合は、環境として第 2 世代を選択する必要があります。その後、[トリガー] セクションで Eventarc トリガーを構成できます。

  1. イベント トリガーを追加するには、[Eventarc トリガーを追加] をクリックします。[Eventarc トリガー] ペインが開きます。
  2. [イベント プロバイダ] フィールドで、関数をトリガーするタイプのイベントを生成するプロダクトを選択します。
  3. [イベント] フィールドでイベントタイプを選択し、選択したイベントタイプの追加フィールドを完了します。
  4. [リージョン] フィールドで、Eventarc トリガーのロケーションを選択します(該当する場合)。詳しくは、トリガーのロケーションをご覧ください。
  5. 必要に応じて、[サービス アカウント] フィールドで、Eventarc トリガーの ID として使用するサービス アカウントを選択します。詳細については、トリガー ID をご覧ください。
  6. [失敗時に再試行する] チェックボックスをオンまたはオフにして、失敗した関数の呼び出しを自動的に再試行するかどうかを制御します。詳細については、イベント ドリブン関数の再試行をご覧ください。
  7. [トリガーを保存] をクリックします。

次のステップ