Criar tarefas do Cloud Tasks

É possível usar o Cloud Tasks para criar itens de trabalho assíncronos chamados tarefas. Este documento demonstra como criar tarefas de destino HTTP e do App Engine.

As tarefas de destino HTTP são solicitações encaminhadas a um worker localizado em qualquer endpoint HTTP genérico com um endereço IP externo, como Cloud Run, Google Kubernetes Engine, Compute Engine ou um servidor da Web local.

Para destinos do App Engine, o Cloud Tasks encaminha solicitações de tarefa para um gerenciador no App Engine. Todas as filas que segmentam handlers do App Engine precisam ter um aplicativo do App Engine. Os handlers precisam ser executados na região em que o aplicativo do App Engine é executado. Essa região também serve como o parâmetro REGION para suas solicitações do Cloud Tasks.

É possível criar uma tarefa de destino HTTP das seguintes maneiras:

  • No console do Google Cloud
  • Usando a Google Cloud CLI no terminal ou no Cloud Shell
  • Enviando uma solicitação direta para a API Cloud Tasks

Para saber como adicionar programaticamente uma tarefa de destino HTTP a uma fila do Cloud Tasks, consulte Criar tarefas de destino HTTP de forma programática.

É possível criar uma tarefa do App Engine das seguintes maneiras:

  • Usando a Google Cloud CLI no terminal ou no Cloud Shell
  • Enviando uma solicitação direta para a API Cloud Tasks

Para saber como adicionar programaticamente uma tarefa do App Engine a uma fila do Cloud Tasks, consulte Criar tarefas do App Engine de maneira programática.

Antes de começar

Verifique se você já criou uma fila do Cloud Tasks. Para mais informações, consulte Criar filas do Cloud Tasks.

Criar uma tarefa de destino HTTP

Ao criar uma tarefa, é possível especificar um nome para ela. Se o nome for idêntico ao de uma tarefa atual ou de uma tarefa excluída ou concluída recentemente, a chamada vai falhar. Se você não especificar um nome de tarefa, um ID aleatório e exclusivo será gerado.

Como há um custo de pesquisa extra para identificar nomes de tarefas duplicados, as tarefas criadas com IDs especificados pelo usuário têm uma latência significativamente maior. Recomendamos usar strings hash para o ID da tarefa ou para o prefixo dele. Para mais informações, consulte Deduplicação de tarefas.

Console

  1. No console do Google Cloud , acesse a página Cloud Tasks > Filas.

    Acessar "Filas"

  2. Clique no nome da fila em que você quer adicionar a tarefa.

  3. Clique em Criar tarefa HTTP.

  4. Se quiser, especifique o Nome da tarefa.

  5. Em URL, especifique o URL totalmente qualificado para onde a solicitação será enviada. O caminho precisa começar com http:// ou https://. Por exemplo: https://www.example.com.