Criar filas do Cloud Tasks

Nesta página, descrevemos como criar filas do Cloud Tasks. Quando as tarefas são adicionadas a uma fila, ela as despacha e garante que elas sejam processadas de forma confiável por um serviço, também conhecido como worker.

Observe o seguinte:

  • Os nomes das filas consistem em três partes: um ID do projeto, um local e um ID da fila. Você precisa ter um Google Cloud projeto que forneça o ID do projeto.

  • Se você estiver usando tarefas de destino do App Engine, também precisará de um aplicativo do App Engine localizado em uma região específica e onde a fila e os gerenciadores serão executados. Anote a região ao adicionar o app.

  • O uso de tarefas de destino HTTP não exige um app do App Engine. Você seleciona um Google Cloud local ao criar a fila.

Crie uma fila

É possível criar uma fila das seguintes maneiras:

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

Console

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

    Acessar filas

  2. Clique em Criar fila.

  3. Insira um nome da fila , por exemplo, my-queue.

  4. Na lista Região, selecione um local compatível em que a fila será executada, por exemplo, asia-south1.

    Se a organização restringir o local do recurso e você quiser criar a fila em us-central1 ou us-central2, a política da organização precisará permitir a criação de filas em us-central1 e us-central2 (mesmo que você só precise de uma fila em uma dessas regiões).

  5. Opcionalmente, você pode configurar ainda mais a fila .

  6. Clique em Criar.

gcloud

Use o gcloud tasks queues create comando para criar uma fila:

  gcloud tasks queues create QUEUE_ID \
      --location=LOCATION

Substitua:

  • QUEUE_ID: o identificador atribuído à sua fila, por exemplo, my-queue.

  • LOCATION: uma região compatível em que a fila será executada, por exemplo, asia-south1.

    Se a organização restringir o local do recurso e você quiser criar a fila em us-central1 ou us-central2, a política da organização precisará permitir a criação de filas em us-central1 e us-central2 (mesmo que você só precise de uma fila em uma dessas regiões).

Outras flags do comando da CLI gcloud permitem configurar limites de taxa, opções de repetição, tipos de fila e muito mais.

API REST

Para criar uma fila, use o projects.locations.queues.create método.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

Outras propriedades configuráveis para o Queue recurso incluem limites de taxa, opções de repetição, tipos de fila e muito mais.

Corpo JSON da solicitação: 

{
  "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID"
}

Para enviar a solicitação, expanda uma destas opções:

Se houver êxito, o corpo da resposta conterá uma instância de Queue: 

{
  "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID",
  "rateLimits": {
    "maxDispatchesPerSecond": 500,
    "maxBurstSize": 100,
    "maxConcurrentDispatches": 1000
  },
  "retryConfig": {
    "maxAttempts": 100,
    "minBackoff": "0.100s",
    "maxBackoff": "3600s",
    "maxDoublings": 16
  },
  "state": "RUNNING"
}

Pode demorar alguns minutos para que uma fila recém-criada esteja disponível.

Descreva sua fila

É possível confirmar se a fila foi criada com sucesso das seguintes maneiras:

  • No Google Cloud console do
  • Usando a CLI gcloud no terminal ou no Cloud Shell

  • Enviando uma solicitação direta para a API Cloud Tasks

Console

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

    Acessar filas

    Uma marca de seleção verde indica que a fila está em execução.

  2. Para mais detalhes, clique no nome da fila e depois na guia Configuração.

gcloud

Use o gcloud tasks queues describe comando para verificar se a fila foi criada com sucesso:

gcloud tasks queues describe QUEUE_ID \
    --location=LOCATION

Substitua:

  • QUEUE_ID: o ID da fila (nome abreviado)
  • LOCATION: o local da fila

A saída será semelhante a esta:

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

API REST

Para recuperar uma fila, use o projects.locations.queues.get método.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

Para enviar a solicitação, expanda uma destas opções:

Se houver êxito, o corpo da resposta conterá uma instância de Queue: 

{
  "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID",
  "rateLimits": {
    "maxDispatchesPerSecond": 500,
    "maxBurstSize": 100,
    "maxConcurrentDispatches": 1000
  },
  "retryConfig": {
    "maxAttempts": 100,
    "minBackoff": "0.100s",
    "maxBackoff": "3600s",
    "maxDoublings": 16
  },
  "state": "RUNNING"
}

Solução de problemas na criação de uma fila

Se a saída esperada não aparecer, tente o seguinte:

  • Aguarde pelo menos um minuto para que a fila seja inicializada.

  • Verifique se já há uma fila com o mesmo ID. Para conferir as filas no projeto, use o gcloud tasks queues list comando:

    gcloud tasks queues list \
    --location=LOCATION

    Para pesquisar vários locais, é necessário fazer várias solicitações.

  • Verifique se você atingiu a cota da fila quota:

    1. No Google Cloud console do, acesse a página Detalhes da API/serviço da API Cloud Tasks.

      Acessar detalhes da API/serviço

    2. Clique na guia Cotas e limites do sistema.

    3. Para aumentar uma cota, na linha da cota, clique no ícone de reticências > Editar cota.

      Para mais informações, consulte Solicitar ajuste de cota.

  • Execute novamente os comandos para criar a fila e garantir que cada etapa seja concluída corretamente.

A seguir