pull キューを作成する

このページでは、pull キューの作成方法について説明します。タスクを追加する前にキューを作成する必要があります。また、キューを一時停止または削除する方法についても説明します。

この API は第 1 世代ランタイムでサポートされており、対応する第 2 世代ランタイムへのアップグレード時に使用できます。App Engine Java 11 / 17 ランタイムに更新する場合は、移行ガイドを参照して、以前のバンドル サービスの移行オプションを確認してください。

queue.yaml によるキューの定義

pull キューはアプリケーションの queue.yaml ファイルを使用して定義できます。このプロセスは名前付き push キューを作成する場合と同じですが、特別なディレクティブ mode: pull がファイルに追加されます。

queue:
- name: my-queue-name
  mode: pull

gcloud CLI gcloud コマンドを使用してファイルをアップロードします。

gcloud app deploy queue.yaml

注: キュー構成ファイルをデプロイするための認証の管理にサービス アカウントを使用する場合は、serviceusage.services.list 権限が必要です。この権限を追加するには、serviceusage.serviceUsageViewer ロールを使用するか、その権限を有するカスタムロールを作成します。

注意: タスクキュー サービス用のキュー作成は、Cloud Tasks API で直接使用できるキュー管理メソッドを使用して管理することもできますが、queue.yaml アップロード メソッドをキュー管理メソッドと混在させると予期しない結果が生じる可能性があるため、おすすめしません。詳細については、キュー管理と queue.yaml の概要をご覧ください。また、バージョン 332.0.0 より前の gcloud CLI を介して queue.yaml ファイルをアップロードすると、非推奨のインターフェースがサービスに使用されます。2022-09-20 以降では、このアップロード方法の使用を試みると、サーバーエラーで失敗することがあります。この問題を解決するには、プロジェクトで Cloud Tasks API を有効にし、gcloud CLI をバージョン 332.0.0 以降に更新してください。

キューを無効にする

キューの無効化または一時停止を行うには、キュー構成ファイルからキューの定義を削除し、更新後のファイルをアップロードします。

更新後のファイルがアップロードされると、キューが「無効」に設定され、その速度が 0 に設定されます。そのキューにあるタスクや新規追加されたタスクは処理されません。無効にしたキューをもう一度有効にするには、そのキューを定義した新しいキュー構成ファイルをアップロードします。

また、Google Cloud コンソールの [Cloud Tasks] ページでもキューを一時停止できます。

キューの削除

キューを削除するには、まずキューを無効にする必要があります。

1. キューの定義をキュー構成ファイルから削除します。

2. 変更後のファイルをアップロードします。

   gcloud app deploy queue.yaml
   

キューが無効になったら、Google Cloud コンソールを使用してキューを削除します。

1. Google Cloud コンソールでキューを選択します。

   [Cloud Tasks] に移動

2. [キューの削除] をクリックします。

Google Cloud コンソールから削除したキューを同じ名前で再作成する場合は、削除して 7 日経過してから作成する必要があります。

重要: ローカル開発用サーバー（dev_appserver）は pull キューをサポートしていません。pull キューをテストし、構成の詳細が正しいことを確認するには、キュー構成ファイルを App Engine ステージング環境に push する必要があります。

次のステップ

タスクの作成方法を学習する。