Cloud Tasks キューに HTTP ターゲット タスクを追加する

Cloud Tasks キューに HTTP ターゲット タスクを追加する

このクイックスタートでは、Cloud Tasks API を使用して HTTP ターゲット タスクを Cloud Tasks キューに追加する方法について説明します。

始める前に

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
2. Install the Google Cloud CLI.

3. To initialize the gcloud CLI, run the following command:

   gcloud init

4. Create or select a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   • Create a Google Cloud project:

     gcloud projects create PROJECT_ID

     Replace PROJECT_ID with a name for the Google Cloud project you are creating.

   • Select the Google Cloud project that you created:

     gcloud config set project PROJECT_ID

     Replace PROJECT_ID with your Google Cloud project name.

5. Make sure that billing is enabled for your Google Cloud project.

6. Enable the Cloud Tasks API:

   gcloud services enable cloudtasks.googleapis.com

7. If you're using a local shell, then create local authentication credentials for your user account:

   gcloud auth application-default login

   You don't need to do this if you're using Cloud Shell.

8. Install the Google Cloud CLI.

9. To initialize the gcloud CLI, run the following command:

   gcloud init

10. Create or select a Google Cloud project.

    Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

    • Create a Google Cloud project:

      gcloud projects create PROJECT_ID

      Replace PROJECT_ID with a name for the Google Cloud project you are creating.

    • Select the Google Cloud project that you created:

      gcloud config set project PROJECT_ID

      Replace PROJECT_ID with your Google Cloud project name.

11. Make sure that billing is enabled for your Google Cloud project.

12. Enable the Cloud Tasks API:

    gcloud services enable cloudtasks.googleapis.com

13. If you're using a local shell, then create local authentication credentials for your user account:

    gcloud auth application-default login

    You don't need to do this if you're using Cloud Shell.

Cloud Tasks キューを作成する

gcloud tasks queues create コマンドを使用してキューを作成します。

注意: Cloud Tasks gcloud キュー管理の手法と、queue.yaml/queue.xml のアップロードに基づく手法を同時に使用することにはリスクが伴います。詳細については、キュー管理または queue.yaml の使用をご覧ください。

1. ターミナルで、すべてのオペレーションをロギングするキューを作成します。

   gcloud tasks queues create QUEUE_NAME \
       --log-sampling-ratio=1.0 \
       --location=REGION
   

   以下を置き換えます。

   • QUEUE_NAME: Cloud Tasks キューの名前
   • REGION: サービスまたはアプリをデプロイしたリージョン

2. キューが初期化されるまで待ってから、キューが正常に作成されたことを確認します。

   gcloud tasks queues describe QUEUE_NAME \
       --location=REGION
   

   出力例を以下に示します。

    name: projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_NAME
    rateLimits:
      maxBurstSize: 100
      maxConcurrentDispatches: 1000
      maxDispatchesPerSecond: 500.0
    retryConfig:
      maxAttempts: 100
      maxBackoff: 3600s
      maxDoublings: 16
      minBackoff: 0.100s
    state: RUNNING
   

Cloud Tasks キューにタスクを追加する

gcloud tasks create-http-task コマンドを使用して、HTTP エンドポイントをターゲットとするタスクを作成し、キューにタスクを追加します。

1. タスクを作成して作成したキューに追加し、そのタスクを HTTP エンドポイントに配信します。

   gcloud tasks create-http-task \
       --queue=QUEUE_NAME \
       --url=URL_PATH \
       --method=GET \
       --location=REGION \
       --project=PROJECT_ID
   

   URL_PATH は、リクエストを送信する完全な URL パスに置き換えます。例: https://www.google.com

   パスは http:// または https:// で始まる必要があります。

2. ログを読み取って、タスクが正常に実行されたことを確認します。

   gcloud logging read --limit=3
   

   ログは次のようになります。

   jsonPayload:
   '@type': type.googleapis.com/google.cloud.tasks.logging.v1.TaskActivityLog
   task: projects/PROJECT_ID/locations/REGION/queues/QUEUE_NAME/tasks/TASK_ID
   taskCreationLog:
      scheduleTime: '2024-07-04T19:00:27.801837Z'
      status: OK
      targetAddress: GET https://www.google.com/
      targetType: HTTP
   

クリーンアップ

このページで使用したリソースについて、Google Cloud アカウントに課金されないようにするには、Google Cloud プロジェクトとそのリソースをまとめて削除してください。

注意: プロジェクトを削除すると、次のような影響があります。

• プロジェクト内のすべてのものが削除されます。このドキュメントのタスクで既存のプロジェクトを使用した場合、それを削除すると、そのプロジェクトで行った他の作業もすべて削除されます。
• カスタム プロジェクト ID が失われます。このプロジェクトを作成したときに、将来使用するカスタム プロジェクト ID を作成した可能性があります。そのプロジェクト ID を使用した URL（たとえば、appspot.com）を保持するには、プロジェクト全体ではなくプロジェクト内の選択したリソースだけを削除します。

複数のアーキテクチャ、チュートリアル、クイックスタートを実施する予定がある場合は、プロジェクトを再利用すると、プロジェクトの割り当て上限を超えないようにすることができます。

Delete a Google Cloud project:

gcloud projects delete PROJECT_ID

または、Cloud Tasks キューを削除することもできます。

gcloud tasks queues delete QUEUE_NAME \
    --location=REGION

次のステップ

• キューとタスクの管理
• Cloud Tasks キューを作成する
• RPC API リファレンス
• REST API リファレンス