Eventarc トリガーを構成する

このページでは、Application Integration で Eventarc トリガーを構成する方法について説明します。

Eventarc トリガーを使用すると、 Eventarc Standard 経由で転送されたイベントに基づいて統合を実行できます。Eventarc トリガーを使用すると、さまざまな Google Cloud サービス、サードパーティサービス、カスタム イベントソースからのイベントによってトリガーされる統合フローを構築できます。たとえば、新しいオブジェクトが Cloud Storage バケットにアップロードされたときに、 トリガーを使用して統合を開始できます。

コンソールで、次の方法で Eventarc トリガーを作成して構成できます。 Google Cloud

始める前に

Eventarc トリガーを構成する前に、Eventarc API と Pub/Sub API を有効にします。

API を有効にするために必要なロール

API を有効にするには、serviceusage.services.enable 権限が必要です。プロジェクトを作成した場合は、オーナーロール（roles/owner）を介してこの権限が付与されている可能性があります。それ以外の場合は、Service Usage 管理者ロール（roles/serviceusage.serviceUsageAdmin）を介してこの権限を取得できます。ロールを付与する方法をご覧ください。

API を有効にする

考慮事項

Eventarc トリガーを構成する際は、次の点を考慮してください。

  • 構成エラーが原因で統合の公開中に Eventarc トリガーの作成に失敗した場合でも、統合は公開されますが、トリガーは有効になりません。

    この問題を解決するには、統合の公開を解除し、Eventarc トリガーの構成を慎重に確認して修正してから、統合を再公開します。 Eventarc トリガーの作成ステータスを確認するには、Google Cloud コンソール ツールバーで （通知）をクリックします。

  • Eventarc トリガー の構成を変更して統合の新しいバージョンを公開すると、古いトリガーが新しいトリガーに自動的に置き換えられます。これにより、統合では常に最新のトリガー構成が使用され、古いトリガーは削除されます。
  • 統合の新しいバージョンを公開し、同じ Eventarc トリガーとその構成を使用しても、新しいトリガーは作成されません。代わりに、既存の Eventarc トリガーが新しい統合バージョンで再利用されます。

Application Integration から Eventarc トリガーを作成する

Application Integration から Eventarc トリガー を作成する手順は次のとおりです。

  1. Application Integration で Eventarc トリガーを追加する
  2. 統合エディタで Eventarc トリガーを構成する

Eventarc トリガーを追加する

統合に Eventarc トリガーを追加する手順は次のとおりです。

  1. コンソールで、[Application Integration] ページに移動します。 Google Cloud

    Application Integration に移動

  2. ナビゲーション メニューで [統合] をクリックします。

    [統合リスト] ページが開き、Google Cloud プロジェクトで使用可能なすべての統合が一覧表示されます。

  3. 既存の統合を選択するか、[統合の作成] をクリックして新しい統合を作成します。

    新しい統合を作成する場合:

    1. [統合の作成] ペインで名前と説明を入力します。
    2. 統合のリージョンを選択します。
    3. 統合用のサービス アカウントを選択します。統合のサービス アカウントの詳細は、統合ツールバーの [統合の概要] ペインでいつでも変更または更新できます。
    4. [作成] をクリックします。

    新しく作成した統合が統合エディタ で開きます。

  4. 統合エディタ のナビゲーション バーで、[トリガー] をクリックして、使用可能なトリガーのリストを表示します。
  5. 統合エディタで [Eventarc] 要素をドラッグ＆ドロップします。

Eventarc トリガーを構成する

