最新の App Engine サービス SDK バージョンにアップグレードする前に、移行の概要を確認してください。
App Engine サービス SDK を最新バージョンに更新すると、Cloud Tasks に自動的に移行できます。アップグレード後、SDK は PushQueue 呼び出しを Cloud Tasks フロントエンド API に自動的にリダイレクトします。Cloud Tasks は既存のタスクキューとタスクを保持するため、追加の移行は必要ありません。
更新された SDK は、Cloud Tasks API を使用してタスクキュー機能との機能同等性を維持します。SDK は次の機能をサポートしています。
- バッチタスクの作成: SDK はバッチ API を使用して、1 回の呼び出しで最大 100 個のタスクを追加できます。
- タスクレベルの再試行: SDK は、タスク固有の再試行構成をサポートしています。
料金と割り当て
push キューを Cloud Tasks に移行すると、アプリの料金と割り当てに影響する場合があります。
料金
移行する前に、Cloud Tasks の料金を確認して月額費用を見積もります。
タスクキューと同様に、Cloud Tasks の push ターゲットを使用して App Engine アプリにリクエストを送信するのは無料です。ただし、タスクキューとは異なり、Cloud Tasks では、タスクの作成、削除、管理などの実行されたオペレーションに対して課金されます。これにより、無料の App Engine タスクキューと比較して、月額料金が全体的に高くなる可能性があります。
割り当て
Cloud Tasks リクエストも App Engine リクエストの割り当てにカウントされます。
タスクキューと同様に、Cloud Tasks にはサービス固有の割り当てがあります。Cloud Tasks に移行すると、割り当てが変更される可能性があります。
リクエストのレイテンシを最適化する
更新された SDK はリクエストを Cloud Tasks API に直接送信するため、個々のタスクを順番にキューに登録または削除すると、以前のタスクキュー サービスと比較してリクエストのレイテンシが増加する可能性があります。レイテンシを最小限に抑えるには:
- 複数のタスクを 1 つの呼び出しにバッチ処理する: ループ内でタスクを 1 つずつキューに入れるのではなく、タスクをバッチ追加呼び出し(呼び出しごとに最大 100 個のタスク)にグループ化します。
始める前に
push キューを Cloud Tasks に移行する前に、次の手順を完了します。
App Engine のソースコードにアクセスできることを確認します。
Cloud Tasks API と Cloud Scheduler API を有効にします。
App Engine サービス アカウントに、SDK が Cloud Tasks API にタスクをディスパッチするために必要な権限が付与されるようにするには、プロジェクトに対する Cloud Tasks へのデータ追加(
roles/cloudtasks.enqueuer)IAM ロールを付与するよう管理者に依頼してください。
App Engine サービス SDK を更新する
アプリケーションで最新バージョンの App Engine サービス SDK が使用されていることを確認します。
composer.jsonファイルで、google/appengine-php-sdkをバージョン^2.3以降に更新し、google/cloud-tasksを追加します。{ "require": { "google/appengine-php-sdk": "^2.3", "google/cloud-tasks": "^2.3" } }
Cloud Tasks ルーティングを有効にする
runtime: php85 service: my-service-b env_variables: APPENGINE_USE_CLOUDTASK_PUSH_QUEUE: "true"アプリをデプロイします。
gcloud app deployアプリが Cloud Tasks を使用していることを確認するには、Google Cloud コンソールの [Cloud Tasks] ページに移動します。
次のステップ
- Cloud Tasks のドキュメント
- Cloud Tasks のクライアント ライブラリ
- Cloud Tasks の REST リファレンスの概要
- Cloud Tasks の RPC リファレンスの概要