Despliegues, vistas previas y reversiones.
Cómo se publican los push, las vistas previas de ramas, volver a una versión anterior, el comando de release para migraciones, los ajustes de compilación, los hooks de despliegue, el modo mantenimiento y las contraseñas de las vistas previas.
Cuando una aplicación ya está en marcha, casi nunca necesitas el panel para publicar cambios: haz push a la rama y la nueva versión se publica sola. Este artículo explica todo lo que hay alrededor: la pestaña Despliegues, las Vistas previas, la pestaña Procesos y algunos interruptores de Ajustes.
Despliegues automáticos con cada push
Cada push a la rama de la aplicación compila el último commit y lo despliega. La nueva versión arranca junto a la que está funcionando y solo recibe visitantes cuando ya responde; si no llega a arrancar, la versión anterior sigue funcionando y te avisamos por correo (y por Telegram, si lo has conectado).
Un push hecho mientras otra compilación aún espera en la cola se une a esa compilación, así que una ráfaga de push no genera una cola larga.
Puedes desactivarlo en Ajustes → Desplegar cada push. Si lo desactivas, despliegas desde el panel, la API o un hook de despliegue.
Desplegar desde el panel
La pestaña Despliegues muestra todos los despliegues: qué los inició (un push, el panel, una reversión, un hook de despliegue), el commit, cuánto tardaron y su estado. Haz clic en un despliegue para ver su registro de compilación completo.
Volver a desplegar ofrece dos opciones:
- Compilar el último commit: toma el código más reciente de la rama y lo compila.
- Desplegar de nuevo la versión actual: aplica las variables modificadas sin una nueva compilación. Úsalo después de editar Variables.
El menú junto a Abrir tiene estas mismas dos acciones y además Reiniciar.
Volver a una versión anterior
Puedes volver a cualquiera de las últimas 5 versiones correctas. En la pestaña Despliegues, pulsa Revertir en la versión que quieras y confirma. La versión anterior arranca junto a la actual y toma el relevo en cuanto responde, sin nueva compilación.
Una reversión no deshace los cambios en la base de datos. Si una versión cambió la estructura de la base de datos, restaura también la base de datos. Consulta Bases de datos.
Vistas previas de ramas
Un push a cualquier otra rama tiene su propia vista previa: una dirección aparte donde puedes revisar los cambios antes de publicarlos. Ábrelas en la pestaña Vistas previas.
- Hasta 3 vistas previas a la vez, incluidas en tu precio.
- Una vista previa sin push nuevos durante 7 días se elimina. Se vuelve a crear con el siguiente push a esa rama.
- Las vistas previas solo reciben las variables pensadas para ellas. Consulta Variables de entorno.
- Las vistas previas se crean para el servicio principal de un proyecto, no para sus otros servicios.
Una contraseña para las vistas previas
En la pestaña Vistas previas, Contraseña para las vistas previas → Pedir contraseña. Escribe un nombre de usuario y una contraseña (de al menos 8 caracteres). A partir de ese momento, solo quien tenga la contraseña podrá abrir las vistas previas; la aplicación en sí sigue abierta para todos.
El comando de release (migraciones)
Pestaña Procesos → Comando de release. Se ejecuta una vez en cada despliegue, antes de que la nueva versión reciba visitantes; normalmente, las migraciones de la base de datos. Si falla, el despliegue se detiene y la versión actual sigue funcionando, así que una migración rota nunca llega a tus visitantes.
Proponemos un comando para los frameworks que lo tienen:
| Framework | Comando de release recomendado |
|---|---|
| Laravel | php artisan migrate --force |
| Django | python manage.py migrate --noinput |
| Prisma (Node.js) | npx prisma migrate deploy |
Usar el comando recomendado lo mantiene; también puedes escribir el tuyo o elegir Ninguno. Los cambios se aplican a partir del siguiente despliegue.
Ajustes de compilación
Ajustes → Ajustes de compilación te permite cambiar lo que detectamos:
- Comando de instalación: por ejemplo,
npm ci - Comando de compilación: por ejemplo,
npm run build - Comando de inicio: el comando que arranca tu aplicación. Debe escuchar en el puerto indicado en
$PORT. - Carpeta de salida: para sitios estáticos, la carpeta con los archivos compilados.
- Carpeta del proyecto: para un repositorio con varios proyectos.
Deja un campo vacío para usar lo que detectamos. El siguiente despliegue se compila con los nuevos ajustes; Compilar ahora lo inicia al momento.
En Ajustes también está la Rama que se despliega.
Hooks de despliegue
Ajustes → Hooks de despliegue → Crear un hook. Un hook de despliegue es una dirección privada: cuando otro servicio le envía una petición POST, se compila y despliega el último commit de tu rama. Un uso típico es un CMS que recompila el sitio después de que publicas.
curl -X POST "<the hook address from the panel>"- La dirección se muestra una sola vez: cópiala al crear el hook. Cualquiera que la tenga puede iniciar un despliegue, así que guárdala en privado.
- Hasta 10 despliegues por hora por hook. Una llamada que llega mientras una compilación aún espera se une a ella.
- Revocar desactiva la dirección al momento; los servicios que la llaman necesitarán una nueva.
Modo mantenimiento
Ajustes → Modo mantenimiento → Mostrar la página de mantenimiento. Los visitantes ven una página breve con tu mensaje en lugar de la aplicación; si dejas el mensaje vacío, se muestra «Estamos haciendo algunas mejoras. Vuelve a intentarlo dentro de un rato.»
La aplicación en sí sigue funcionando, así que puedes revisarlo todo antes de volver a abrirla. Un enlace privado para ti muestra la aplicación con normalidad durante 12 horas en el dispositivo que lo abre. Nuevo enlace crea uno nuevo y el anterior deja de funcionar.
Desactiva el interruptor para volver a abrir la aplicación a los visitantes.
Notificaciones sobre los despliegues
Te escribimos por correo (y por Telegram, si lo has conectado) cuando un despliegue no termina. Para enviar también eventos a tu equipo (se publicó una nueva versión, un despliegue no terminó, un servicio se detuvo o volvió, uso alto de memoria o de procesador, una copia de seguridad o el disco de una base de datos), añade Slack, Discord o tu propio webhook en Ajustes → Notificaciones para tu equipo. Los mensajes del webhook son JSON firmados con un secreto que se muestra una sola vez, en la cabecera X-Rivervo-Signature.