Nesta página, demonstramos como criar programaticamente tarefas do App Engine
e colocá-las em filas do Cloud Tasks.
Usando esse processo, é possível especificar explicitamente o serviço e o gerenciador que
deve processar a tarefa e, opcionalmente, passar dados específicos da tarefa para o
gerenciador. O serviço Cloud Tasks encaminha a solicitação de tarefa ao
processador, mas esse worker está localizado no App Engine. Portanto, todas as filas que segmentam handlers do App Engine precisam ter um app do App Engine. Os handlers precisam ser executados na região em que o app do App Engine é executado. Essa região também serve como o parâmetro LOCATION_ID
para suas solicitações do Cloud Tasks. Para mais informações, consulte Filas do Cloud Tasks com destinos do App Engine.
Também é possível ajustar a configuração da tarefa, como agendar um horário para que ela seja executada ou limitar o número de vezes que a tarefa será repetida se falhar. Se você escolher especificar um nome para a tarefa, o Cloud Tasks poderá usar esse nome para garantir a eliminação da duplicação de tarefas, embora o processamento necessário possa aumentar a latência.
Regras de firewall do App Engine
No ambiente padrão do App Engine, o firewall pode permitir que determinado tráfego interno ignore o firewall. Isso significa que, se você definir a regra default
como deny
, as solicitações de determinados serviços destinados ao ambiente padrão do App Engine não serão bloqueadas. Esses são todos os tipos de tráfego solicitados na própria configuração do app ou enviados do mesmo app. As solicitações que ignoram as regras de firewall dessa forma também incluem tarefas do App Engine no Cloud Tasks (incluindo filas de tarefas do App Engine).
Para permitir solicitações de entrada, confira os intervalos de IP para tarefas do App Engine no Cloud Tasks (incluindo filas de tarefas do App Engine):
Intervalo de IP para solicitações enviadas ao ambiente padrão do App Engine:
0.1.0.2/32
(ignora a regra de firewall padrão se definida como "negar")Intervalo de IP para solicitações enviadas ao ambiente flexível do App Engine:
0.1.0.2/32
Criar tarefas usando as bibliotecas de cliente
Você cria tarefas na forma de uma solicitação HTTP, que pode ser construída como quiser. No entanto, o uso das bibliotecas de cliente, conforme os exemplos a seguir, pode ajudar você a gerenciar detalhes de comunicação de baixo nível com o servidor, incluindo a autenticação no Google. Para adicionar uma tarefa a uma fila, consulte Adicionar uma tarefa a uma fila do Cloud Tasks
C#
Go
Java
Observe o arquivo pom.xml
:
Node.js
Observe o arquivo package.json
:
PHP
Observe o arquivo composer.json
:
Python
Observe o arquivo requirements.txt
:
Ruby
A seguir
- Saiba como criar gerenciadores de tarefas do App Engine.
- Saiba mais sobre tarefas na referência da API RPC.
- Saiba mais sobre tarefas na referência da API REST.