Configuración de Proyecto Orbit

Cada opción de un proyecto Orbit se encuentra en la pestaña Configuración, agrupada para que puedas encontrar lo que necesitas: información general, compilación e implementación, seguridad, notificaciones, integraciones, límites de uso, automatización de implementación, redes, observabilidad, uso compartido y una zona de peligro en la parte inferior.

Dónde se encuentra la Configuración

Abre Orbit, haz clic en el proyecto y elige Configuración en la barra de pestañas del proyecto. La página se describe a sí misma como configuración del nombre del proyecto, comandos de compilación e integración Git, lo que queda corto considerando lo que ofrece.

Esta guía es un mapa. Cuando un tema tiene su propio artículo, está enlazado en lugar de repetido.

General

Información del proyecto muestra el slug de la URL, la fecha de creación, el repositorio conectado y la URL de producción, y te permite cambiar el Nombre y la Descripción del proyecto.

Git contiene la rama de producción. Los cambios en esa rama desencadenan implementaciones de producción.

Distintivo de estado te proporciona un SVG de estado de implementación en vivo con botones de copia para la URL, markdown e HTML, listos para pegar en tu README. Consulta Visualización de tu README de Proyecto en Orbit.

Página de estado público enlaza a la configuración de la página de estado. Consulta Página de Estado de Orbit.

Compilación e Implementación

Configuración de compilación son los cinco campos que Orbit detecta automáticamente y que puedes sobrescribir: comando de instalación, comando de compilación, directorio de salida, directorio raíz y versión de Node.js. Deja un campo en blanco para mantener el valor detectado. Los detalles completos están en Configuración del Comando de Compilación y Directorio de Salida.

Entorno de ejecución incluye cuatro opciones que merece la pena entender:

• Modo servidor mantiene la máquina de compilación activa ejecutando tu comando de inicio después de cada implementación. Requerido para cualquier cosa que se renderice en el servidor en lugar de exportar archivos estáticos.
• Vistas previas de rama crean un entorno automáticamente para cada cambio de rama que no sea producción o staging, cada uno en su propia URL bajo branch-*.kaps.run. Consulta Vistas Previas de Rama.
• Reversión automática en caso de fallo restaura la última implementación de producción saludable si una implementación falla.
• Recompilación programada recompila producción en un intervalo, desde cada hora hasta semanalmente, lo cual es útil para sitios con contenido administrado que necesitan una actualización sin un cambio de git.

Reintento automático de compilación reintenta compilaciones que fallaron por errores de infraestructura como problemas de red o tiempo de espera agotado, hasta tres veces. No reintenta errores de código, por lo que no puede enmascarar una compilación rota.

