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

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.
  • Novas tentativas no nível da tarefa: o SDK é compatível com configurações de novas tentativas específicas para cada tarefa.

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.

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) em vez de enfileirar tarefas uma a uma em um loop.

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 composer.json, atualize google/appengine-php-sdk para a versão ^2.3 ou mais recente e adicione google/cloud-tasks.

    {
      "require": {
        "google/appengine-php-sdk": "^2.3",
        "google/cloud-tasks": "^2.3"
      }
    }
  2. Ativar o roteamento do Cloud Tasks

    runtime: php85
    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 .

A seguir