Antes de fazer upgrade para a versão mais recente do SDK de serviços do App Engine, consulte a visão geral da migração.
É possível migrar para o Cloud Tasks automaticamente atualizando o
SDK de serviços do App Engine para a versão mais recente. Depois do upgrade, o SDK
redireciona automaticamente as chamadas PushQueue para as APIs de front-end
do Cloud Tasks. O Cloud Tasks mantém as filas de tarefas e as tarefas atuais, portanto, nenhuma outra migração é necessária.
Nos bastidores, o SDK atualizado usa as APIs do Cloud Tasks para manter a paridade de recursos com os recursos das filas de tarefas. O SDK oferece suporte ao seguinte:
- Criação de tarefas em lote: o SDK usa APIs em lote para permitir a adição de até 100 tarefas em uma única chamada.
- Exclusão de tarefas em lote: o SDK usa APIs em lote para permitir a exclusão de até 1.000 tarefas em uma única chamada.
- Novas tentativas no nível da tarefa: o SDK é compatível com configurações de novas tentativas específicas para cada tarefa.
- Tarefas transacionais: o SDK enfileira tarefas em transações do Datastore. Para manter a confiabilidade, crie ou modifique o arquivo
cron.yaml.
Preços e cotas
Migrar as filas push para o Cloud Tasks pode afetar os preços e as cotas do seu aplicativo.
Preços
Consulte os preços do Cloud Tasks para estimar o custo mensal antes de migrar.
Assim como nas filas de tarefas, o envio de solicitações para o app do App Engine com um destino de push do Cloud Tasks é sem custo financeiro. No entanto, ao contrário das filas de tarefas, o Cloud Tasks cobra pelas operações realizadas, como criar, excluir ou gerenciar tarefas. Isso pode levar a um custo mensal geral mais alto em comparação com a fila de tarefas do App Engine sem custo financeiro.
Se você migrar fazendo upgrade do SDK de serviços do App Engine e seu aplicativo enfileirar tarefas transacionais em transações do Datastore, cada tarefa enfileirada vai gerar três gravações, duas leituras e uma exclusão no Datastore, além do faturamento padrão da API Cloud Tasks.
Cotas
As solicitações do Cloud Tasks também são contabilizadas nas cotas de solicitações do App Engine.
Assim como as filas de tarefas, o Cloud Tasks tem cotas específicas do serviço. A migração para o Cloud Tasks provavelmente vai mudar suas cotas.
Otimizar a latência da solicitação
Como o SDK atualizado envia solicitações diretamente para a API Cloud Tasks, enfileirar ou excluir tarefas individuais sequencialmente pode aumentar a latência da solicitação em comparação com o serviço legado de filas de tarefas. Para minimizar a latência:
- Agrupar várias tarefas em uma única chamada: agrupe tarefas em chamadas de adição em lote (até 100 tarefas por chamada) ou chamadas de exclusão em lote (até 1.000 tarefas por chamada) em vez de enfileirar ou excluir tarefas uma por uma em um loop.
- Use chamadas de API assíncronas: use métodos não bloqueantes, como
add_async()edelete_tasks_async(), para que as operações de tarefa não bloqueiem o processamento de solicitações.
Antes de começar
Conclua as etapas a seguir antes de migrar filas push para o Cloud Tasks:
Verifique se você tem acesso ao código-fonte do App Engine.
Ative as APIs Cloud Tasks e Cloud Scheduler:
Para garantir que a conta de serviço do App Engine tenha as permissões necessárias para permitir que o SDK envie tarefas para a API Cloud Tasks, peça ao administrador para conceder o papel do IAM de Criador de fila do Cloud Tasks (
roles/cloudtasks.enqueuer) no projeto.
Atualizar o SDK de serviços do App Engine
Verifique se o aplicativo usa a versão mais recente do SDK de serviços do App Engine.
No arquivo
requirements.txt, atualize a dependênciaappengine-python-standardpara a versão3.1.0ou mais recente e adicionegoogle-cloud-tasks. Exemplo:Flask==3.0.0 appengine-python-standard>=3.1.0 google-cloud-tasks
Ativar o roteamento do Cloud Tasks
runtime: python315 service: my-service-b env_variables: APPENGINE_USE_CLOUDTASK_PUSH_QUEUE: "true"Implante o aplicativo:
gcloud app deployPara verificar se o app está usando o Cloud Tasks, acesse a página do Cloud Tasks no console doGoogle Cloud .
Configurar tarefas transacionais (opcional)
Se o app enfileirar tarefas em transações do Datastore, o SDK vai usar um cron job interno para garantir que todas as tarefas que não forem enfileiradas durante o commit do Datastore sejam processadas.
Para processar tarefas transacionais de fila push, crie ou atualize o arquivo cron.yaml para chamar periodicamente o processador interno. Exemplo:
cron:
- description: "Process push queue transactional tasks"
url: /_ah/cloudtask/sweep
schedule: every 30 minutes # Change this based on the usage pattern
A seguir
- Documentação do Cloud Tasks
- Biblioteca de cliente do Cloud Tasks
- Visão geral da Referência REST do Cloud Tasks
- Visão geral da referência de RPC do Cloud Tasks
- Para acessar um tutorial, consulte Push de migração da fila de tarefas do App Engine filas para Codelab do Cloud Tasks.