Como criar filas pull

Nesta página, mostramos como criar filas pull. É preciso criar a fila antes de adicionar tarefas a ela. Também descrevemos como pausar ou excluir uma fila.

Essa API é compatível com os ambientes de execução de primeira geração e pode ser usada ao fazer upgrade para os ambientes de execução de segunda geração correspondentes. Se você estiver atualizando para o ambiente de execução do Python 3 do App Engine, consulte o guia de migração para saber mais sobre as opções de migração para serviços em pacote legados.

Como definir filas com queue.yaml

É possível definir filas pull usando o arquivo queue.yaml para o aplicativo. O processo é o mesmo de criar filas push nomeadas, com uma diretiva especializada, mode: pull, adicionada ao arquivo.

queue:
- name: my-queue-name
  mode: pull

Use o comando gcloud da CLI gcloud para fazer upload do arquivo.

gcloud app deploy queue.yaml

Observação: se você estiver usando uma conta de serviço para gerenciar a autenticação para implantar seu arquivo de configuração de fila, será necessário ter a permissão serviceusage.services.list. Essa permissão pode ser adicionada usando o papel serviceusage.serviceUsageViewer ou criando um papel personalizado com essa permissão.

Cuidado: a criação de filas para o serviço de fila de tarefas também pode ser gerenciada usando os métodos de gerenciamento de filas disponíveis diretamente pela API Cloud Tasks. No entanto, a combinação do método de upload queue.yaml com os métodos de gerenciamento de filas pode produzir resultados inesperados e não é recomendada. Para mais informações, consulte Visão geral do gerenciamento de filas e do arquivo queue.yaml. Tenha em mente também que fazer upload de um arquivo queue.yaml pela CLI gcloud abaixo da versão 332.0.0 usa uma interface com uso descontinuado para o serviço. A partir de 2022-09-20, as tentativas de usar o método de upload podem falhar com erros de servidor. Para resolver isso, verifique se a API Cloud Tasks está ativada no projeto e se a CLI gcloud está atualizada para pelo menos a versão 332.0.0.

Como desativar filas

Para desativar ou pausar uma fila, remova a definição dela do arquivo de configuração e faça o upload do arquivo atualizado.

Depois que o arquivo atualizado é carregado, a fila é definida como "desativada" e sua taxa é definida como 0. Nem as tarefas que estiverem na fila nem as novas tarefas adicionadas serão processadas. Para reativar a fila, faça upload de um novo arquivo de fila com a fila definida.

Também é possível pausar uma fila na página Cloud Tasks no Google Cloud console.

Como excluir filas

Para excluir uma fila, primeiro, você precisa desativá-la:

1. Remova a definição da fila do arquivo de configuração de fila.

2. Faça upload do arquivo alterado.

   gcloud app deploy queue.yaml
   

Quando a fila estiver desativada, use o console Google Cloud para excluí-la.

1. No console Google Cloud , selecione a fila.

   Ir para o Cloud Tasks

2. Clique em Excluir fila.

Se você excluir uma fila do console do Google Cloud , vai precisar aguardar sete dias para recriar com o mesmo nome.

Importante: o servidor de desenvolvimento local (dev_appserver) não é compatível com filas pull. Para testar suas filas pull e verificar se os detalhes da sua configuração estão corretos, será necessário enviar o arquivo de configuração da fila por push para um ambiente de preparo do App Engine.

A seguir

Saiba como criar tarefas.