La respuesta corta
Dale a cada pull request su preview, con variables que no sean secretos de producción, una base que no sea la de producción, y una limpieza cuando el pull request se cierra.
La falla habitual no es un preview que no arranca. Es un preview que funciona porque está hablando con producción. Las tres preguntas de abajo son cómo evitarlo. Cómo prender la función en una app Next.js está en desplegar Next.js con previews de pull request. Si estás dejando Railway, la alternativa a Railway es la comparación, y las previews en Unbroker piden Pro.
Qué es un entorno de preview
Un entorno de preview corre el código de un pull request para que alguien lo abra antes del merge. Staging es un entorno compartido para el release que estás por publicar. Un preview es descartable y pertenece a ese pull request.
Un preview por pull request y un staging compartido
Un solo entorno de staging es fácil de mantener, y todos los pull requests abiertos comparten sus datos y sus variables. Un preview por pull request deja dos cambios separados, y hay que limpiar cada uno. En Unbroker, un proyecto tiene entornos de production, custom y preview. Nombres como staging, qa y dev se muestran como entornos propios. Desde el 14 de octubre de 2026, los previews de pull request son entornos de preview del proyecto, no proyectos aparte.
Otros nombres
Heroku llama review apps a la misma idea: una app descartable que corre el código de un pull request de GitHub y tiene una URL para compartir. Otros hosts dicen preview deployments o ephemeral environments. Esos nombres no son una comparación de precio. Esta nota no repite las tarifas de nadie.
1. Variables de entorno: qué tiene que recibir un preview y qué no
Un preview tiene que recibir API keys de prueba, URLs de webhooks de sandbox y una base que se pueda borrar. No tiene que recibir contraseñas de producción.
En Unbroker, una variable de servicio o de proyecto es All, Production o Preview. Un valor con alcance de entorno pisa All para la misma clave. Las variables que ya existían quedan en All hasta que las cambies. Un preview nuevo copia All y Preview, y nunca copia los valores que son solo de Production. Un preview que ya existe se queda con la copia que tiene. Pasar la etiqueta a Production no saca un secreto de un preview que ya lo recibió. Sacalo ahí, o recreá el preview, y rotá la credencial si pudo filtrarse. Las variables de servicio, las compartidas del proyecto, los prefijos públicos del build y la rotación están en variables de entorno y secretos.
GitHub Actions, salvo GITHUB_TOKEN, no pasa secretos a un workflow que dispara un fork. Unbroker no crea previews automáticos de pull request para ramas de afuera del repositorio conectado, porque ese código podría leer los secretos del preview. Un fork se puede revisar por otro camino. No lo resuelvas poniendo secretos de producción en All.
2. Bases: con qué habla el preview
El preview corre el connection string que le diste. El tráfico privado dentro de Unbroker se queda en la misma organización y el mismo entorno, así que un preview no llega a los pods de producción por ese camino. Una URL que pegás en una variable no es esa red privada. Si el string es el de producción, el preview está sobre datos de producción.
Una base de staging compartida
Todos los previews hablan con una base que estás dispuesto a romper. La configuración es una variable. Una migración en cualquier pull request cambia ese schema para todos. Los datos semilla se mezclan en cuanto dos ramas escriben.
Una base nueva por pull request
Cada pull request recibe una base vacía y una semilla. Los cambios de schema se quedan en ese pull request. La base la tenés que crear, cargar y borrar con el pull request. La documentación de Unbroker no dice que el producto cree esa base por vos. La home dibuja una base nueva en un pull request. Ese dibujo no es un comportamiento documentado, así que esta nota no lo afirma.
Migraciones
Corré una migración solo contra la base que ese preview puede cambiar. Apuntada a la base de staging compartida, cambia staging para todos. Apuntada a producción, cambia producción. Postgres en producción es donde el restore y el rollback de datos se separan de un rollback de código. Correr esa migración una vez, antes de que el release quede live, está en migraciones de base de datos en el deploy.
3. Ciclo de vida: builds, limpieza y lo que queda
Abrir o actualizar un pull request crea o actualiza el preview cuando el servicio tiene previews prendidos. Cerrar el pull request desmonta el stack. Mergearlo también lo elimina. Un preview que se cortó a mitad se retoma. Una tarea de limpieza también borra los previews vencidos. La actividad en un preview renueva un vencimiento de siete días.
Los deploys manuales, los deploy hooks y los previews de pull request ignoran los watch paths. Un preview igual se construye cuando el pull request se actualiza, aunque el cambio esté fuera de las rutas que saltearían un push a la rama de producción. Qué rama despliega ese push, y cuándo espera los checks de GitHub, está en Desplegar con git push. Los previews heredan la protección de acceso del servicio y su ajuste de Wait for CI. Solo corren código de ramas del repositorio conectado.
Unbroker no publica un precio aparte para un preview. Los previews requieren Pro. Esta nota no inventa un cargo por hora ni por pull request.
El tráfico de un proyecto se puede filtrar a production o a preview. Esa vista pide un plan pago y una celda que recolecte tráfico.
Previews y agentes de código
Un agente puede abrir un pull request que parece terminado y igual apunta a la base equivocada. Revisá ese pull request en un preview que no pueda leer producción. Después mergeá.
Cómo darle un token al agente, y qué no tiene que ver ese token, está en dejar que un agente despliegue con cuidado. La lista de producción de la app está en desplegar una app hecha con Cursor. Ninguna de las dos páginas se repite acá.
Lista de un entorno de preview
Hacé esto antes del primer pull request de alguien que no seas vos. Cada línea es un control.
- Prendé previews de pull request solo en un plan que los incluya.
- Poné los secretos de producción en Production, no en All.
- Dale al preview API keys de prueba y webhooks de sandbox.
- Apuntá el preview a una base que puedas borrar.
- No pegues el connection string de producción en una variable Preview.
- Decidí si los previews comparten una base de staging o si creás una base por pull request.
- Corré las migraciones solo contra esa base elegida.
- Cerrá un pull request de prueba y confirmá que el preview desapareció.
- Rotá cualquier secreto que un preview viejo ya haya copiado.
- Revisá el pull request de un agente en ese preview antes de mergear.
Cómo se ve en Unbroker
Los previews de pull request requieren Pro. Las variables son All, Production o Preview, y un preview nuevo copia solo All y Preview. Los previews son entornos del proyecto, no proyectos aparte. Cerrar o mergear el pull request elimina el preview. Un preview cortado a mitad se retoma. Qué incluye Pro está en precios. El mapa de deploys es el resumen de deployments. El tutorial de Git es Deploy from Git.
Preguntas frecuentes
¿Qué es un entorno de preview de un pull request?
Es una copia en marcha de la rama del pull request, separada de producción, para abrir ese cambio antes de mergear. En Unbroker, abrir o actualizar un pull request de GitHub crea o actualiza ese preview cuando el servicio lo tiene habilitado. Cerrar o mergear el pull request lo elimina.
¿Cuál es la diferencia entre un entorno de staging y un preview?
Staging es un lugar compartido para el próximo release. Un preview está atado a un pull request y se va con ese pull request. En Unbroker, staging es un entorno con nombre del proyecto. Los previews de pull request son entornos de preview de ese mismo proyecto, no proyectos aparte.
¿Un preview tiene que usar las variables de producción?
No. Un preview que puede leer secretos de producción también los puede leer quien abre el pull request. En Unbroker, un preview nuevo copia All y Preview y no recibe los valores que son solo de Production. Poné la credencial de la base de producción en Production, no en All, salvo que quieras que los previews la vean.
¿Qué base tiene que usar un entorno de preview?
No la de producción. Una base de staging compartida es simple y una migración de un pull request puede romperla para los demás. Una base nueva por pull request, con datos semilla, queda aislada y la tenés que crear vos. La documentación de Unbroker no dice que cada preview reciba su propia base. La base la elegís con una variable de alcance Preview.
¿Cómo corro migraciones en un entorno de preview?
Correlas solo contra la base que ese preview puede cambiar. Una migración apuntada a una base de staging compartida cambia ese schema para todos los otros previews. Una migración apuntada a producción cambia producción. La documentación no describe una base automática por pull request.
¿Qué pasa con el preview cuando se cierra el pull request?
En Unbroker, cerrar el pull request desmonta el stack de ese preview, y mergearlo también lo elimina. Un preview que se cortó a mitad se retoma. La actividad en el preview renueva un vencimiento de siete días, y una tarea de limpieza borra los previews vencidos.
¿Los entornos de preview cuestan mientras corren?
Unbroker no publica un precio aparte para un preview. Los previews de pull request de GitHub requieren Pro. Esta nota no inventa un cargo por preview.
¿Cómo reviso el pull request de un agente de código antes de mergear?
Abrí el pull request del agente en un preview que no tenga credenciales de producción ni la base de producción. Leé el cambio, y después mergeá. Cómo darle un token al agente está en el post del agente, y no se repite acá.