Rutas ignoradas y Patrones de ignorancia de rama evitan compilaciones que no necesitas: patrones glob para archivos cuyos cambios no deberían implementarse, y para ramas como dependabot/* que nunca deberían desencadenar una.

Implementaciones de etiqueta Git establece el patrón de etiqueta que convierte un cambio de etiqueta en una implementación de producción. Consulta Versiones de Orbit.

Automatización y Protección de Implementación

Protección de implementación tiene dos compuertas: Requerir aprobación para producción, que pausa las implementaciones de producción desencadenadas por cambios hasta que alguien apruebe, y Requerir éxito de staging antes de producción, que retiene producción hasta que staging haya implementado el mismo commit exitosamente.

Comprobaciones requeridas de CI restringe implementaciones a tu propio CI. En GitHub listas nombres de trabajos, todos los cuales deben pasar; en GitLab cualquier valor no vacío espera el pipeline completo. Una falla de CI cancela la implementación.

Cronograma de congelación de implementación bloquea implementaciones desencadenadas por cambios fuera de ventanas aprobadas, ya sea los fines de semana o un rango de horas UTC. Las implementaciones manuales y los enlaces de implementación no se ven afectados.

Protección de rama añade reglas de patrones glob que bloquean implementaciones en ramas coincidentes hasta que las comprobaciones externas requeridas pasen y, opcionalmente, una persona apruebe.

Promoción automática de staging promociona staging a producción automáticamente una vez que ha estado funcionando durante un número configurado de horas sin fallos de salud y con pruebas de humo pasando.

Todos estos se resumen en una vista en la pestaña Pipeline de Implementación de Orbit.

Puertas de Salud y Calidad

Comprobación de salud obtiene una ruta que eliges 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.

Pruebas de humo ejecutan solicitudes GET contra hasta diez rutas separadas por comas después de cada implementación exitosa y registran aprobación o fallo. Combinado con reversión automática, una prueba de humo fallida revierte la implementación.

Presupuestos de rendimiento advierten o fallan compilaciones que exceden un umbral: tamaño total del artefacto en MB, tamaño de archivo individual en kB coincidido por un glob, o tiempo de compilación en segundos. Cada presupuesto se establece para advertir o fallar la compilación.

Staging

Staging tiene su propio conjunto de tarjetas: la rama de staging, protección de acceso con una contraseña, una lista blanca de IP que acepta direcciones IPv4 y rangos CIDR uno por línea, reversión automática en caso de fallo, si staging hereda variables de entorno de producción con prioridad más baja, y sobrescrituras de compilación para instalación, compilación, salida y directorio raíz.

La contraseña y la lista blanca de IP son los dos elementos a configurar en cualquier entorno de staging que no esté destinado a ser público. Deja ambos en blanco y la URL de staging será accesible para cualquiera que la tenga.

Redes

Dominios personalizados añade y verifica dominios para el entorno de producción, incluido el aprovisionamiento de certificados. Consulta Añadir un Dominio Personalizado a Orbit.

Redirecciones y reescrituras son reglas basadas en rutas aplicadas antes de servir, probadas en orden con el primer coincidente ganando. Una redirección envía el navegador a una nueva URL como 301 o 302; una reescritura sirve una ruta diferente silenciosamente sin cambio de URL. Los patrones admiten coincidencias exactas, comodines, parámetros nombrados y splats. Consulta Redirecciones y Reescrituras en Orbit.

Encabezados de respuesta aplican encabezados HTTP personalizados a rutas coincidentes, con ajustes preestablecidos para HSTS, CSP, no-embed, no-sniff, política de referrer y CORS. Se aplican todas las reglas coincidentes, y las entradas posteriores sobrescriben las anteriores para la misma clave.

Protección de sesgo mantiene los artefactos de compilación antiguos en almacenamiento durante una ventana de retención después de que una nueva implementación entre en vivo, para que un visitante que cargó la versión anterior aún pueda obtener sus activos en lugar de obtener un 404.

El almacén de configuración contiene configuraciones clave/valor que tu implementación lee en tiempo de ejecución, para banderas de características y configuraciones que cambian sin una nueva implementación. Se gestiona en Almacenamiento, no aquí, y es gratuito: no hay cargo de lectura ni de escritura. Los valores se almacenan en texto sin formato, por lo que nunca pongas un secreto en uno. Hasta 100 entradas por proyecto, claves hasta 200 caracteres y valores hasta 4096. Se toma una instantánea nocturna de cada entrada y se mantienen treinta noches en todos los planes, por lo que una entrada que elimines puede recuperarse: consulta Instantáneas y restauración.

Uso y Límites

Uso de compilación muestra las compilaciones que ha ejecutado este proyecto.

Límite de gasto establece el gasto máximo mensual de exceso, cubriendo sobrecargas de minutos de compilación y ancho de banda más allá de tu asignación de plan. El mínimo es US$6.32 y el máximo US$6,315.79. Las alertas se disparan al 50% y 80%, y al 100% el servicio se pausa hasta que aumentes el límite. Consulta Límite de Gasto de Orbit.

Límite de gasto de compilación es el límite separado y más simple: un techo mensual en minutos de compilación totales, después del cual nuevas compilaciones dejan de ponerse en cola hasta el próximo mes o aumentas el límite.

Retención de artefactos establece cuántos artefactos de compilación exitosos mantener por entorno. Los más antiguos se eliminan diariamente, y la implementación actualmente activa siempre se mantiene independientemente del límite.

Caducidad de vista previa pausa entornos de vista previa después de 7, 14, 30 o 60 días, o nunca. Las vistas previas en pausa tienen su almacenamiento reclamado dentro de 24 horas.

Alerta de tamaño de artefacto te envía un correo electrónico cuando un artefacto de compilación excede un tamaño que estableces.

Notificaciones, Integraciones y Observabilidad

Notificaciones de correo electrónico de implementación tiene tres configuraciones: todas las implementaciones, solo fallos, o desactivado. Una URL de webhook de notificación puede establecerse junto a él, publicando en cada éxito o fallo.

Canales de notificación es la versión más rica, con selección por evento, historial de entrega y un botón de prueba. El control completo de webhook está en su propia pestaña: consulta Webhooks de Orbit.

Enlaces de implementación crea URLs secretas que desencadenan una implementación cuando algo POST a ellas. Consulta Desencadenar Implementaciones a través de Enlaces de Implementación.

Drenajes de registro envían registros de compilación a tu plataforma de observabilidad después de cada implementación, con soporte integrado para Datadog, Logtail, Axiom y New Relic, o un webhook personalizado, opcionalmente filtrado a un entorno.

Analítica Web te proporciona el fragmento de recopilación de Core Web Vitals. Consulta Web Vitals de Orbit.

Activadores Cron programa solicitudes HTTP a un entorno elegido, hasta diez por proyecto. La versión más grande, solo de producción, está en su propia pestaña: consulta Trabajos Cron de Orbit.

Uso Compartido y Equipo

Equipo gestiona colaboradores con tres roles: administrador, desarrollador y visualizador.

Enlaces compartidos generan enlaces temporales sin contraseña para que un revisor externo pueda ver un entorno sin una contraseña o una cuenta. Cada enlace puede expirar en 1 hora, 24 horas o 7 días, o nunca, y muestra su número de visitas. Revoca uno en cualquier momento.

Grupo de implementación une este proyecto a un grupo para que los proyectos relacionados se implementen juntos, opcionalmente filtrado por rama.

Clonar entorno y Clonar proyecto duplican la configuración. Clonar un proyecto copia configuración de compilación, configuración de entorno y variables de entorno no secretas; los secretos no se copian.

Zona de Peligro

Limpiar caché de compilación elimina las dependencias en caché para cada entorno, por lo que la próxima implementación ejecuta una instalación completa desde cero. No se puede deshacer, aunque el caché se reconstruya a sí mismo en la siguiente compilación.

Transferir proyecto mueve el proyecto a otra cuenta de Kapsule. Consulta Transferencia de un Proyecto Orbit.

Archivar proyecto detiene el servicio de tráfico inmediatamente. Es restaurable dentro de 30 días desde la lista de Orbit, después de lo cual se elimina permanentemente.

Dónde Ir Después

• Pipeline de Implementación de Orbit para ver el efecto de cada configuración en una vista.
• Grupos Compartidos de Variables de Entorno para valores utilizados en múltiples proyectos.
• Límites de Plan de Orbit para lo que tu plan permite.