Despliegue de Rebase en AWS

Amazon Web Services (AWS) proporciona una escala increíble y seguridad de nivel empresarial. Para un despliegue de Rebase en producción, recomendamos desacoplar la arquitectura utilizando Amazon RDS para la base de datos PostgreSQL y AWS App Runner (o ECS Fargate) para servir el runtime.

Para mantener un estricto cumplimiento normativo de datos europeo, asegúrese de operar completamente dentro de una región de la UE, como eu-central-1 (Frankfurt), eu-west-1 (Ireland) o eu-west-3 (Paris).

Nada en esta página es específico de AWS en lo que respecta a su proyecto. Un despliegue de Rebase se compone de dos partes separables: la imagen del runtime publicada y el bundle que produce rebase build, y el mismo bundle se ejecuta bajo Docker Compose en un portátil, en Rebase Cloud, bajo el Helm chart y aquí. Moverse entre ellos es un cambio de infraestructura, no de aplicación.

1. Aprovisionar Amazon RDS (PostgreSQL)

1. Navegue a la consola de RDS en la región de la UE seleccionada.
2. Haga clic en Create database y seleccione Standard create.
3. Elija el motor PostgreSQL.
4. En Templates, elija Production o Free tier/Dev según su carga.
5. Cree un Master Username (por ejemplo, rebase_admin) y genere de forma segura una Master Password.
6. En Connectivity, asegúrese de que la base de datos esté ubicada dentro de una VPC a la que su futura instancia de App Runner pueda acceder de forma segura (o hágala accesible públicamente si controla estrictamente los rangos de IP de entrada).
7. Una vez aprovisionada, anote la Endpoint address y construya su URI: postgresql://rebase_admin:YOUR_PASSWORD@YOUR_ENDPOINT:5432/postgres

Si sus colecciones declaran una propiedad vector, la instancia necesita la extensión pgvector; RDS la incluye, pero debe habilitarse ejecutando CREATE EXTENSION vector; en la base de datos una sola vez.

2. Construir el bundle e integrarlo en una imagen

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

rebase build

Para App Runner, que extrae imágenes desde un registro, integre el bundle en una imagen derivada. Son solo tres líneas y fija con exactitud lo que se ejecuta:

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

1. Navegue a Elastic Container Registry y cree un repositorio privado llamado rebase-backend.
2. Copie los comandos de push que AWS muestra en la consola; estos gestionan la autenticación de Docker.
3. Construya y haga push desde la raíz del proyecto:

   docker build -t rebase-backend .

4. Añada la etiqueta (tag) y súbala mediante push a su repositorio de ECR.

Actualizar Rebase más adelante consiste únicamente en cambiar esa línea FROM. Su bundle permanece intacto y nada en su proyecto se vuelve a compilar.

3. Desplegar mediante AWS App Runner

App Runner es la forma más sencilla de ejecutar contenedores en AWS sin necesidad de gestionar orquestadores.

1. Navegue a AWS App Runner y haga clic en Create service.
2. Seleccione Container registry y elija Amazon ECR.
3. Busque y seleccione su imagen rebase-backend.
4. En Service settings, configure el puerto en 8080, el puerto en el que escucha la imagen del runtime a menos que PORT indique lo contrario.
5. Configure la ruta del health check en /livez. No en /health: este realiza un ciclo de ida y vuelta a la base de datos, por lo que una sonda de liveness sobre él reiniciaría un servicio perfectamente sano durante un breve contratiempo de la base de datos.
6. Añada las variables de entorno:

Clave	Valor
DATABASE_URL	Su cadena de conexión de RDS
JWT_SECRET	Una cadena segura generada aleatoriamente (más de 32 caracteres)
REBASE_SERVICE_KEY	Una cadena segura generada aleatoriamente (más de 32 caracteres)
NODE_ENV	production
CORS_ORIGINS	El dominio de su frontend (por ejemplo, https://yourdomain.com)
FRONTEND_URL	La URL de su frontend (utilizada para enlaces de correo y fallback 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 tres últimas 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. Consulte Su primer administrador. Guarde los secretos en AWS Secrets Manager y haga referencia a ellos en lugar de escribirlos directamente en el formulario de la consola.

7. (Opcional) Si su instancia de RDS es estrictamente privada, configure la red Custom VPC en App Runner para que el contenedor pueda conectarse a la base de datos.
8. Haga clic en Create & deploy.

AWS gestiona la terminación TLS, proporcionándole una URL https lista para usar.

4. El esquema

El runtime crea las tablas que faltan durante el arranque, incluidas las de sus colecciones. REBASE_MIGRATE_ON_BOOT tiene como valor predeterminado ensure, que es aditivo en todo el esquema: crea las tablas, columnas y tipos enum faltantes y aplica su seguridad a nivel de fila (RLS), de modo que el primer inicio contra una instancia de RDS vacía comienza a servir sus 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 una tarea de CI con DATABASE_URL apuntando a RDS:

rebase db push

Cualquier cambio que no sea puramente aditivo: una columna renombrada, un tipo más restrictivo, un campo eliminado.

Si la instancia es privada, ejecútelo desde CI o desde un host bastión dentro de la misma VPC. La imagen del runtime se distribuye sin la CLI, por lo que esto nunca se ejecuta dentro del contenedor de App Runner. Para migraciones versionadas, confirme los archivos de migración con rebase db generate y ejecute rebase db migrate como un paso de la versión (release step).

Almacenamiento de archivos

Las instancias de App Runner no disponen de disco persistente, por lo que el almacenamiento local de archivos provocaría una pérdida silenciosa de datos y el runtime lo rechaza en producción. Cree un bucket de S3 en la misma región y configure STORAGE_TYPE=s3 junto con su bucket y credenciales; consulte Almacenamiento.

Próximos pasos

• Despliegue — la lista de comprobació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.