Criar filas de obtenção

Esta página descreve como criar uma fila de obtenção. Tem de criar a fila antes de poder adicionar tarefas à mesma. A página também descreve como pausar ou eliminar uma fila.

Esta API é suportada para runtimes de primeira geração e pode ser usada quando atualizar para runtimes de segunda geração correspondentes. Se estiver a fazer a atualização para o tempo de execução do App Engine Java 11/17, consulte o guia de migração para saber mais sobre as suas opções de migração para serviços agrupados antigos.

Definir filas com queue.yaml

Pode definir filas de obtenção com o ficheiro queue.yaml para a sua aplicação. O processo é o mesmo que criar filas de envio com nome, com uma diretiva especializada, mode: pull, adicionada ao ficheiro.

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

Usa o comando gcloud da CLI gcloud para carregar o ficheiro.

gcloud app deploy queue.yaml

Nota: se estiver a usar uma conta de serviço para gerir a autenticação para implementar o seu ficheiro de configuração da fila, esta tem de ter a autorização serviceusage.services.list. Esta autorização pode ser adicionada através da função serviceusage.serviceUsageViewer ou da criação de uma função personalizada com essa autorização.

Aviso: a criação de filas para o serviço Task Queue também pode ser gerida através de métodos de gestão de filas disponíveis diretamente através da API Cloud Tasks, mas a combinação do método de carregamento queue.yaml com métodos de gestão de filas pode produzir resultados inesperados e não é recomendada. Para mais informações, consulte o artigo Vista geral da gestão de filas e do ficheiro queue.yaml. Tenha também em atenção que o carregamento de um ficheiro queue.yaml através da CLI gcloud abaixo da versão 332.0.0 usa uma interface descontinuada para o serviço. A partir de 2022-09-20, as tentativas de usar o método de carregamento podem falhar com erros do servidor. Para resolver este problema, certifique-se de que a API Cloud Tasks está ativada no seu projeto e que a CLI gcloud está atualizada para, pelo menos, a versão 332.0.0.

Desativar filas

Pode desativar ou pausar uma fila removendo a respetiva definição do ficheiro de configuração da fila e, em seguida, carregando o ficheiro atualizado.

Depois de carregar o ficheiro atualizado, a fila é definida como "desativada" e a respetiva taxa é definida como 0. As tarefas na fila ou as novas tarefas adicionadas à fila não são processadas. Pode voltar a ativar a fila desativada carregando um novo ficheiro de fila com a fila definida.

Também pode pausar uma fila na página Cloud Tasks na Google Cloud consola.

Eliminar filas

Para eliminar uma fila, tem de a desativar primeiro:

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

2. Carregue o ficheiro alterado.

   gcloud app deploy queue.yaml
   

Quando a fila estiver desativada, use a consola Google Cloud para a eliminar.

1. Na Google Cloud consola, selecione a fila.

   Aceda ao Cloud Tasks

2. Clique em Eliminar fila.

Se eliminar uma fila da Google Cloud consola, tem de aguardar 7 dias antes de a recriar com o mesmo nome.

Importante: o servidor de desenvolvimento local (dev_appserver) não suporta filas de obtenção. Para testar as filas de obtenção e certificar-se de que tem os detalhes da configuração corretos, tem de enviar o ficheiro de configuração da fila para um ambiente de preparação do App Engine.

O que se segue?

Saiba como criar tarefas.