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

Pub/Sub トリガー

Cloud Functions では、Pub/Sub トリガーによって Pub/Sub メッセージに応答して、関数を呼び出すことができます。関数に Pub/Sub トリガーを指定するときに、Pub/Sub トピックも指定します。関数は、指定したトピックにメッセージが公開されるたびに呼び出されます。

関数で Pub/Sub トリガーを使用するには、イベント ドリブン関数として実装する必要があります。

Google イベント リポジトリには、イベントデータを処理するための追加のリソースが含まれています。

デプロイ

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

gcloud

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

gcloud functions deploy YOUR_FUNCTION_NAME \
--trigger-topic=YOUR_PUBSUB_TOPIC \
[--retry] \
...
  • --trigger-topic フラグには、トリガーがモニタリングする Pub/Sub トピックを指定します。このトピックに公開されたメッセージによって、関数の呼び出しがトリガーされます。
  • --retry フラグは、失敗した関数呼び出しを自動的に再試行するかどうかを制御します。詳細については、イベント ドリブン関数の再試行をご覧ください。

以前の Pub/Sub イベント

Cloud Functions（第 1 世代）のレガシー関数は、Pub/Sub トリガーに異なるイベントタイプを使用します。

gcloud functions deploy YOUR_FUNCTION_NAME \
--trigger-event=providers/cloud.pubsub/eventTypes/topic.publish \
--trigger-resource=YOUR_PUBSUB_TOPIC \
...

このイベントタイプは、これらのイベントをすでに使用しているレガシー関数でサポートされています。ただし、将来、レガシー イベントタイプは削除される可能性があるため、代わりに --trigger-topic フラグの使用をおすすめします。

コンソール

Google Cloud コンソールを使用してデプロイする場合は、[トリガー] セクションで Pub/Sub トリガーを構成できます。

  • Cloud Functions（第 2 世代）の場合:

    1. イベント トリガーを追加するには、[Eventarc トリガーを追加] をクリックします。[Eventarc トリガー] ペインが開きます。
    2. [イベント プロバイダ] フィールドで、[Cloud Pub/Sub] を選択します。
    3. [イベント] フィールドで、google.cloud.pubsub.topic.v1.messagePublished を選択します。
    4. [Cloud Pub/Sub トピックを選択してください] フィールドで、モニタリングするトリガーのトピックを選択します。このトピックに公開されたメッセージによって、関数の呼び出しがトリガーされます。
    5. [失敗時に再試行する] チェックボックスをオンまたはオフにして、失敗した関数の呼び出しを自動的に再試行するかどうかを制御します。詳細については、イベント ドリブン関数の再試行をご覧ください。
    6. [トリガーを保存] をクリックします。

  • Cloud Functions（第 1 世代）の場合:

    1. [トリガー] フィールドで [Cloud Pub/Sub] を選択します。
    2. [Cloud Pub/Sub トピックを選択してください] フィールドで、モニタリングするトリガーのトピックを選択します。このトピックに公開されたメッセージによって、関数の呼び出しがトリガーされます。
    3. [失敗時に再試行する] チェックボックスをオンまたはオフにして、失敗した関数の呼び出しを自動的に再試行するかどうかを制御します。詳細については、イベント ドリブン関数の再試行をご覧ください。

次のステップ