APRENDER. PRATICAR. EVOLUIR.Conceito e mecanismo
Um container funcionar localmente não demonstra que cumpre o contrato de Cloud Run. Num serviço, o ingress container deve escutar em 0.0.0.0 na porta configurada, disponibilizada por PORT; escutar apenas em loopback impede o percurso esperado. Cloud Run termina TLS antes de encaminhar para o container segundo o contrato. Um job é diferente: executa trabalho até terminar, com código zero para sucesso e não-zero para falha; não deve ficar à espera de pedidos como um servidor. Estas distinções também afetam logs, timeout e conclusão. Prepara o processo para terminar de forma controlada e não assumes que a memória local sobreviverá à substituição da instância. Conserva estado necessário num mecanismo adequado.
Aplicação guiada
Numa integração fictícia, A invoca B com autenticação. Verifica identidade do chamador, papel Invoker no destino e ID token com audience de B ou uma audience personalizada aceite. Privilégio adicional não corrige um token destinado a outro serviço. Para tarefas assíncronas, uma falha depois de persistir e antes de confirmar pode provocar nova entrega; o handler deve reconhecer a operação sem repetir o efeito. Na release, observa sinais por revisão e compreende a interação entre traffic split e session affinity. A afinidade pode fazer a distribuição observada divergir das percentagens configuradas, sobretudo quando um cliente gera muitos pedidos. Usa evidência de erros e resultados por versão para decidir avanço, mantendo recuperação que inclua dados e configuração.
Uma tarefa pode ter produzido o efeito mesmo quando o serviço não recebeu a resposta 2xx.
Armadilhas comuns
Loopback como ingress; job como servidor; Invoker como audience; percentagem como quota exata por cliente.
Tópicos relacionados: Estado, cache e fluxos assíncronos · Credenciais, segredos e acesso · Build, artefactos e proveniência
Liga o contrato técnico à confirmação do resultado que a aplicação produz.
Referência: Cloud Run container contract · Current linked guide; edition date unconfirmed (2026-09-30 inspection)