Orbit
Implementaciones de Vista Previa de Rama en Orbit
Branch previews build every non-production, non-staging branch you push to its own isolated URL, so you can click through a change in a real environment before it merges. This guide covers turning…
Habilitación de Vistas Previas de Ramas
- Abre tu proyecto en Orbit.
- Abre la pestaña Settings.
- Busca la sección Runtime y activa Branch previews.
Una vez habilitado, cada push a una rama que no sea tu rama de producción ni tu rama de staging activa una compilación y la implementa en su propio entorno de vista previa.
Las vistas previas de ramas son un toggle por proyecto, no un complemento de pago. Están disponibles en todos los planes de Orbit, incluyendo el plan Launch gratuito. Lo que difiere según el plan es cuántos entornos puede tener un único proyecto a la vez: Launch permite 2 (producción más una vista previa), Liftoff 4 y Apex 11. Una vez que un proyecto alcanza su límite de entornos, las ramas posteriores no obtendrán su propia vista previa hasta que elimines una.
URLs de Vista Previa
Una vista previa obtiene un nombre de host derivado del nombre de su rama: el nombre se convierte a minúsculas, cada carácter que no sea una letra, dígito o guión se convierte en un guión, las secuencias de guiones se contraen y el resultado se trunca a 48 caracteres y se le añade el prefijo branch-.
| Rama | Nombre de host de vista previa |
|---|---|
redesign | branch-redesign.kaps.run |
feat/new-checkout | branch-feat-new-checkout.kaps.run |
JB/Fix_Cart | branch-jb-fix-cart.kaps.run |
Las URLs de vista previa son accesibles públicamente por cualquiera que tenga el enlace. No están indexadas ni publicitadas, pero tampoco están controladas por acceso. No uses una vista previa para revisar nada que no deba salir de tu equipo y no apuntes una vista previa a datos de producción. Si necesitas un entorno de preproducción protegido, usa un entorno de staging en su lugar: staging admite una contraseña y una lista de permitidos de IP en Settings, en las secciones Staging: access protection y Staging: IP allowlist.
Dónde Aparecen las Vistas Previas
La pestaña Overview del proyecto tiene una sección Preview deployments que enumera todas las vistas previas activas. Cada fila muestra:
- El nombre de la rama y una insignia PR #number que enlaza con la solicitud de extracción cuando la rama tiene una abierta
- El estado actual (QUEUED, BUILDING o en vivo)
- Cuánto tiempo hace que se implementó
- Un enlace para abrir la URL de vista previa
- View logs para abrir la página de detalle de implementación
- Un botón de eliminar
Cada vista previa es un entorno completamente aislado con su propia URL, su propia compilación y sus propias variables de entorno. Nada de lo que haga puede afectar la producción.
La pestaña Branches del proyecto proporciona la misma información organizada por rama, lo que es más fácil de escanear cuando tienes varias abiertas a la vez.
Variables de Entorno en Vistas Previas
Esta es la parte que vale la pena hacer correctamente. Una variable con alcance All environments (project-wide) se inyecta en compilaciones de vista previa, y una URL de vista previa es pública.
- Mantén las credenciales de producción limitadas solo a tu entorno de producción.
- Dale a las vistas previas credenciales de modo de prueba o sandbox para servicios de terceros.
- Nunca dejes una URL de base de datos de producción o una clave de pago en vivo en alcance de proyecto.
La mecánica completa, incluyendo cómo agregar una variable solo de producción y cómo funciona la herencia de staging, se encuentra en Setting Environment Variables Per Environment.
Registros de Compilación para una Vista Previa
Haz clic en View logs junto a cualquier vista previa para abrir su página de detalle de implementación. Las vistas previas reciben el mismo trato que las implementaciones de producción: registro de compilación de transmisión completa, fases de compilación, commit y autor, tamaño de artefacto, acierto de caché o compilación en frío, framework y gestor de paquetes detectados, y el botón de diagnóstico de IA cuando falla una compilación.
Eliminación de una Vista Previa
Haz clic en el botón de eliminar en la fila de vista previa y confirma.
Eliminar una vista previa elimina el entorno y todo su historial de compilación, no solo la implementación actual. No se puede deshacer. La rama en sí no se ve afectada, así que hacer push a ella nuevamente crea una vista previa nueva desde cero, sin historial y con un caché de compilación en frío.
Limpieza Automática
No tienes que limpiar después de ti.
- Cuando se cierra o se fusiona una solicitud de extracción, su entorno de vista previa se pausa inmediatamente y deja de servir. Los visitantes obtienen un 404 en lugar de una compilación obsoleta.
- Eliminar una rama pausa la vista previa de esa rama de la misma manera.
- Las vistas previas pausadas se recopilan como basura aproximadamente un día después: los tarballs de origen, artefactos de compilación y cachés de compilación se eliminan y el entorno se archiva.
También puedes hacer que las vistas previas expiren en un horario. En Settings, busca Preview expiry y elige Never, 7, 14, 30 o 60 días. Las vistas previas más antiguas que eso se pausan automáticamente y se limpian en 24 horas.
En un repositorio ocupado, establece Preview expiry en 14 o 30 días. Cada vista previa activa cuenta contra el límite de entornos de tu proyecto, y las expiradas son la razón usual por la que una rama nueva falla silenciosamente para obtener una vista previa.
Aprobación y Vistas Previas
Si Require approval for production está habilitado en Deploy protection, se aplica solo a la producción. Las compilaciones de vista previa no se retienen para aprobación.
Para evitar que una vista previa específica implemente cambios adicionales sin eliminarla, pausa el entorno desde la pestaña Environments. Las nuevas implementaciones en un entorno pausado se omiten hasta que lo reanudes.
Solución de Problemas
Una rama fue pusheada pero no apareció ninguna vista previa. Comprueba, en orden: ¿está Branch previews activado en Settings, luego Runtime? ¿Es la rama realmente tu rama de staging (staging se implementa en staging, no en una vista previa)? ¿Coincide la rama con uno de tus Branch ignore patterns, por ejemplo dependabot/*? ¿El proyecto ya está en su límite de entornos para tu plan?
La vista previa se compiló pero muestra un 404. La compilación tuvo éxito pero el directorio de salida es probablemente incorrecto para esta rama. Comprueba Output directory en Settings, y recuerda que una rama puede cambiar la salida de compilación sin cambiar la configuración. Consulta Configuring Your Build Command and Output Directory.
La vista previa muestra un commit más antiguo. Al hacer push a un nuevo commit mientras una compilación para la misma rama aún se está ejecutando, se cancela la compilación en vuelo y se inicia una nueva. Si ves una implementación cancelada seguida de una en ejecución, eso es lo esperado. Espera a la segunda compilación.
La vista previa de un PR cerrado aún es accesible. La pausa ocurre en el evento webhook. Si la conexión del proveedor fue desconectada cuando cerraste el PR, el evento nunca llegó. Elimina la vista previa manualmente desde la pestaña Overview.
Lectura Relacionada
- Deploying Your Project
- Setting Environment Variables Per Environment
- Orbit Plan Limits para la asignación de entornos en cada plan