Um revisor de segurança abre o seu diagrama de arquitetura do Google Cloud e faz três perguntas. Alguém consegue chamar a URL do Cloud Run diretamente e pular o Cloud Armor? Como um serviço serverless alcança um banco de dados que só tem IP privado? O que acontece com um evento de pedido quando o worker falha? Se o diagrama é uma grade de ícones de produtos, nenhuma das respostas está nele.
Um diagrama de arquitetura do GCP útil mostra onde cada coisa fica, como as requisições viajam e as configurações que decidem segurança e capacidade. Este post percorre um app web típico do Google Cloud, do balanceador de carga e do Cloud Run até o Cloud SQL e o Pub/Sub, e as escolhas por trás de cada parte.
Comece pela hierarquia de recursos
Os recursos do Google Cloud ficam em uma árvore: uma organização, pastas opcionais e projetos. Papéis do IAM e políticas da organização definidos em um nó valem para tudo que está abaixo dele (hierarquia de recursos). As pastas podem ser aninhadas em até 10 níveis e fazem o papel dos grupos de gerenciamento de uma landing zone do Azure ou das unidades organizacionais (OUs) de uma landing zone da AWS.
Um layout comum é uma pasta por ambiente e um projeto por aplicação e ambiente, como shop-prod sob production. O projeto delimita faturamento, cotas e a maioria das concessões do IAM, e o ingress interno do Cloud Run só confia no Pub/Sub do mesmo projeto ou do mesmo perímetro do VPC Service Controls.
O exemplo, requisição por requisição
O exemplo é uma loja online no projeto shop-prod: uma arquitetura de três camadas com computação serverless em us-central1.
- O domínio aponta para o IP anycast de um Application Load Balancer externo global, que encerra o TLS com um certificado gerenciado pelo Google, aplica uma política do Cloud Armor e serve respostas em cache do Cloud CDN.
- O URL map envia
/api/*para o serviçoapie todo o resto paraweb, cada um por meio de um grupo de endpoints de rede (NEG) serverless. webmantém sessões e um cache de páginas no Memorystore for Valkey.apiusa o Cloud SQL for PostgreSQL por IP privado.apipublica eventos de pedido no Pub/Sub, que os envia por push paraworker, um terceiro serviço do Cloud Run que grava PDFs de faturas no Cloud Storage.- As credenciais ficam no Secret Manager; logs e métricas vão para o Cloud Logging e o Cloud Monitoring.
No momento da escrita (novembro de 2026), uma instância do Cloud Run aceita 80 requisições simultâneas por padrão (80 por vCPU via gcloud ou Terraform), e uma revisão escala até 100 instâncias.
Ingress e contas de serviço
Todo serviço do Cloud Run recebe uma URL run.app, e o ingress é all por padrão, então qualquer pessoa com a URL pode pular o balanceador de carga e o Cloud Armor. Defina o ingress de web e api como internal-and-cloud-load-balancing (configurações de ingress). Requisições do balanceador não carregam identidade do Google, então esses serviços também precisam ser públicos; o Google recomenda desativar a verificação do IAM Invoker em vez de conceder o papel de invoker a allUsers. O worker usa o ingress internal, que ainda admite o Pub/Sub do mesmo projeto, e mantém tanto a verificação do IAM quanto a URL padrão, que a chamada de push do Pub/Sub usa.
Por padrão, o Cloud Run executa o código com a conta de serviço padrão do Compute Engine, que pode ter o papel Editor no projeto, dependendo da política da organização. Dê a cada serviço a sua própria:
| Conta de serviço | Papéis (recurso) |
|---|---|
web-sa |
Nenhum; alcança o Memorystore pela VPC |
api-sa |
Pub/Sub Publisher (tópico orders), Secret Manager Secret Accessor (seus secrets) |
worker-sa |
Storage Object Creator (bucket invoices), Secret Manager Secret Accessor (seus secrets) |
push-sa |
Cloud Run Invoker (worker), usada pela assinatura push |
Secrets em variáveis de ambiente são lidos quando uma instância inicia, então fixe uma versão (db-password:3 abaixo).
Rede serverless: Direct VPC egress ou conector
O Cloud Run não roda dentro da sua VPC, então, para alcançar os IPs privados do Cloud SQL ou do Memorystore, o tráfego de saída precisa entrar em uma sub-rede. O Google recomenda o Direct VPC egress em vez de um conector do Serverless VPC Access; ambos estão em disponibilidade geral.
| Direct VPC egress | Conector do VPC Access | |
|---|---|---|
| Custo | Apenas egress de rede | Egress mais as VMs do conector |
| Latência e vazão | Latência menor, vazão maior | Latência maior, vazão menor |
| Endereços IP | Cerca de dois por instância | Menos |
A sub-rede deve ser /26 ou maior, o Cloud Run usa o dobro de endereços em relação às instâncias, e uma revisão que reduz a escala mantém seus endereços por até 20 minutos. Em um rollout, api limitada a 40 instâncias pode reter (40 + 40) × 2 = 160 endereços. No padrão de 100, um único serviço precisa de 400, mais que os 252 utilizáveis de uma /24, então some todos os serviços da sub-rede. Instâncias novas também podem esperar um minuto ou mais antes de o egress funcionar, então adicione uma sonda de inicialização que teste uma dependência real.
gcloud run deploy api \
--image=us-central1-docker.pkg.dev/shop-prod/app/api:1.42 \
--region=us-central1 \
--service-account=api-sa@shop-prod.iam.gserviceaccount.com \
--ingress=internal-and-cloud-load-balancing \
--no-invoker-iam-check \
--network=shop-vpc --subnet=run-us-central1 \
--vpc-egress=private-ranges-only \
--max-instances=40 \
--set-secrets=DB_PASSWORD=db-password:3
Escolhendo o armazenamento de dados
Os SLAs abaixo são de disponibilidade mensal na maioria das regiões:
| Serviço | Escolha quando | SLA |
|---|---|---|
| Cloud SQL | PostgreSQL, MySQL ou SQL Server padrão com menos de 64 TB | Com HA: 99,95%, ou 99,99% no Enterprise Plus |
| AlloyDB | PostgreSQL com carga pesada ou análises sobre dados ativos | 99,99% com HA |
| Spanner | Dados relacionais além de um único primary, ou gravações em várias regiões | 99,99% regional, 99,999% multirregional |
| Firestore | Documentos para clientes web e mobile com sincronização offline | 99,99% regional, 99,999% multirregional |
| Bigtable | Terabytes de dados de chave única com baixa latência | 99,9% a 99,999%, conforme a replicação |
O Cloud SQL HA mantém um standby replicado de forma síncrona em uma segunda zona, e um failover leva cerca de 60 segundos (alta disponibilidade). Com o Cloud Run, fique de olho nas conexões: max_connections é 500 por padrão com 15 a 30 GB de memória, e cada instância do Cloud Run pode abrir até 100. Limite api a 40 instâncias com um pool de 10 e ela chega no máximo a 400, deixando folga.
Trabalho assíncrono: Pub/Sub ou Cloud Tasks
O push do Pub/Sub exige acertar quatro detalhes:
- O worker confirma retornando 102, 200, 201, 202 ou 204.
- O prazo de confirmação (de 10 a 600 segundos, padrão 10) precisa exceder o tempo de processamento, ou o Pub/Sub reentrega enquanto a primeira tentativa ainda roda.
- Um tópico de mensagens mortas recebe uma mensagem após 5 tentativas de entrega por padrão; o agente de serviço do Pub/Sub precisa de permissão para publicar nele.
- A entrega é pelo menos uma vez, então torne o worker idempotente; nomeie cada PDF com o ID do pedido.
Escolha o Cloud Tasks quando o remetente deve controlar a entrega: tarefas agendadas, limites de taxa de até 500 despachos por segundo por fila e deduplicação. O Pub/Sub serve para fan-out para vários assinantes. O diagrama de arquitetura serverless cobre mais padrões de eventos.
Regiões e alta disponibilidade
Falhas de zona estão cobertas: o Cloud Run se distribui entre zonas, as réplicas do Memorystore ficam em outras zonas e o standby do Cloud SQL assume. Os SLAs, porém, se compõem: 99,95% do Cloud Run vezes 99,95% do Cloud SQL HA dá cerca de 99,90%, ou 43 minutos de indisponibilidade em um mês de 30 dias (0,1% de 43.200 minutos).
Para uma queda de região, implante uma segunda região e adicione o NEG serverless dela a cada serviço de backend. O balanceador então envia os usuários à região mais próxima, e a detecção de outliers tira o tráfego de uma região com falha. Os dados são a parte difícil: uma réplica entre regiões do Cloud SQL que você promove, ou Spanner multirregional. O failover multirregião na AWS e o diagrama de arquitetura de recuperação de desastres cobrem essas escolhas.
Equivalência entre AWS e Google Cloud
| AWS | Google Cloud |
|---|---|
| Organizations, OUs, contas | Organização, pastas, projetos |
| ALB, CloudFront, AWS WAF | Application Load Balancer externo global, Cloud CDN, Cloud Armor |
| ECS on Fargate, Lambda | Serviços, jobs, worker pools e funções do Cloud Run |
| RDS, Aurora | Cloud SQL, AlloyDB |
| ElastiCache | Memorystore |
| SQS, SNS | Cloud Tasks, Pub/Sub |
| CloudWatch | Cloud Logging, Cloud Monitoring |
| VPC (regional) | VPC (global, com sub-redes regionais) |
As equivalências são aproximadas; a comparação de serviços do Google lista mais. Do lado da AWS, veja sub-redes e tabelas de rotas em uma VPC para a rede e ECS on Fargate para contêineres.
O diagrama do app web no Google Cloud
Conteúdo do diagrama
- Project shop-prod (folder: production)
- us-central1
- Users
- Global external Application LB
- web frontend
- api
- worker
- Memorystore for Valkey
- Cloud SQL for PostgreSQL
- Cloud Storage
- Pub/Sub topic
- Secret Manager
- Cloud Logging and Monitoring
- HTTPS
- /*
- /api/*
- sessions, page cache
- SQL over private IP
- publish
- push
- invoice PDFs
Como ler:
- Molduras mostram o escopo. A moldura externa é o projeto shop-prod na pasta production; a caixa azul é a região us-central1. Serviços globais ficam fora da região.
- Arestas azuis são o caminho das requisições: HTTPS até o balanceador, depois
/*para o frontend web e/api/*para a api; a nota lista Cloud Armor, Cloud CDN e o certificado. - Arestas verdes são acesso a dados: Memorystore para sessões, a instância HA do Cloud SQL por IP privado e Cloud Storage para os PDFs de faturas.
- Arestas roxas tracejadas são assíncronas. A api publica, o Pub/Sub faz push para o worker e um tópico de mensagens mortas recolhe as mensagens após cinco tentativas.
- Secret Manager e o logging levam notas em vez de arestas, e o bloco Markdown lista as configurações principais.
Desenhando diagramas de arquitetura do Google Cloud com clareza
- Aninhe a hierarquia: uma moldura de projeto com a pasta no rótulo, a região dentro e os serviços globais fora da região. Não desenhe o Cloud Run dentro de uma sub-rede; ele envia egress para lá, mas não vive lá.
- Nomeie o produto em cada rótulo. Uma caixa chamada banco de dados convida a uma pergunta; Cloud SQL for PostgreSQL with HA responde a ela.
- Coloque as configurações de segurança na página: ingress, IPs privados e contas de serviço.
- Rotule as arestas com rotas e dados, e tracele as assíncronas.
- Deixe de fora ferramentas de build, cópias por zona de serviços regionais e vínculos do IAM; mantenha os papéis em uma tabela.
Monte no Archboard
- Entre com Google ou GitHub e crie um diagrama.
- Adicione uma Moldura do pacote Básico com o rótulo Project shop-prod (folder: production) e, dentro dela, uma Região do pacote Nuvem com o rótulo us-central1.
- Coloque uma Pessoa do pacote Modelo C4 à esquerda da moldura para os usuários. Dentro da moldura, à esquerda da região, adicione um Balanceador de carga na nuvem do pacote Nuvem e uma nota Texto do Básico para Cloud Armor, Cloud CDN e o certificado.
- Na região, adicione três nós Recurso de nuvem do pacote Nuvem com os nomes web frontend, api e worker, e defina o tipo de recurso deles como Cloud Run service.
- Ao lado deles, adicione um nó Redis do pacote Dados para o Memorystore, depois Banco de dados gerenciado e Armazenamento de objetos do pacote Nuvem para o Cloud SQL e o Cloud Storage.
- Fora da região, adicione um Tópico do pacote Dados para o Pub/Sub, um Cofre do pacote Segurança para o Secret Manager e um nó Registros do pacote DevOps, com notas Texto do Básico.
- Desenhe arestas rotuladas: HTTPS, /, /api/, sessions and page cache, SQL over private IP e invoice PDFs. Deixe publish e push tracejados.
- Adicione um bloco Markdown do pacote Básico com as configurações principais.
O Archboard não importa de uma conta ativa do Google Cloud; se o projeto está em Terraform, a ferramenta gratuita Terraform to diagram gera um primeiro rascunho editável. Veja os diagramas de arquitetura em nuvem para os tipos de nós de nuvem. O exemplo usa 14 nós de diagrama e fica dentro do plano Free.
Perguntas frequentes
O que um diagrama de arquitetura do Google Cloud deve mostrar? O projeto e a pasta, a região, cada componente no caminho das requisições e as configurações que decidem a segurança: ingress, IPs privados e contas de serviço. Serviços globais como o Pub/Sub ficam fora da caixa da região.
O Cloud Run roda dentro de uma VPC? Não. Ele roda em infraestrutura gerenciada pelo Google; o Direct VPC egress ou um conector envia o tráfego de saída para a sua sub-rede, para que ele alcance IPs privados.
Devo usar Direct VPC egress ou um conector do Serverless VPC Access? Direct VPC egress para a maioria dos serviços: o Google o recomenda, a latência é menor e você paga apenas pelo egress. Um conector usa menos endereços IP e dá cold starts mais rápidos atrás do Cloud NAT.
Como impedir que usuários contornem o Cloud Armor? Defina o ingress do Cloud Run como internal-and-cloud-load-balancing para que o tráfego da internet passe pelo Application Load Balancer externo, e desative a URL run.app padrão onde nenhum serviço do Google precisar dela.
Quantas conexões o Cloud Run pode abrir com o Cloud SQL? Até 100 por instância. Mantenha o máximo de instâncias vezes o tamanho do pool abaixo de max_connections (500 por padrão com 15 a 30 GB de memória), ou use o Managed Connection Pooling no Enterprise Plus.