Implementando Rebase na Google Cloud Platform

Google Cloud Platform (GCP) oferece uma experiência de desenvolvedor incrivelmente fluida para aplicações conteinerizadas. Para uma configuração de produção robusta, utilizamos o Cloud SQL para o banco de dados e o Cloud Run como a espinha dorsal de contêineres sem servidor.

Para manter a estrita conformidade de dados europeus, certifique-se de operar inteiramente dentro de uma região da UE, como europe-west3 (Frankfurt), europe-west9 (Paris), ou europe-west1 (Bélgica).

1. Provisionar Cloud SQL (PostgreSQL)

1. Navegue até o console do Cloud SQL na sua região preferida da UE.
2. Clique em Criar Instância e selecione PostgreSQL.
3. Defina seu ID de Instância e gere uma senha segura integrada para o usuário postgres.
4. Expanda as Opções de Configuração para alocar o Tipo de Máquina correto (uma máquina padrão de 2 vCPUs é um ótimo começo).
5. Certifique-se de que o banco de dados esteja configurado para IP Privado ou redes de IP Público Autorizado, dependendo da sua configuração VCP com o Cloud Run.
6. Monte sua URI de conexão: postgresql://postgres:YOUR_PASSWORD@YOUR_IP:5432/postgres

2. Compilar e Implementar no Cloud Run

O Cloud Run dimensiona o backend Node.js do Rebase automaticamente para zero (se desejado) e gerencia o TLS de forma nativa. Você pode compilar e implementar a aplicação em um único movimento de CLI a partir do seu workspace local usando o Google Cloud Build.

Certifique-se de ter o CLI gcloud instalado e autenticado:

# Set your active GCP project
gcloud config set project YOUR_PROJECT_ID

# Authenticate Docker against the registry host (one-time)
gcloud auth configure-docker gcr.io

# Build from the project root: the backend Dockerfile needs the whole workspace as
# its build context (it copies pnpm-workspace.yaml, backend/ and config/), so the
# context is "." and not "./backend"
docker build -f backend/Dockerfile -t gcr.io/YOUR_PROJECT_ID/rebase-backend .

# Push the image to the registry
docker push gcr.io/YOUR_PROJECT_ID/rebase-backend

# Deploy the newly built image to Cloud Run
gcloud run deploy rebase-backend \
  --image gcr.io/YOUR_PROJECT_ID/rebase-backend \
  --region europe-west3 \
  --port 3001 \
  --set-env-vars DATABASE_URL="postgresql://...",JWT_SECRET="YOUR_SECURE_RANDOM_STRING",NODE_ENV="production" \
  --allow-unauthenticated

3. Criar o Esquema do Banco de Dados

Ao iniciar, o Rebase cria automaticamente apenas as tabelas de autenticação. As tabelas das suas próprias coleções não são criadas automaticamente. A aplicação sobe normalmente e o login funciona — por isso a armadilha passa despercebida —, mas toda coleção retorna um erro de tabela ausente (“missing table”) até você aplicar o esquema.

Execute pnpm run db:push uma vez contra o banco de dados de produção:

DATABASE_URL="postgresql://postgres:...@localhost:5432/postgres" pnpm run db:push

Rode isso a partir de um checkout do projeto ou da sua CI, com a DATABASE_URL apontando para produção — não dentro do contêiner, pois a imagem de produção não inclui a CLI. Como o Cloud SQL normalmente não fica exposto publicamente, execute o Cloud SQL Auth Proxy localmente e aponte a DATABASE_URL para localhost.

Para migrações versionadas, use pnpm run db:generate seguido de pnpm run db:migrate em vez de db:push.

4. Gerenciar Armazenamento de Arquivos

Como as instâncias do Cloud Run são estritamente sem estado e efêmeras, você não pode usar armazenamento em disco local para uploads de arquivos do Rebase.

1. Navegue até o Google Cloud Storage e crie um novo bucket privado na região da UE escolhida.
2. Siga a Documentação de Armazenamento do Rebase para configurar o Rebase para usar a API compatível com S3 fornecida pelo Google Cloud Storage em vez do sistema de arquivos local.

Sua instância Rebase está agora totalmente sem servidor e altamente escalável nativamente dentro da UE!