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. Google Cloud CLI をインストールします。

  3. gcloud CLI を初期化するには:

    gcloud init

  4. Google Cloud プロジェクトを作成または選択します。

    • Google Cloud プロジェクトを作成します。

      gcloud projects create PROJECT_ID

      PROJECT_ID は、作成する Google Cloud プロジェクトの名前に置き換えます。

    • 作成した Google Cloud プロジェクトを選択します。

      gcloud config set project PROJECT_ID

      PROJECT_ID は、実際の Google Cloud プロジェクト名に置き換えます。

  5. Google Cloud プロジェクトで課金が有効になっていることを確認します。

  6. Cloud Tasks API を有効にします。 

    gcloud services enable tasks.googleapis.com

  7. Google アカウントのローカル認証情報を作成します。

    gcloud auth application-default login
    8.
  8. Google Cloud CLI をインストールします。

  9. gcloud CLI を初期化するには:

    gcloud init

  10. Google Cloud プロジェクトを作成または選択します。

    • Google Cloud プロジェクトを作成します。

      gcloud projects create PROJECT_ID

      PROJECT_ID は、作成する Google Cloud プロジェクトの名前に置き換えます。

    • 作成した Google Cloud プロジェクトを選択します。

      gcloud config set project PROJECT_ID

      PROJECT_ID は、実際の Google Cloud プロジェクト名に置き換えます。

  11. Google Cloud プロジェクトで課金が有効になっていることを確認します。

  12. Cloud Tasks API を有効にします。 

    gcloud services enable tasks.googleapis.com

  13. Google アカウントのローカル認証情報を作成します。

    gcloud auth application-default login
    14.

Cloud Tasks キューを作成する

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

  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 プロジェクトとそのリソースをまとめて削除してください。

Delete a Google Cloud project:

gcloud projects delete PROJECT_ID

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

gcloud tasks queues delete QUEUE_NAME \
    --location=REGION

次のステップ