HTTP Cloud Run 関数のスケジュールを設定する

このチュートリアルでは、Cloud Scheduler で HTTP エンドポイントをターゲットにして、HTTP Cloud Run 関数をスケジュールする方法について説明します。関数で URL エンドポイントを使用し、Webhook などの HTTP リクエストに応答する必要がある場合は、HTTP 関数を使用します。

または、CloudEvents 関数を作成した場合は、Eventarc イベント トリガーを使用して、プロジェクト内のイベントに応答するように関数をスケジュール設定します。Eventarc は、Pub/Sub トピックのメッセージ、Cloud Storage バケットの変更などをトリガーできます。詳細については、Cloud Run 関数のタイプをご覧ください。

Cloud Run 関数の実行のスケジューリングは、Cloud Scheduler の一般的なユースケースです。このチュートリアルの内容は次のとおりです。

  1. シンプルな HTTP Cloud Run 関数を作成する。
  2. Cloud Scheduler ジョブを作成します。
  3. Cloud Scheduler ジョブを実行します。
  4. Cloud Scheduler ジョブが Cloud Run 関数をトリガーすることを確認します。

HTTP Cloud Run 関数を作成する

Cloud Scheduler によってトリガーされる HTTP 関数を作成します。

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

    Cloud Run に移動

  2. [関数を作成] をクリックします。

  3. [構成] セクションで、次の操作を行います。

    1. [サービス名] フィールドに、関数の名前を入力します。
    2. [リージョン] リストでリージョンを選択します。
    3. デフォルトのランタイム言語は変更しないでください。

    4. 認証のために、[Require authentication] を選択します。

      ドメイン制限の組織のポリシーでプロジェクトの未認証呼び出しが制限されている場合は、限定公開サービスのテストの説明に従って、デプロイされたサービスにアクセスする必要があります。

      詳細については、呼び出しの認証をご覧ください。

  4. その他のデフォルト値はそのままにして、[作成] をクリックします。

  5. 関数の HTTP URL をコピーします。

Terraform を使用して Cloud Run functions をデプロイする方法など、詳細については、Cloud Run functions の関数をデプロイするをご覧ください。

Cloud Scheduler ジョブを作成する

HTTP を使用してアクションをトリガーする Cloud Scheduler ジョブを作成します。

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

    Cloud Scheduler に移動

  2. [ジョブを作成] をクリックします。

  3. ジョブの名前を入力します。

  4. [リージョン] リストでリージョンを選択します。

  5. ジョブの頻度を unix-cron 形式で指定します。

    30 16 * * 7

    詳細については、cron ジョブの形式とタイムゾーンをご覧ください。

  6. [タイムゾーン] リストで、タイムゾーンを選択します。

  7. [続行] をクリックします。

  8. [ターゲット タイプ] リストで、[HTTP] を選択します。

  9. [URL] フィールドに、先ほどコピーした関数の HTTP URL を入力します。

  10. [Auth ヘッダー] リストで、[OIDC トークンを追加] を選択します。

  11. [サービス アカウント] リストで、以前に作成したサービス アカウントを選択します。

  12. [Audience] フィールドに、先ほどコピーした関数の HTTP URL を入力します。

  13. [作成] をクリックします。

日曜日の 16:30 に Cloud Run functions の関数を実行する cron ジョブが作成されました。

Cloud Scheduler ジョブを実行する

作成したジョブを実行できるようになりました。

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

    Cloud Scheduler に移動

  2. 作成したジョブのチェックボックスをオンにして、[強制実行] をクリックします。

    初めて呼び出すときは、プロジェクトで作成された最初のジョブの構成と実行に数分かかることがあります。

  3. ジョブの実行後、[最後の実行のステータス] に Success が表示されます。

Cloud Run 関数で結果を確認する

Cloud Run 関数が cron ジョブによって正常にトリガーされ、実行されていることを確認できます。

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

    Cloud Run に移動

  2. [サービスをフィルタ > デプロイタイプ > 関数] を選択します。これにより、サービスリストがフィルタされ、関数のみが表示されます。

  3. ファンクション名をクリックします。

    [サービスの詳細] ページが開き、サービス指標が表示されます。

  4. [Logs] タブをクリックします。

    次のようなログエントリが表示されます。POST 200 146 B 5 ms Google-Cloud-Scheduler https://FUNCTION_NAME