Despliegue de Rebase en Scaleway

Scaleway es un proveedor de nube europeo con sede en Francia, con centros de datos en París, Ámsterdam y Varsovia; una excelente opción para organizaciones que priorizan la soberanía de datos de la UE.

Utiliza la Managed Database de Scaleway para Postgres y Serverless Containers para el runtime.

Nada en esta página es específico de Scaleway con respecto a tu proyecto. Un despliegue de Rebase consta de dos partes separables: la imagen de runtime publicada y el bundle que produce rebase build, y el mismo bundle se ejecuta bajo Docker Compose en una portátil, en Rebase Cloud, bajo el Helm chart y aquí.

1. Crear una base de datos Postgres administrada

1. En la consola de Scaleway, ve a PostgreSQL.
2. Haz clic en Create a Database Instance.
3. Elige una región (p. ej., París — PAR1).
4. Selecciona un tipo de nodo (Play2-Pico o Pro2-XXS funcionan bien).
5. Añade un nombre de base de datos (rebase_db) y una contraseña de usuario segura.
6. Una vez desplegada, anota la Connection string (URI) del panel: postgres://user:password@ip:port/rebase_db

Si tus colecciones declaran una propiedad vector, habilita la extensión una vez: CREATE EXTENSION vector; en la base de datos.

2. Compilar el bundle e integrarlo en una imagen

No hay ninguna imagen de aplicación que compilar a partir de tu código fuente. rebase build genera un directorio dist-bundle con tus colecciones compiladas, funciones, crons y, si tu proyecto declara una aplicación estática, tu frontend compilado. La imagen de runtime publicada lo ejecuta:

rebase build

Serverless Containers descarga desde un registro, así que integra el bundle en una imagen derivada. Tres líneas, y fija exactamente lo que se ejecuta:

FROM rebasepro/server:0.24.0
COPY dist-bundle /bundle

1. Ve a Container Registry en la consola de Scaleway y crea un namespace (p. ej., rebase-apps).
2. Inicia sesión en el registro desde tu terminal siguiendo las instrucciones que se muestran.
3. Compila y haz push, desde la raíz del proyecto:

docker build -t rg.fr-par.scw.cloud/rebase-apps/rebase-backend:latest .
docker push rg.fr-par.scw.cloud/rebase-apps/rebase-backend:latest

Actualizar Rebase más adelante es tan simple como cambiar esa línea FROM. Tu bundle permanece intacto.

3. Desplegar el Serverless Container

1. Navega a Serverless Containers.
2. Haz clic en Create a Container.
3. Elige la imagen que acabas de subir.
4. Establece el puerto en 8080, el puerto en el que escucha la imagen de runtime a menos que PORT indique lo contrario.
5. En Environment Variables, añade:

Clave	Valor
DATABASE_URL	La URI del paso de Managed Postgres
JWT_SECRET	Una cadena aleatoria segura de más de 32 caracteres para firmar tokens de autenticación
REBASE_SERVICE_KEY	Una cadena aleatoria segura de más de 32 caracteres
NODE_ENV	production
CORS_ORIGINS	El dominio de tu frontend (p. ej., https://yourdomain.com)
FRONTEND_URL	La URL de tu frontend (usada para enlaces de correo electrónico y respaldo de CORS)
DISABLE_SELF_REGISTRATION	true
REBASE_ADMIN_EMAIL	La dirección del primer administrador, establecida antes del primer arranque
REBASE_ADMIN_PASSWORD	Al menos 12 caracteres

Las últimas tres son la forma en que este despliegue obtiene un administrador: en producción, la primera cuenta que se registra no se promociona automáticamente, por lo que nada más produce el primer usuario autenticado. Consulta Tu primer administrador. Marca los secretos como variables de entorno secretas en lugar de normales.

6. Apunta el health check a /livez. No a /health: este último realiza un viaje de ida y vuelta a la base de datos, por lo que una prueba de liveness sobre él reiniciará un contenedor en buen estado durante una breve interrupción de la base de datos.
7. Haz clic en Deploy Container.

Scaleway aprovisiona el contenedor y te proporciona un endpoint público (p. ej., https://rebase-backend-xxxx.functions.fnc.fr-par.scw.cloud).

Para un cumplimiento estricto de los datos, verifica que los detalles de tu organización de Scaleway reflejen tu entidad corporativa europea.

4. El esquema

El runtime crea las tablas que faltan durante el arranque, incluidas las de tus colecciones. REBASE_MIGRATE_ON_BOOT tiene por defecto el valor ensure, el cual es aditivo en todo el esquema: crea las tablas, columnas y tipos enum faltantes y aplica su seguridad a nivel de fila (row-level security, RLS), por lo que el primer inicio contra una base de datos vacía se pone en marcha sirviendo tus colecciones.

Lo que ensure nunca hace es cambiar algo que ya existe: no altera el tipo de una columna, no elimina nada ni edita las etiquetas de un enum existente, ya que el reinicio de un contenedor no debe remodelar un esquema como efecto secundario de un despliegue.

Por lo tanto, todavía queda una cosa que requiere la CLI, ejecutada desde una copia local del código o un trabajo de CI con DATABASE_URL apuntando a tu Managed Database:

rebase db push

Cualquier cambio que no sea puramente aditivo: una columna renombrada, un tipo restringido o un campo eliminado.

La imagen de runtime se distribuye sin la CLI, por lo que esto nunca se ejecuta dentro del contenedor. Para migraciones versionadas, haz commit de los archivos de migración con rebase db generate y ejecuta rebase db migrate como un paso del release en su lugar.

Almacenamiento de archivos

Los Serverless Containers no tienen disco duradero, por lo que el almacenamiento local de archivos implica una pérdida silenciosa de datos y el runtime lo rechaza en producción. Scaleway Object Storage es compatible con S3 y se encuentra en los mismos centros de datos:

STORAGE_TYPE=s3
S3_BUCKET=my-uploads
S3_ENDPOINT=https://s3.fr-par.scw.cloud
S3_REGION=fr-par
S3_ACCESS_KEY_ID=...
S3_SECRET_ACCESS_KEY=...

Consulta Almacenamiento para ver todos los detalles.

Próximos pasos

• Despliegue: la lista de verificación de producción y las reglas del primer administrador comunes a todas las plataformas.
• Configuración: todas las variables de entorno que lee el runtime.