Desplegando Rebase en Google Cloud Platform

Google Cloud Platform (GCP) ofrece una experiencia de desarrollador increíblemente fluida para aplicaciones contenerizadas. Para una configuración de producción robusta, aprovechamos Cloud SQL para la base de datos y Cloud Run para la columna vertebral de contenedores sin servidor.

Para mantener un estricto cumplimiento de datos europeos, asegúrate de operar completamente dentro de una región de la UE, como europe-west3 (Frankfurt), europe-west9 (París) o europe-west1 (Bélgica).

1. Aprovisionar Cloud SQL (PostgreSQL)

1. Navega a la consola de Cloud SQL en tu región de la UE preferida.
2. Haz clic en Crear Instancia y selecciona PostgreSQL.
3. Establece tu ID de Instancia y genera una contraseña segura integrada para el usuario postgres.
4. Expande las Opciones de Configuración para asignar el Tipo de Máquina correcto (una máquina estándar de 2 vCPU es un excelente comienzo).
5. Asegúrate de que la base de datos esté configurada para redes de IP Privada o IP Pública Autorizada, dependiendo de tu configuración de VCP con Cloud Run.
6. Ensambla tu URI de conexión: postgresql://postgres:YOUR_PASSWORD@YOUR_IP:5432/postgres

2. Compilar y Desplegar en Cloud Run

Cloud Run escala el backend Node.js de Rebase automáticamente a cero (si se desea) y maneja TLS de forma predeterminada. Puedes compilar y desplegar la aplicación en un solo movimiento CLI desde tu espacio de trabajo local usando Google Cloud Build.

Asegúrate de tener la CLI de gcloud instalada y autenticada:

# Set your active GCP project
gcloud config set project YOUR_PROJECT_ID

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

# Build from the project root — the backend Dockerfile needs the whole workspace as its build context (pnpm-workspace.yaml, backend/, config/)
docker build -f backend/Dockerfile -t gcr.io/YOUR_PROJECT_ID/rebase-backend .

# Push the image
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. Crear el Esquema de la Base de Datos

Al arrancar, Rebase crea automáticamente solo las tablas de autenticación. Las tablas de tus propias colecciones no se crean automáticamente. Debes aplicar el esquema una vez contra la base de datos de producción:

pnpm run db:push

Si omites este paso, la aplicación arranca con normalidad y el inicio de sesión funciona —esa es la trampa—, pero cada colección devuelve un error de «tabla inexistente» (missing table) en su primera consulta.

Ejecútalo desde un checkout del proyecto o desde CI con DATABASE_URL apuntando a la base de datos de producción, no dentro del contenedor: la imagen de producción se distribuye sin la CLI. Como Cloud SQL no está expuesto públicamente, ejecuta el Cloud SQL Auth Proxy en local y apunta DATABASE_URL a 127.0.0.1:5432 mientras lo ejecutas.

Para migraciones versionadas, usa pnpm run db:generate + pnpm run db:migrate en lugar de pnpm run db:push.

4. Gestionar Almacenamiento de Archivos

Dado que las instancias de Cloud Run son estrictamente sin estado y efímeras, no puedes usar el almacenamiento en disco local para las cargas de archivos de Rebase.

1. Navega a Google Cloud Storage y crea un nuevo bucket privado en tu región de la UE elegida.
2. Sigue la Documentación de Almacenamiento de Rebase para configurar Rebase para usar la API compatible con S3 proporcionada por Google Cloud Storage en lugar del sistema de archivos local.

¡Tu instancia de Rebase ahora es completamente sin servidor y altamente escalable de forma nativa dentro de la UE!

---