Despliegue de Rebase en Fly.io

Fly.io te permite alojar contenedores Docker cerca de tus usuarios a través de su red global anycast. Fly es altamente configurable en cuanto al enrutamiento de datos, lo que lo convierte en una excelente opción para desplegar aplicaciones Rebase con un estricto enfoque en datos europeos.

Fly.io cuenta con centros de datos en Ámsterdam (ams), Fráncfort (fra), Madrid (mad) y París (cdg).

1. Inicializar la aplicación Fly

Desde tu repositorio local de Rebase, después de asegurarte de que la CLI de Fly (flyctl) está instalada, ejecuta:

fly launch

1. Nombre de la Aplicación: my-rebase-app
2. Organización: Personal o tu Organización corporativa.
3. Región: Cuando se te pida una región, elige explícitamente un centro de datos europeo como Fráncfort (fra) o París (cdg).
4. Base de Datos: Cuando se te pida configurar una base de datos Postgres, di Sí. Fly creará automáticamente un clúster de Postgres en la misma región e inyectará de forma segura la DATABASE_URL en tu aplicación.
5. Redis: Di No.

No despliegues todavía cuando se te pida. Primero necesitamos configurar una variable de entorno crítica.

2. Configuración del Secreto JWT

Antes de que tu aplicación se inicie en producción, debes inyectar el Secreto JWT para que Rebase pueda firmar de forma segura las operaciones de los tokens de autenticación.

Ejecuta el siguiente comando localmente:

fly secrets set JWT_SECRET=your_super_long_randomly_generated_secure_string -a my-rebase-app

3. Validar la Configuración Interna

Fly habrá generado un archivo fly.toml en la raíz de tu proyecto. Verifica que el puerto interno se alinee explícitamente con la configuración predeterminada de Rebase (3001):

# fly.toml
app = "my-rebase-app"
primary_region = "fra"

[build]
  dockerfile = "backend/Dockerfile" # El Dockerfile del backend necesita todo el workspace como contexto de compilación

[http_service]
  internal_port = 3001 # Make sure this matches your Hono app port
  force_https = true
  auto_stop_machines = true
  auto_start_machines = true
  min_machines_running = 1

4. Desplegar

Tus datos están localizados, tu base de datos está provisionada y tus secretos están inyectados. Inicia el despliegue:

fly deploy

Una vez que el análisis y la carga se completen, tu aplicación estará en línea automáticamente. ¡Ejecuta fly open para ver tu aplicación desplegada en el navegador!

5. 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 la base de datos de Fly no está expuesta públicamente, abre un túnel local con fly proxy 5432 -a my-rebase-app-db y apunta DATABASE_URL a localhost:5432 mientras lo ejecutas.

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