Cloud Tasks キューを作成する

このページでは、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: キューが実行されるロケーション（例: asia-south1）。

    • 組織がリソース ロケーションを制限していて、us-central1 または us-central2 のいずれかでキューを作成する場合、組織のポリシーにより（どちらか 1 つのリージョンでのみキューを作成する場合でも）us-central1とus-central2 の両方でキューの作成が許可されている必要があります。

  • QUEUE_ID: キューに割り当てる識別子（例: my-queue）。

新しく作成したキューが使用可能になるまでに数分かかることがあります。次に、describedescribe を使用して、キューが正常に作成されたことを確認します。

   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

    複数の場所を検索するには、複数のリクエストを行う必要があります。

  • キュー制限に達しているかどうかを確認します。

    Cloud Tasks API のページに移動

    [割り当て] を選択します。

    リソースの上限を大きくするには、Google Cloud コンソール の [割り当て] ページから [割り当てを編集] を選択します。

  • コマンドの各部分を確認し、再度実行します。

次のステップ