Eventarc トリガーを構成するには、統合エディタで [Eventarc Trigger] 要素をクリックします。[Eventarc トリガー] 構成ペインが表示され、次のフィールドが表示されます。

  • ラベル: （省略可）統合内の Eventarc トリガーの表示名。ラベルは任意の名前に変更できます。
  • 注: （省略可）トリガーに関する追加情報を提供するためにメモを追加できます。
  • [Eventarc トリガーを構成] をクリックし、[Eventarc トリガー エディタ] に次の入力を指定します。
    • トリガーの名前: トリガーの名前を入力します。
    • トリガーのタイプ: 次のいずれかのトリガータイプを選択します:
      • Google のソース: Pub/Sub、Cloud Storage、Firestore などの Google イベント プロバイダのトリガーを作成する場合は、このオプションを選択します。
      • カスタム: カスタム イベントソースのトリガーを作成する場合は、このオプションを選択します。
      • サードパーティ: Eventarc ソースを提供する Google 以外のプロバイダのトリガーを作成する場合は、このオプションを選択します。詳細については、Eventarc のサードパーティ イベントをご覧ください。
    • イベント プロバイダ: トリガーのイベント プロバイダを選択します。イベント プロバイダのリストは、トリガーのタイプによって異なります。詳細については、 イベント プロバイダと宛先をご覧ください。
    • イベントタイプ: トリガーのイベントタイプを選択します。トリガーの構成 は、選択したイベント プロバイダによって異なります。詳細については、 イベントタイプをご覧ください。
    • リージョン: トリガーのリージョンを選択します。
    • フィルタ : （省略可）フィルタを追加して、条件に一致する API を選択します。たとえば、特定の名前で API をフィルタリングすると、フィルタ条件に一致する API が更新された場合にのみイベントがトリガーされます。
    • サービス アカウント: トリガーに使用するサービス アカウントを選択します。サービス アカウントを選択しない場合、トリガーはサービスを呼び出すときに、ID として Compute Engine のデフォルトのサービス アカウントを使用します。トリガーに関連付けられたサービス アカウント には、サービスを呼び出すために必要な権限が必要です。

    • 失敗時に再試行する: 宛先でイベントを処理できなかった場合にトリガーの再試行を有効にする場合は、選択します。
    • ネットワーク アタッチメント: トリガーに使用するネットワーク アタッチメントを選択します。このリストは、プロジェクトで作成されたネットワーク アタッチメントに基づいて生成されます。

      ネットワーク アタッチメントを使用すると、サービス プロデューサー Virtual Private Cloud（VPC）ネットワークとコンシューマー VPC ネットワーク間の通信が容易になります。 Eventarc は、構成されたネットワーク アタッチメントを使用して、コンシューマーの VPC ネットワーク内でホストされている内部 HTTP エンドポイントとの接続を確立し、イベントデータを配信できるようにします。ネットワーク アタッチメントの作成と管理の詳細については、ネットワーク アタッチメントを作成して管理するをご覧ください。

  • トリガーの構成を保存するには、[トリガーを保存] をクリックします。

Eventarc コンソールを使用して Eventarc トリガーを作成する

Eventarc コンソール ページから Eventarc トリガーを作成する手順は次のとおりです。

  1. コンソールで、[Eventarc] [>] [トリガー] ページに移動します。 Google Cloud

    [トリガー] に移動

    [トリガー] ページには、プロジェクト内のすべてのトリガーが一覧表示されます。

  2. [**トリガーを作成**] をクリックします。
  3. [トリガーを作成] ページで、次の入力を指定します。
    1. トリガーの名前: トリガーの名前を入力します。
    2. トリガーのタイプ: 次のいずれかのトリガータイプを選択します:
      • Google のソース: Pub/Sub、 Cloud Storage、Firestore などの Google イベント プロバイダのトリガーを作成する場合は、このオプションを選択します。
      • カスタム: カスタム イベントソースのトリガーを作成する場合は、このオプションを選択します。
      • サードパーティ: Eventarc ソースを提供する Google 以外のプロバイダのトリガーを作成する場合は、このオプションを選択します。詳細については、Eventarc のサードパーティ イベントをご覧ください。
    3. イベント プロバイダ: トリガーのイベント プロバイダを選択します。イベント プロバイダのリストは、トリガーのタイプによって異なります。詳細については、イベント プロバイダと宛先をご覧ください。
    4. イベントタイプ: トリガーのイベントタイプを選択します。トリガーの構成は、選択したイベント プロバイダによって異なります。詳細については、イベントタイプをご覧ください。
    5. イベントデータのコンテンツ タイプ: イベント コンテンツのデータタイプを選択します。[application/json] または [application/protobuf] を選択します。
    6. リージョン: トリガーのリージョンを選択します。
    7. サービス アカウント: トリガーに使用するサービス アカウントを選択します。サービス アカウントを選択しない場合、トリガーはサービスを呼び出すときに、ID として Compute Engine のデフォルトのサービス アカウントを使用します。トリガーに関連付けられたサービス アカウントには、サービスを呼び出すために必要な権限が必要です。
    8. イベントの宛先: [Application Integration] を選択します。
    9. 統合を選択: トリガーを作成する 統合を選択します。統合が公開されている場合、Application Integration は、Eventarc トリガーを追加する統合の新しい ドラフト バージョンを作成します。
    10. ネットワーク アタッチメント: トリガーに使用するネットワーク アタッチメントを選択します。このリスト は、プロジェクトで作成されたネットワーク アタッチメントに基づいて生成されます。

      ネットワーク アタッチメントを使用すると、サービス プロデューサーの Virtual Private Cloud（VPC） ネットワークとコンシューマー VPC ネットワーク間の通信が容易になります。Eventarc は、構成されたネットワーク アタッチメントを使用して、コンシューマーの VPC ネットワーク内でホストされている内部 HTTP エンドポイントとの接続を確立し、イベントデータを配信できるようにします。ネットワーク アタッチメントの詳細については、ネットワーク アタッチメントについてをご覧ください。

  4. [統合を開く] をクリックします。

    Application Integration エディタページが開き、統合が選択され、新しい [Eventarc トリガー] 要素が統合に追加されます。

  5. [Eventarc トリガー] 要素をクリックして、トリガー構成ペインを開きます。
  6. [Eventarc トリガー エディタ] ページで、トリガーの構成を確認します。
  7. 新しい [Eventarc トリガー] を統合フローに接続し、統合を公開します。