Adicionar uma tarefa de destino HTTP a uma fila do Cloud Tasks

Neste guia de início rápido, mostramos como adicionar uma tarefa de destino HTTP a uma fila do Cloud Tasks usando a API Cloud Tasks.

Antes de começar

  1. Faça login na sua conta do Google Cloud. Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.
  2. Instale a CLI do Google Cloud.

  3. Para inicializar a CLI gcloud, execute o seguinte comando: 

    gcloud init

  4. Crie ou selecione um projeto do Google Cloud.

    • Crie um projeto do Google Cloud:

      gcloud projects create PROJECT_ID

      Substitua PROJECT_ID por um nome para o projeto do Google Cloud que você está criando.

    • Selecione o projeto do Google Cloud que você criou:

      gcloud config set project PROJECT_ID

      Substitua PROJECT_ID pelo nome do projeto do Google Cloud.

  5. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

  6. Ative a API Cloud Tasks: 

    gcloud services enable tasks.googleapis.com

  7. Crie as credenciais de autenticação para sua Conta do Google: 

    gcloud auth application-default login
    8.
  8. Instale a CLI do Google Cloud.

  9. Para inicializar a CLI gcloud, execute o seguinte comando: 

    gcloud init

  10. Crie ou selecione um projeto do Google Cloud.

    • Crie um projeto do Google Cloud:

      gcloud projects create PROJECT_ID

      Substitua PROJECT_ID por um nome para o projeto do Google Cloud que você está criando.

    • Selecione o projeto do Google Cloud que você criou:

      gcloud config set project PROJECT_ID

      Substitua PROJECT_ID pelo nome do projeto do Google Cloud.

  11. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

  12. Ative a API Cloud Tasks: 

    gcloud services enable tasks.googleapis.com

  13. Crie as credenciais de autenticação para sua Conta do Google: 

    gcloud auth application-default login
    14.

Criar uma fila do Cloud Tasks

Use o comando gcloud tasks queues create para criar sua fila.

  1. No seu terminal, crie uma fila que registre todas as operações.

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

    Substitua:

    • QUEUE_NAME: um nome para a fila do Cloud Tasks.
    • REGION: a região em que você implantou o serviço ou o app.

  2. Aguarde a inicialização da fila e verifique se ela foi criada com sucesso.

    gcloud tasks queues describe QUEUE_NAME \
    --location=REGION

    A saída será semelhante a esta:

     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

Adicionar uma tarefa à fila do Cloud Tasks

Use o comando gcloud tasks create-http-task para criar uma tarefa destinada a um endpoint HTTP e adicionar a tarefa à fila.

  1. Crie uma tarefa, adicione-a à fila que você criou e entregue-a a um endpoint HTTP.

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

    Substitua URL_PATH pelo caminho completo do URL ao qual a solicitação será enviada. Por exemplo: https://www.google.com

    O caminho precisa começar com http:// ou https://.

  2. Leia os registros para verificar se a tarefa foi executada corretamente.

    gcloud logging read --limit=3

    Os registros devem ser semelhantes aos seguintes:

    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

Limpar

Para evitar cobranças na sua conta do Google Cloud pelos recursos usados nesta página, exclua o projeto do Google Cloud com esses recursos.

Exclua um projeto do Google Cloud:

gcloud projects delete PROJECT_ID

Como alternativa, exclua a fila do Cloud Tasks:

gcloud tasks queues delete QUEUE_NAME \
    --location=REGION

A seguir