Java 用 cron を使用してタスクのスケジュールを設定する(Cloud SDK ベース)

App Engine Cron サービスを使用すると、定義された時刻または一定間隔で動作する定期スケジュール タスクを構成できます。これらのタスクは、一般的に cron ジョブと呼ばれています。cron ジョブは App Engine Cron サービスによって自動的にトリガーされます。たとえば cron ジョブを使用して、レポートメールを毎日送信したり、キャッシュデータを10分ごとに更新したり、概要情報を 1 時間に 1 回更新したりすることができます。

cron ジョブは、スケジュールされたとおりに URL に対して HTTP GET リクエストを行います。その URL のハンドラは、呼び出されたときにロジックを実行します。cron ジョブ リクエストには、push タスクキューと同じ制限が適用されます。

cron ジョブを作成する

  1. アプリケーションのルート ディレクトリに、app.yaml と一緒に cron.yaml ファイルを作成します。
  2. 1 つ以上の <cron> エントリをファイルに追加し、ジョブに必要な要素(必須の <url> 要素や <schedule> 要素など)を定義します。

    次の例では、毎日 1 回実行される基本的な cron ジョブを作成しています。

    cron:
    - description: "daily summary job"
      url: /tasks/summary
      target: beta
      schedule: every 24 hours
    

    target の指定はオプションです。ここではサービス / バージョンの名前を指定します。target の指定がある場合、この文字列がアプリのホスト名の先頭に追加され、ジョブがそのサービス / バージョンにルーティングされるようになります。target が指定されていない場合、トラフィックに構成されている default サービスのバージョンでジョブが実行されます。

  3. cron ジョブの URL のハンドラを作成します。このハンドラはスケジュール設定されたすべてのタスクを実行します。成功した場合、ハンドラは 200 以上 299 以下の値の HTTP ステータス コードを返します。他のステータス コードが返されることもあります。それらのコードは cron ジョブの再試行に使用できます。

ハンドラは、アプリ内のサーブレットと同じくらいシンプルにできます。web.xml でのサーブレット URL マッピングは cron ジョブ URL と同様です。cron.yaml の構文とオプションの詳細

開発サーバーで cron ジョブをテストする

ローカルの開発用サーバーでは、cron ジョブは自動的には実行されません。機能をテストするには、cron ジョブの URL に対して直接リクエストを行います。ローカルの cron やスケジュールされたタスクのインターフェースを使用すると、curl や同様のツールでジョブの URL をトリガーできます。

失敗した cron ジョブを再試行する

cron ジョブのリクエスト ハンドラが 200~299 の範囲にないステータス コードを返した場合、App Engine はジョブが失敗したものとみなします。デフォルトでは、503 のステータス コードが返されない限り、失敗したジョブは再試行されません。この場合、成功するつまり 200~299 のステータス コードが返されるまで 1 分ごとに再試行されます。

失敗したジョブの再試を設定するには:

  1. cron.yaml ファイルに retry_parameters ブロックを追加します。
  2. retry_parameters ブロックで再試行パラメータを選択して設定します。

    たとえば、以下の cron.yaml ファイルの例には 1 つの cron ジョブがあります。このジョブは再試行を最大で 5 回(デフォルト)実行するよう構成されています。バックオフの初期値は 2.5 秒で、試行ごとに 2 倍になります。

    cron:
    - description: "retry demo"
      url: /retry
      schedule: every 10 mins
      retry_parameters:
        min_backoff_seconds: 2.5
        max_doublings: 5
    

cron の再試行オプションの詳細については、こちらをご覧ください

cron ジョブのデプロイ

cron.yaml 構成ファイルで指定されている cron ジョブをデプロイするには、次のコマンドを実行します。

gcloud

gcloud app deploy cron.yaml

Maven

mvn appengine:deployCron cron.yaml

Gradle

gradle appengineDeployCron cron.yaml

IDE

IntelliJ または Eclipse を使用する場合は、デプロイメント フォームを使用して、デプロイ対象の個々の構成ファイルを選択します。

すべての cron ジョブを削除する

すべての cron ジョブを削除する手順は次のとおりです。

  1. cron.yaml ファイルの内容を次のように編集します。

    cron:
    

  2. cron.yaml ファイルを App Engine にデプロイします。

cron 用 URL を保護する

cron ハンドラは、app.yaml で定義される通常のハンドラです。スケジュールされたタスクで使われる URL にユーザーがアクセスできないようにするには、アクセスを管理者アカウントに限定できます。スケジュールされたタスクは、管理者専用の URL にアクセスできます。app.yaml のハンドラ構成に login: admin を追加することで、URL を制限できます。

たとえば、app.yaml では次のようになります。

application: hello-cron
version: 1
runtime: java
api_version: 1

handlers:
- url: /report/weekly
  servlet: mysite.server.CronServlet
  login: admin

cron ジョブをテストするには、管理者としてログインし、ブラウザでハンドラの URL にアクセスします。

cron サービスからのリクエストには、次の HTTP ヘッダーも含まれます。

X-Appengine-Cron: true

この X-Appengine-Cron ヘッダーは Google App Engine 内部で設定されます。リクエスト ハンドラがこのヘッダーを検出した場合、そのリクエストが cron リクエストであると判断できます。アプリケーションへの外部ユーザー リクエストにこのヘッダーが含まれる場合は、削除されます。ただしログイン済みのアプリケーション管理者からのリクエストは例外で、テストの目的でこのヘッダーを設定することを許可されます。

Google App Engineは Cron リクエストを IP アドレス 0.1.0.1 から発行します。

Google Cloud Endpoints を呼び出す

cron ジョブの url フィールドで Google Cloud Endpoint を指定することはできません。cron ジョブで Google Cloud Endpoint を呼び出せるようにするには、アプリのハンドラで提供されるターゲットへのリクエストを発行し、エンドポイントのクラスとメソッドをハンドラコードから呼び出します。

GCP Console での cron ジョブの表示

GCP Console の [タスクキュー] ページには、cron ジョブを実行しているタスクを表示するタブがあります。

cron ジョブが追加または削除された時期を確認するために、ログを表示することもできます。

詳細

cron ジョブの定義の詳細については、cron.yaml リファレンスをご覧ください。

このページは役立ちましたか?評価をお願いいたします。

フィードバックを送信...

Java の App Engine スタンダード環境