Migrar filas push para o Cloud Tasks fazendo upgrade para o SDK mais recente (Python)

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() e delete_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:

  1. Verifique se você tem acesso ao código-fonte do App Engine.

  2. Ative as APIs Cloud Tasks e Cloud Scheduler:

    Ativar APIs

  3. 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

  1. 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ência appengine-python-standard para a versão 3.1.0 ou mais recente e adicione google-cloud-tasks. Exemplo:

    Flask==3.0.0
    appengine-python-standard>=3.1.0
    google-cloud-tasks
  2. Ativar o roteamento do Cloud Tasks

    runtime: python315
    service: my-service-b
    
    env_variables:
      APPENGINE_USE_CLOUDTASK_PUSH_QUEUE: "true"
    
  3. Implante o aplicativo:

    gcloud app deploy
    
  4. Para 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