Orbit
Implementando Tu Proyecto
Once a repository is connected, Orbit deploys on every push to your production branch: it clones the commit, installs dependencies, runs your build, packages the output and starts serving it. This…
Una vez que se conecta un repositorio, Orbit implementa en cada push a su rama de producción: clona el commit, instala dependencias, ejecuta su compilación, empaqueta la salida e inicia su servicio. Esta guía cubre el ciclo completo de implementación, cómo activar uno manualmente y los controles que deciden cuándo se permite que una implementación se publique.
Cómo funcionan las implementaciones automáticas
Cada push a la rama establecida como Production branch en Settings, luego Git, activa una implementación. Orbit entonces:
- Recibe el evento push de GitHub, GitLab o Bitbucket.
- Pone en cola una implementación y le asigna un slot de compilación.
- Clona su repositorio en ese commit exacto.
- Restaura su
node_modulesalmacenado en caché si la caché de compilación está disponible en su plan. - Ejecuta su comando de instalación (
npm ci,yarn installopnpm install, detectado de su lockfile). - Ejecuta su comando de compilación.
- Empaqueta el directorio de salida en un artefacto de implementación y lo carga.
- Cambia el entorno para servir el nuevo artefacto.
La página de detalle de implementación muestra estas fases como Build phases nombradas: Clone, Cache restore, Install, Cache save, Build, Upload, Done. La mayoría de los proyectos se completan en uno a tres minutos.
Estados de implementación
| Estado | Significado |
|---|---|
| Queued | Esperando un slot de compilación. La página de implementación muestra su posición en la cola |
| Awaiting approval | Retenido porque Require approval for production está activado. Alguien debe aprobarlo |
| Building | Instalando dependencias y ejecutando su comando de compilación |
| Deploying | Compilación terminada, el nuevo artefacto se está poniendo frente al tráfico |
| Succeeded (mostrado como Live) | Sirviendo tráfico. La implementación lleva una insignia CURRENT |
| Failed | El paso de compilación o implementación tuvo un error. Abra el registro para ver dónde |
| Cancelled | Detenido antes de completarse, por usted o por un nuevo push a la misma rama |
| Rolled back | Reemplazado por una reversión a una compilación anterior |
Observar una compilación en progreso
El Overview del proyecto muestra la compilación actual con un registro en transmisión en vivo en el panel Latest build. Haga clic en Full details para abrir la página de detalle de implementación, que añade una barra de progreso de compilación, un tiempo estimado restante, la posición en la cola y la línea de tiempo de compilación desglosada por fase.
Si su plan permite más de una compilación simultánea y todas están ocupadas, la página se lo dice claramente: muestra cuántos de sus slots de compilación simultáneos están en uso e inicia su implementación automáticamente cuando se libera uno. Puede ver cada compilación en vuelo en todos sus proyectos en Orbit, luego Queue.
Activar una implementación manualmente
Hay cuatro formas de implementar sin hacer push de un nuevo commit.
Reimplementar el último commit
- Abra el proyecto.
- Abra la pestaña Deployments.
- Haga clic en la implementación que desea, para abrir su página de detalle.
- Haga clic en Retry build. Use More retry options, luego Retry with cleared cache, si sospecha que hay una dependencia almacenada en caché obsoleta.
Deploy Now
El botón Deploy now en la pestaña Deployments pone en cola una compilación nueva del head actual de su rama de producción.
Programar una implementación
Una implementación puede programarse para un tiempo futuro. Orbit captura el commit en el momento en que lo programa, de modo que la compilación que se ejecuta más tarde es el código que aprobó, no lo que llegó mientras tanto.
Deploy Hooks
Un deploy hook es una URL secreta que pone en cola una compilación cuando algo le envía una solicitud POST. Úselos para recompilar desde un CMS headless, un trabajo cron o un pipeline CI. Configúrelos en la pestaña Hooks del proyecto. Consulte Activar implementaciones a través de Deploy Hooks.
Configuración de compilación
Orbit detecta valores por defecto sensatos para la mayoría de los proyectos. Invalide cualquiera de ellos en Settings, luego Build settings:
| Campo | Marcador de posición cuando está en blanco | Ejemplos |
|---|---|---|
| Install command | npm ci (auto-detected) | npm ci, yarn install --frozen-lockfile, pnpm install |
| Build command | npm run build (auto-detected) | npm run build, next build, vite build, astro build |
| Output directory | dist (auto-detected) | dist, .next, out, build, .output |
| Root directory | / (monorepo subdirectory) | apps/web |
| Node.js version | Platform default | 18, 20, 22 |
Deje un campo en blanco para mantener el valor detectado automáticamente. Obtener todos los detalles, incluidos los valores por framework y los errores que causan que la primera implementación falle, en Configurar su comando de compilación y directorio de salida.
Establecer un Root directory hace más que cambiar el directorio de trabajo. Los pushes que solo cambian archivos fuera de esa ruta se omiten automáticamente, por lo que un monorepo no se recompila en cada commit.
Decidir cuándo se permite una implementación
Orbit tiene varias puertas independientes. Todas ellas se encuentran en Settings.
Bloqueos de implementación
Use un bloqueo para congelar la producción durante un incidente, una ventana de mantenimiento o una congelación de código.
- Abra el proyecto.
- Haga clic en Lock deploys.
- Añada una razón opcional.
Mientras está bloqueado, las implementaciones de producción activadas por push se omiten silenciosamente y una pancarta lee Production deploys are locked con su razón. Las implementaciones manuales siguen funcionando, lo cual es intencional: un bloqueo detiene implementaciones accidentales, no la corrección que está intentando enviar. Haga clic en Unlock deploys para levantarlo.
Requerir aprobación para producción
Active Require approval for production bajo Deploy protection. Las implementaciones de producción activadas por push se pausan en Awaiting approval hasta que alguien abra la implementación y haga clic en Approve o Reject. Las implementaciones de panel y los deploy hooks no se ven afectados.
Requerir éxito de staging primero
Require staging success before production retiene una implementación de producción activada por push hasta que el entorno de staging haya implementado el mismo commit correctamente. Alguien aún puede aprobar manualmente para omitir la espera.
Comprobaciones CI requeridas
Puertas de implementaciones en su propio CI bajo CI required checks. En GitHub, ingrese nombres de trabajo de Actions separados por comas y todos deben pasar. En GitLab, cualquier valor no vacío espera todo el pipeline. Una falla en CI cancela automáticamente la implementación de Orbit.
Programación de congelación de implementación
Deploy freeze schedule bloquea implementaciones activadas por push fuera de ventanas aprobadas: un bloque de fin de semana, un rango de hora permitido, o ambos. Todos los tiempos están en UTC. Las implementaciones manuales y los deploy hooks no se ven afectados.
Cada puerta anterior excepto la congelación de implementación bloquea solo implementaciones activadas por push. Los deploy hooks y las implementaciones manuales del panel pasan directamente. Si una URL de hook se filtra, ninguna de estas configuraciones detendrá que ponga en cola una compilación. Trate las URL de hook como credenciales.
Omitir compilaciones que no necesita
- Ignored paths: patrones glob separados por comas. Si cada archivo en un push coincide, la compilación se omite.
*.md,docs/**detiene que los commits de documentación activen implementaciones. - Branch ignore patterns: los pushes de ramas coincidentes se omiten completamente.
dependabot/*,renovate/*es el caso común. - Git tag deploys: implementar en producción cuando se hace push de una etiqueta coincidente, usando un glob como
v*.
Caché de compilación
Orbit almacena en caché node_modules entre compilaciones en los planes Liftoff y Apex. Cuando se utiliza una instalación almacenada en caché, la implementación muestra una insignia Cache hit y la fase de instalación es dramáticamente más corta. Una compilación en frío muestra Cold build en su lugar.
Para forzar una reinstalación completa, abra Settings, luego Clear build cache y confirme. La siguiente implementación para cada entorno ejecuta una instalación completa desde cero.
Si una compilación falla de una manera que no puede explicar y el código está bien localmente, reinténtelo con la caché borrada antes de comenzar a cambiar nada. Un árbol de dependencias en caché obsoleto es una causa común y muy confusa.
Cuando una implementación sale mal
Orbit puede detectar una mala implementación para usted en lugar de dejarla en vivo:
- Auto-rollback on failure restaura automáticamente la última implementación saludable si una implementación de producción falla.
- Health check obtiene una ruta que elige después de cada implementación de producción. Una respuesta que no sea 2xx dentro de 15 segundos restaura la implementación saludable anterior.
- Smoke tests ejecutan solicitudes GET contra hasta 10 rutas después de cada implementación exitosa y registran éxito o fracaso. Combinado con auto-rollback, una prueba de humo que falla revierte la implementación.
Para deshacer una implementación usted mismo, consulte Revertir una implementación. Para saber por qué falló una compilación, consulte Solucionar problemas de compilaciones fallidas.