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

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

Neste guia de início rápido, mostramos como adicionar um Tarefa de destino HTTP para uma Fila do Cloud Tasks usando a API Cloud Tasks.

Antes de começar

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. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

6. Enable the Cloud Tasks API:

   gcloud services enable tasks.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. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

12. Enable the Cloud Tasks API:

    gcloud services enable tasks.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.

Criar uma fila do Cloud Tasks

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

Cuidado: usar os métodos de gerenciamento de filas gcloud do Cloud Tasks apresenta alguns riscos se usados com métodos baseados no upload de queue.yaml/queue.xml. Para mais informações, consulte Use o gerenciamento de filas ou o row.yaml.

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 de tarefas do Cloud Tasks
   • REGION: a região em que você implantou seu serviço ou 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 gcloud tasks create-http-task para criar uma tarefa que tem como alvo um endpoint HTTP e adicionar a tarefa ao seu fila.

1. Criar uma tarefa, adicioná-la à fila que você criou e entregar essa tarefa 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 que o 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.

   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.

Cuidado: excluir um projeto tem os seguintes efeitos:

• Tudo no projeto é excluído. Se você tiver usado um projeto existente para as tarefas neste documento, a exclusão dele incluirá a exclusão de quaisquer outros trabalhos feitos no projeto.
• Os IDs do projeto personalizados são perdidos. Ao criar o projeto, você pode ter criado um código do projeto personalizado para ser usado no futuro. Para preservar os URLs que usam o ID do projeto, como um URL appspot.com, exclua recursos específicos do projeto, em vez de excluir o projeto inteiro.

Se você planeja passar por várias arquiteturas, tutoriais ou guias de início rápido, a reutilização de projetos pode evitar que você exceda os limites da cota do projeto.

Delete a Google Cloud project:

gcloud projects delete PROJECT_ID

Você também pode excluir a fila do Cloud Tasks:

gcloud tasks queues delete QUEUE_NAME \
    --location=REGION

A seguir

• Gerenciar filas e tarefas
• Criar filas do Cloud Tasks
• Referência da API RPC
• Referência da API REST