このページでは、gcloud CLI の gcloud
コマンドを使用して、Cloud Tasks キューを作成する方法について説明します。
始める前に
キュー名は、プロジェクト ID、ロケーション、キュー ID の 3 つで構成されます。すべてのターゲット タイプで、プロジェクト ID を提供する Google Cloud プロジェクトが必要です。
App Engine ターゲット タスクを使用する場合は、App Engine アプリも必要です。 アプリは特定のリージョンに配置されます。リージョンはキュー名の場所の部分として機能するため、アプリを追加する際にメモしておきます。このロケーションはキューとハンドラが実行される場所です。
一方、HTTP Target タスクには App Engine アプリは不要です。キューを作成するときに Google Cloud のロケーションを選択します。
Cloud Tasks キューを作成する
Google Cloud SDK を使用してキューを作成するには、次のコマンドを使用します。
gcloud tasks queues create QUEUE_ID --location=LOCATION
以下を置き換えます。
LOCATION
: キューが実行されるロケーション(例:europe-west4
)。- 組織がリソース ロケーションを制限していて、
us-central1
またはus-central2
のいずれかでキューを作成する場合、組織のポリシーにより(どちらか 1 つのリージョンでのみキューを作成する場合でも)us-central1
とus-central2
の両方でキューの作成が許可されている必要があります。
- 組織がリソース ロケーションを制限していて、
QUEUE_ID
: キューに割り当てる識別子(例:my-queue
)。
新しく作成したキューが使用可能になるまでに数分かかることがあります。次に、describe
describe を使用して、キューが正常に作成されたことを確認します。
gcloud tasks queues describe QUEUE_ID --location=LOCATION
以下を置き換えます。
QUEUE_ID
: キュー ID(略称)LOCATION
: キューのロケーション
出力は次のようになります。
name: projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID rateLimits: maxBurstSize: 100 maxConcurrentDispatches: 1000 maxDispatchesPerSecond: 500.0 retryConfig: maxAttempts: 100 maxBackoff: 3600s maxDoublings: 16 minBackoff: 0.100s state: RUNNING
上の出力が表示されない場合は、次の方法をお試しください。
- キューが初期化されるまで 1 分以上待ちます。
同じ ID を持つキューが存在しないことを確認します。プロジェクト内のすべてのキューを表示するには、次の関数を呼び出します。
gcloud tasks queues list --location=LOCATION
複数の場所を検索するには、複数のリクエストを行う必要があります。
キュー制限に達しているかどうかを確認します。
[割り当て] を選択します。
リソースの上限を大きくするには、Google Cloud コンソール の [割り当て] ページから [割り当てを編集] を選択します。
コマンドの各部分を確認し、再度実行します。
次のステップ
- Cloud Tasks キューの構成について学習する。
- RPC API リファレンスでキュー管理の詳細を学習する。
- REST API リファレンスでキュー管理の詳細を学習する。
- Cloud Tasks
gcloud
コマンドの一覧を確認する。