Criar filas do Cloud Tasks

Nesta página, descrevemos como criar filas de tarefas do Cloud Tasks. Quando as tarefas são adicionadas a uma fila, ela as envia e garante que sejam processadas de maneira 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 projeto doGoogle Cloud que forneça o ID do projeto.

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

  Observação: dois locais, chamados europe-west e us-central nos comandos do App Engine, são chamados, respectivamente, europe-west1 e us-central1 nos comandos do Cloud Tasks.

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

Crie uma fila

É possível criar uma fila 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

Observação :se você estiver configurando o roteamento para uma fila do App Engine e não definir explicitamente o serviço de destino que contém o worker apropriado, o serviço padrão será usado. Para mais informações, consulte Configurar roteamento, limites e novas tentativas de fila.

Console

1. No console do Google Cloud , 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. Se quiser, você pode configurar sua fila.

6. Clique em Criar.

gcloud

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

  gcloud tasks queues create QUEUE_ID \
      --location=LOCATION

Substitua:

• QUEUE_ID: o identificador que você atribui à 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 método projects.locations.queues.create.

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

• PROJECT_ID: o ID do projeto Google Cloud .
• 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).

• QUEUE_ID: o identificador que você atribui à fila, por exemplo, my-queue.

Outras propriedades configuráveis para o recurso Queue incluem limitação 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:

curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI do gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. . É possível verificar a conta ativa atual executando gcloud auth list.

Salve o corpo da solicitação em um arquivo chamado request.json. Execute o comando a seguir no terminal para criar ou substituir esse arquivo no diretório atual:

cat > request.json << 'EOF'
{
  "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID"
}
EOF

Depois execute o comando a seguir para enviar a solicitação REST:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues"

PowerShell (Windows)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . É possível verificar a conta ativa atual executando gcloud auth list.

Salve o corpo da solicitação em um arquivo chamado request.json. Execute o comando a seguir no terminal para criar ou substituir esse arquivo no diretório atual:

@'
{
  "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID"
}
'@  | Out-File -FilePath request.json -Encoding utf8

Depois execute o comando a seguir para enviar a solicitação REST:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues" | Select-Object -Expand Content

APIs Explorer (navegador)

Copie o corpo da solicitação e abra a página de referência do método. O painel APIs Explorer é aberto no lado direito da página. Interaja com essa ferramenta para enviar solicitações. Cole o corpo da solicitação nessa ferramenta, preencha todos os outros campos obrigatórios e clique em Executar.

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

Para confirmar se a fila foi criada, faça o seguinte:

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

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

Console

1. No console do Google Cloud , 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, em seguida, na guia Configuração.

gcloud

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

gcloud tasks queues describe QUEUE_ID \
    --location=LOCATION

Substitua:

• QUEUE_ID: o ID da fila (o nome curto dela)
• 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 método projects.locations.queues.get.

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

• PROJECT_ID: o ID do projeto Google Cloud .
• LOCATION: a região em que a fila é implantada, por exemplo, us-central1.
• QUEUE_ID: o ID curto da fila, por exemplo, my-queue.

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

curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI do gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. . Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Execute o seguinte comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID"

PowerShell (Windows)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

execute o seguinte comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID" | Select-Object -Expand Content

APIs Explorer (navegador)

Abra a página de referência do método. O painel "APIs Explorer" é aberto no lado direito da página. Interaja com essa ferramenta para enviar solicitações. Preencha todos os campos obrigatórios e clique em Executar.

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"
}

Resolver problemas ao criar uma fila

Observação: a geração de registros para sua fila não é ativada por padrão. Para saber como ativar a geração de registros, consulte Usar o Cloud Logging com filas.

Se você não encontrar a saída esperada, tente o seguinte:

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

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

  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:

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

     Acessar detalhes de API/serviço

  2. Clique na guia Cotas e limites do sistema.

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

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

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

A seguir

• Configurar roteamento, limites e novas tentativas de fila
• Criar tarefas do Cloud Tasks
• Definir parâmetros de repetição para uma tarefa
• Gerenciar filas e tarefas