Deployment
Desplegar Rebase en Hostman
Hostman ofrece dos modalidades que se adaptan a un backend de Rebase, con centros de datos en Europa y EE. UU.:
- App Platform con Managed PostgreSQL. Hostman compila y ejecuta tu aplicación desde un repositorio de GitHub y opera la base de datos. Sus contenedores se inician limpios en cada despliegue, por lo que las subidas de archivos necesitan un bucket compatible con S3 desde el primer día.
- Un servidor en la nube. Postgres y el runtime en un VPS, bajo el
docker-compose.ymlque ya tiene tu proyecto. Las subidas pueden permanecer en el disco del servidor.
Nada en esta página sobre tu proyecto es específico de Hostman. Un despliegue de Rebase consta de dos piezas separables: la imagen de runtime publicada y el bundle que genera rebase build, y el mismo bundle se ejecuta en una laptop, en Rebase Cloud y aquí.
App Platform
Sección titulada «App Platform»1. Crea la base de datos
Sección titulada «1. Crea la base de datos»En el panel de Hostman, crea un clúster de Managed PostgreSQL:
- Versión: 16 o más reciente.
- Región: aquella en la que ejecutarás la aplicación.
- Red: una red privada. Coloca la aplicación en la misma red en el paso 4. La red de una aplicación se elige cuando se crea y no se puede cambiar después.
El clúster viene con un usuario, gen_user, y una base de datos, default_db. Desde la pestaña Connection, copia la cadena de conexión para la IP privada. Esta es tu DATABASE_URL:
postgresql://gen_user:<password>@<private-ip>:5432/default_dbSi el clúster requiere TLS, añade ?sslmode=no-verify al final: cifrado, sin verificar el certificado frente a una autoridad pública. El driver de Node sobre el que se ejecuta Rebase interpreta un simple sslmode=require como “verifícalo”, y falla con un certificado que no haya firmado una autoridad pública. Consulta Configuración.
Crea el rol al que cambia Rebase
Sección titulada «Crea el rol al que cambia Rebase»Rebase aplica la seguridad a nivel de fila cambiando cada solicitud autenticada a un rol restringido, rebase_user. Se debe permitir que gen_user cree ese rol y cambie a él.
-
En la pestaña Users del clúster, otorga a
gen_userel privilegio CREATE ROLE. La configuración más pequeña de Hostman (1 CPU, 1 GB RAM, 20 GB) no permite agregar usuarios ni bases de datos. Si no te permite conceder el privilegio, elige la siguiente configuración superior. -
Conéctate una vez como
gen_userconpsql, antes del primer despliegue, y ejecuta:CREATE ROLE rebase_user NOLOGIN NOSUPERUSER NOBYPASSRLS NOINHERIT;GRANT rebase_user TO gen_user WITH SET TRUE, INHERIT FALSE;La base de datos está en una red privada, así que ejecuta esto desde un servidor en la nube en la misma red o activa el acceso público temporalmente.
La segunda sentencia es la importante. En PostgreSQL 16 y versiones posteriores, un usuario que crea un rol sin ser superusuario se convierte en miembro de él, pero no en uno que pueda cambiar a él. Si el runtime crea el rol por sí mismo, el inicio es exitoso y cada solicitud autenticada falla después con DB_PERMISSION_DENIED. Si eso ya ocurrió, ejecuta la línea GRANT y reinicia la aplicación.
Si tus tablas declaran una columna col.vector(), habilita pgvector en Configuration → Extensions. El scaffold inicial no declara ninguna.
2. Crea un bucket
Sección titulada «2. Crea un bucket»Crea un bucket compatible con S3: el propio almacenamiento S3 de Hostman o cualquier otro proveedor. En la configuración del bucket, anota el endpoint, la región, la access key y la secret key. Mantén el bucket privado: Rebase firma cada descarga y storageAuthorize en backend/storage.ts decide quién puede leer, escribir y listar.
3. Añade un Dockerfile
Sección titulada «3. Añade un Dockerfile»App Platform compila desde tu repositorio, y como dist-bundle/ está en el .gitignore, la imagen construye el bundle por sí misma y luego se lo entrega al runtime publicado. Haz commit de esto en la raíz del proyecto:
# Build the bundle from your sourceFROM node:22 AS buildWORKDIR /appCOPY . .RUN npx -y pnpm@11 install --frozen-lockfile && npx -y pnpm@11 run build
# The published runtime, with nothing added but the bundleFROM rebasepro/server:0.34.0COPY --from=build --chown=node:node /app/dist-bundle /bundleAquí importan tres detalles:
node:22, nonode:22-slim. Al instalar la CLI se descarga el motor de esquemas Atlas, que necesitacurly certificados de CA. La imagen slim no tiene ninguno de los dos y la instalación falla.--chown=node:node. El runtime se ejecuta comonodey vincula sus propios paquetes en el bundle al iniciar. Un bundle propiedad de root sigue funcionando, pero registra una advertencia por cada paquete que no pudo vincular.- Sin código fuente en la imagen final. Contiene el runtime y tu bundle compilado. Actualizar Rebase más adelante es simplemente cambiar la segunda línea
FROM.
La imagen del runtime escucha en el puerto 8080 y lo declara con EXPOSE, que es el puerto al que enruta App Platform.
4. Crea la aplicación
Sección titulada «4. Crea la aplicación»En App Platform, crea una aplicación Backend:
- Conecta el repositorio de GitHub y la rama.
- Establece Framework en Dockerfile.
- Elige la misma región que la base de datos y la red privada de la base de datos.
- Elige una configuración con 2 GB de RAM. El bundle se compila como parte de la imagen y la compilación alcanza un pico de aproximadamente 1 GB, por lo que una configuración de 1 GB puede quedarse sin memoria.
- Establece la ruta del health check en
/livez. La predeterminada,/, también funciona, pero/livezresponde sin tocar la base de datos, por lo que una breve interrupción en la base de datos no reiniciará una aplicación que funciona correctamente.
En Advanced settings, añade las variables de entorno:
NODE_ENV=productionDATABASE_URL=postgresql://gen_user:<password>@<private-ip>:5432/default_dbJWT_SECRET=<openssl rand -hex 32>REBASE_SERVICE_KEY=<openssl rand -hex 32, a second one>CORS_ORIGINS=https://<your-app-domain>FRONTEND_URL=https://<your-app-domain>DISABLE_SELF_REGISTRATION=trueREBASE_ADMIN_EMAIL=you@example.comREBASE_ADMIN_PASSWORD=<at least 12 characters>STORAGE_TYPE=s3S3_BUCKET=<bucket>S3_REGION=<region>S3_ENDPOINT=<endpoint>S3_ACCESS_KEY_ID=<access key>S3_SECRET_ACCESS_KEY=<secret key>S3_FORCE_PATH_STYLE=trueREBASE_ADMIN_EMAIL y REBASE_ADMIN_PASSWORD definen al primer administrador. En producción, la primera cuenta que se registra no se promueve, por lo que ninguna otra cosa creará una. El runtime crea la cuenta una sola vez, mientras la tabla de usuarios esté vacía. Consulta Tu primer administrador.
La dirección de la aplicación no se conoce hasta que existe. Crea la aplicación, consulta su dominio técnico desde la pestaña Dashboard, y luego asigna ese valor a CORS_ORIGINS y FRONTEND_URL. Guardar la configuración vuelve a desplegar la aplicación.
5. Ábrela
Sección titulada «5. Ábrela»Abre el dominio de la aplicación. Un único contenedor sirve el panel de administración en / y la API en /api. Inicia sesión con REBASE_ADMIN_EMAIL y REBASE_ADMIN_PASSWORD, y luego cambia la contraseña.
Cada push a la rama realiza un nuevo despliegue. Para añadir tu propio dominio, usa Settings → Domains. Hostman emitirá el certificado. Añade el nuevo origen a CORS_ORIGINS y FRONTEND_URL.
Un servidor en la nube
Sección titulada «Un servidor en la nube»Un servidor en la nube de Hostman ejecuta el mismo stack que cualquier VPS: Postgres y el runtime bajo el docker-compose.yml propio de tu proyecto, con Caddy al frente para HTTPS. Un servidor con 2 vCPU y 2 GB de RAM es suficiente para empezar.
Créalo con Ubuntu 24.04 y tu clave SSH, luego sigue los pasos para un solo servidor en la página de Hetzner. Nada en ellos depende de Hetzner.
En un servidor, las subidas permanecen en su disco: el archivo Compose las mantiene en un volumen con nombre y establece FORCE_LOCAL_STORAGE=true. Sobreviven a reinicios y nuevos despliegues, pero no a la pérdida del servidor, así que activa las copias de seguridad de servidores de Hostman o muévelas a un bucket cuando comiencen a ser importantes.
El esquema
Sección titulada «El esquema»El runtime crea las tablas faltantes al iniciar, incluidas las que declara backend/schema. REBASE_MIGRATE_ON_BOOT tiene como valor predeterminado ensure, que es aditivo en todo el esquema. Crea tablas, columnas y tipos enum faltantes y aplica su seguridad a nivel de fila, de modo que una nueva tabla esté disponible en el siguiente despliegue.
ensure nunca cambia algo que ya existe. No altera el tipo de una columna, no elimina nada ni edita las etiquetas de un enum existente, ya que un despliegue no debe remodelar un esquema como efecto secundario.
Cualquier cambio que no sea puramente aditivo (una columna renombrada, un tipo más restrictivo, un campo eliminado) necesita rebase db push, ejecutado desde una copia local:
pnpm exec rebase db push --dry-run --database-url '<connection string>'Revisa el SQL que imprime la ejecución de prueba (dry run) y luego ejecútalo nuevamente sin --dry-run. Dos cosas a preparar primero en Managed PostgreSQL:
- Accesibilidad. Una base de datos en una red privada no es accesible desde tu laptop. Habilita el acceso público temporalmente o ejecuta el comando desde un servidor en la misma red.
- La base de datos temporal.
db pushplanifica cada cambio en una copia desechable del esquema, en una base de datos con el mismo nombre que la tuya y terminada en_dev_diff. Otorga agen_userel privilegio CREATEDB o creadefault_db_dev_diffuna vez desde el panel. Ninguna de las dos opciones es posible en la configuración más pequeña.
Para migraciones con control de versiones, haz commit de los archivos de migración con rebase db generate y ejecuta rebase db migrate como un paso de la release en su lugar.
Próximos pasos
Sección titulada «Próximos pasos»- Despliegue — la lista de verificación para producción y las reglas del primer administrador comunes a todas las plataformas.
- Configuración — cada variable de entorno que lee el runtime.
- Almacenamiento — buckets, reglas de acceso y varias fuentes de almacenamiento a la vez.