Pular para o conteúdo

Diagrama de arquitetura do Google Cloud: um app web no Cloud Run e Cloud SQL

Uma arquitetura de referência do Google Cloud para um app web, desenhada e explicada: balanceador de carga, Cloud Run, Cloud SQL, Memorystore, Pub/Sub, IAM e redes.

· Fundador e desenvolvedor

Publicado em

Diagrama de um projeto do Google Cloud com a região us-central1. Usuários enviam HTTPS a um balanceador global que roteia para os serviços web e api no Cloud Run. A api usa o Cloud SQL e publica no Pub/Sub, que faz push para um worker que grava PDFs no Cloud Storage.

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.

  1. 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.
  2. O URL map envia /api/* para o serviço api e todo o resto para web, cada um por meio de um grupo de endpoints de rede (NEG) serverless.
  3. web mantém sessões e um cache de páginas no Memorystore for Valkey. api usa o Cloud SQL for PostgreSQL por IP privado.
  4. api publica eventos de pedido no Pub/Sub, que os envia por push para worker, um terceiro serviço do Cloud Run que grava PDFs de faturas no Cloud Storage.
  5. 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

Diagrama de um projeto do Google Cloud com a região us-central1. Usuários enviam HTTPS a um balanceador global que roteia para os serviços web e api no Cloud Run. A api usa o Cloud SQL e publica no Pub/Sub, que faz push para um worker que grava PDFs no Cloud Storage.

19 componentes · 8 conexões

Abrir no Archboard
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
Um app web em um projeto do Google Cloud. Um Application Load Balancer global com Cloud Armor e Cloud CDN roteia para serviços do Cloud Run em us-central1, que alcançam Cloud SQL e Memorystore por IPs privados e passam o trabalho lento a um worker via Pub/Sub.

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

  1. Entre com Google ou GitHub e crie um diagrama.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
  7. Desenhe arestas rotuladas: HTTPS, /, /api/, sessions and page cache, SQL over private IP e invoice PDFs. Deixe publish e push tracejados.
  8. 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.

Comece grátis — um assento, sem cartão de crédito.

Artigos relacionados

← Voltar ao blog

Abra um canvas em um minuto

Entre com Google ou GitHub. Grátis para um assento. Faça upgrade quando a equipe entrar.