GCP: onde o produto roda em produção

A fundação de tudo: o Google Cloud Platform. É onde a plataforma roda, escala e onde mora boa parte da infra.

O que é

A nuvem do Google. Usamos um conjunto de serviços dela como base de produção e dados de infra.

Onde usamos

• Cloud Run — roda o container Next.js (clubpetro-web, projeto boot-308904, região southamerica-east1). Escala gerenciada, sem administrar servidor.
• Artifact Registry — imagens de container.
• Secret Manager — secrets injetados no deploy.
• BigQuery — dados de custo (FinOps).
• GKE / Monitoring — métricas e infra de produtos core.

Cloud Run: conceitos que importam

• Concorrência — requisições simultâneas por instância (ajuste conforme a carga por request).
• Min instances — mantém instâncias quentes pra evitar cold start (latência do primeiro request).
• Memória/CPU + boost — CPU boost acelera o arranque; dimensione com base no uso real.
• Revisões — todo deploy cria uma revisão; rollback = apontar tráfego pra revisão anterior.

Como começar / deploy

• GOOGLE_CLOUD_PROJECT_ID e afins; FinOps usa BIGQUERY_PROJECT_ID / BIGQUERY_CREDENTIALS_JSON.
• Build do container (Docker local, com Cloud Build como fallback) → gcloud run deploy.

Boas práticas

• IAM de menor privilégio — cada serviço/conta só com o que precisa.
• Secrets no Secret Manager, nunca em env plana versionada.
• Confirme pós-deploy — revisão recebendo tráfego, secrets presentes, health checks ok.

Pegadinhas (cicatrizes reais)

• ⚠️ NUNCA deploy via REST API PATCH — apaga os secrets. Sempre gcloud run deploy --set-secrets.
• ⚠️ --set-env-vars substitui tudo — pra mudar uma só, use --update-env-vars.
• ⚠️ Worktree sem node_modules (.superset/worktrees) — pnpm install antes de buildar/deployar.
• ⚠️ Região importa — deploy, Artifact Registry e banco perto reduzem latência e custo de egress.

Quando usar (e quando não)

É a fundação de produção — não é escolha por feature, é onde tudo vive. Rollback é decisão rápida e sem ego quando algo dá errado.

A nuvem é a fundação invisível: quando tudo está certo, ninguém lembra dela. O cuidado no deploy é o que a mantém invisível.

Próximo da série: #13 — n8n.