Orbit
Ver registros de compilación
Every Orbit deployment keeps its complete build log, plus a structured breakdown of what the build did and how long each phase took. This guide covers where to find the log, how to read the…
Cada despliegue de Orbit mantiene su registro de compilación completo, más un desglose estructurado de lo que hizo la compilación y cuánto tiempo tomó cada fase. Esta guía cubre dónde encontrar el registro, cómo leer los metadatos circundantes y el análisis que Orbit ejecuta sobre el registro para ti.
Ver el registro de la despliegue más reciente
Abre el proyecto en Orbit. El panel Latest build en la pestaña Overview muestra el registro de la despliegue más reciente. Si una compilación se está ejecutando en este momento, el registro se transmite en vivo, línea por línea, a medida que el agente de compilación lo produce.
Haz clic en Full details para abrir la página completa de detalles de despliegue.
Ver registros de una despliegue específica
- Abre tu proyecto en Orbit.
- Abre la pestaña Deployments.
- Haz clic en cualquier despliegue para abrir su página de detalles.
- El registro de compilación completo está en esa página.
La lista Recent deployments en la pestaña Overview tiene un enlace View logs en cada fila que va al mismo lugar. Las despliegues de vista previa tienen el mismo enlace en la sección Preview deployments.
Fases de compilación
La página de detalles divide la compilación en fases nombradas con una duración para cada una:
| Fase | Qué sucede |
|---|---|
| Clone | Recuperando tu repositorio en el commit desplegado |
| Cache restore | Desempaquetando el node_modules en caché, en planes con caché de compilación |
| Install | Ejecutando tu comando de instalación |
| Cache save | Reempaquetando node_modules para la siguiente compilación |
| Build | Ejecutando tu comando de compilación |
| Upload | Empaquetando el directorio de salida y almacenando el artefacto |
| Done | El artefacto está en frente del tráfico |
Esta es la forma más rápida de responder "por qué esa compilación fue lenta". Una fase Install larga con una insignia Cold build significa que el caché se perdió. Una fase Build larga significa que tu propia compilación se ralentizó.
Metadatos de compilación
Las tarjetas encima del registro muestran los datos sobre la despliegue:
| Tarjeta | Qué muestra |
|---|---|
| Status | Queued, Building, Deploying, Succeeded, Failed, Cancelled, Rolled back o Awaiting approval |
| Commit | El commit que esta despliegue compiló, vinculando al proveedor |
| Branch | La rama git de la que proviene |
| Author | Quién hizo push del commit |
| Build time | Tiempo total de reloj de pared, con una calificación Fast, Normal o Slow contra tu propio historial |
| Artifact | Tamaño del resultado empaquetado, con un enlace de descarga |
| Framework | El marco que Orbit detectó |
| Package manager | npm, yarn o pnpm, detectado desde tu lockfile |
| Build cache | Cache hit o Cold build |
| Build host | Qué host de compilación lo ejecutó |
| Queue position | Tu lugar en la cola, mientras la despliegue aún está en cola |
| Pull request | El número de PR, para una despliegue de vista previa |
| Health score | Una puntuación de 100 con las deducciones listadas |
Análisis que Orbit ejecuta sobre el registro
La página de detalles no es solo un volcado de texto. Orbit analiza el registro y resalta lo que importa.
- Build timeline con duraciones por fase.
- Slow build detected cuando una compilación es significativamente más lenta que tu mediana propia, con el porcentaje y tu tiempo típico de las últimas 10 compilaciones.
- TypeScript errors, extraídos y contados, cuando la compilación falló en la verificación de tipos.
- Build analysis para compilaciones de Next.js: tamaños por ruta, JS de primera carga y conteos de rutas static, dynamic e ISR.
- Bundle regression advertencias cuando el JS de primera carga de una ruta crece más del 20% versus la despliegue anterior, o el paquete JS compartido crece.
- npm audit resultados analizados directamente desde la salida de instalación, resumidos por severidad.
- Security headers audit puntuado de 60 puntos.
- Smoke test resultados, si has configurado rutas de smoke test.
- Performance budgets excedidos, si has establecido presupuestos.
- Build optimization advisor, listando cambios concretos con un ahorro de tamaño estimado, clasificado por impacto.
- Real user metrics, los Core Web Vitals p75 registrados mientras esa despliegue estaba en vivo.
Qué variables de entorno vio realmente la compilación
La página de detalles lista las claves de variables de entorno que se inyectaron en tiempo de compilación, y las compara contra tu configuración actual: añadidas, cambiadas, removidas, sin cambios. Las claves de color turquesa vinieron de una anulación específica del entorno, las grises del nivel del proyecto.
Los valores nunca se almacenan y nunca se muestran. Pasar el ratón sobre una clave te da una huella dactilar SHA-256, que es suficiente para confirmar que dos entornos tienen el mismo valor sin revelarlo.
Este diff es la forma más rápida de responder "¿entró realmente mi cambio de variable de entorno en la compilación?". Si la despliegue predateca el cambio, Orbit lo dice con un aviso Environment variables updated since this deployment y te recuerda que el cambio no tendrá efecto hasta que redesplegues.
Comparar dos despliegues
Haz clic en Compare en una despliegue para compararla contra la anterior: tiempo de compilación, tamaño de artefacto, estado del caché, marco y diff de artefacto a nivel de archivo. Esta es la ruta más rápida a "qué cambió realmente" cuando una despliegue se comporta diferente de la anterior.
Cuando una compilación falla
La tarjeta de estado se vuelve Failed y el registro muestra dónde se detuvo. Encima del registro, Orbit añade un resumen de falla categorizado con una solución sugerida. Las categorías reconocidas incluyen falta de memoria, error de compilación, fallo de prueba, error de lint, error de instalación, error de red y tiempo de espera agotado, y Orbit coincide con patrones específicos como un módulo faltante, un conflicto de dependencia peer ERESOLVE, un código de error TypeScript, un disco de compilación lleno, un paquete 404 y un lockfile desactualizado.
También hay un botón Get AI diagnosis, que lee las últimas 120 líneas del registro junto con el marco detectado y la categoría de falla y devuelve una explicación en lenguaje natural.
El diagnóstico de IA está etiquetado como AI-generated, verify before acting por una razón. Es muy bueno señalándote la línea correcta del registro, y no es autoritario sobre tu base de código. Lee la línea del registro a la que se refiere antes de cambiar algo.
Reintentar una compilación fallida
En la página de detalles de despliegue, haz clic en Retry build para re-ejecutar el mismo commit sin hacer push de uno nuevo. Esto soluciona fallos transitorios como un error de red durante la instalación.
Si sospechas una dependencia en caché obsoleta, usa More retry options, luego Retry with cleared cache, que elimina el caché de compilación antes de reintentar.
La guía completa fallo por fallo está en Troubleshooting Failed Builds.
Cancelar una compilación en ejecución
Haz clic en Cancel mientras una compilación se está ejecutando.
Cancelar termina la máquina de compilación inmediatamente y no se puede deshacer. La despliegue se registra como Cancelled, y la despliegue previamente en vivo continúa sirviendo tráfico, así que cancelar nunca deja tu sitio caído. Ten en cuenta que hacer push de un nuevo commit a la misma rama mientras una compilación se está ejecutando cancela la compilación en vuelo automáticamente, así que una despliegue cancelada seguida de una en ejecución es normal.
Descargar el artefacto
Cada despliegue exitosa mantiene su resultado empaquetado. Haz clic en Download en la tarjeta Artifact para descargar el paquete exacto que se sirvió. También hay un navegador de artefactos para inspeccionar el contenido sin descargar todo.
Cuánto tiempo se guardan los artefactos se establece en Settings, bajo Artifact retention: el número de artefactos exitosos a mantener por entorno, de 10 a 500, predeterminado a 50. Los artefactos más antiguos se eliminan diariamente. El artefacto de la despliegue actualmente en vivo siempre se mantiene, sea cual sea la configuración.
La retención de artefactos es lo que hace posible el rollback. Configurarlo demasiado bajo acorta cuán atrás puedes revertir una despliegue mala sin una recompilación. Si desplegas muchas veces al día, auméntalo en lugar de disminuirlo.