Orbit
¿Qué es Orbit?
Orbit is Kapsule's git-based deployment platform: connect a repository, push a commit, and your app builds and goes live on its own URL with a free SSL certificate, no server to configure and no…
Orbit es la plataforma de despliegue basada en git de Kapsule: conecta un repositorio, realiza un push de un commit y tu app se construye e inicia en su propia URL con un certificado SSL gratuito, sin servidor que configurar ni script de despliegue que escribir.
Todo lo que despliegas con Orbit se llama proyecto. Un proyecto tiene una URL de producción, un historial completo de despliegue con reversión de un clic, entornos opcionales de staging y vista previa de ramas, y su propia configuración de compilación, variables de entorno, dominios y funciones edge.
Se accede a través de Orbit en la barra lateral de KPanel, o directamente en /orbit.
Lo Que Orbit Hace Por Ti
- Push para desplegar. Realiza un push a tu rama de producción y Orbit clona, instala, construye, empaqueta el resultado y comienza a servirlo. La mayoría de los proyectos están en vivo en un par de minutos.
- Reversión instantánea. Se conserva el artefacto de cada compilación exitosa. La reversión promueve una versión ya construida, por lo que tarda segundos y nunca vuelve a ejecutar una compilación.
- Múltiples entornos. Producción, un entorno opcional de staging y un entorno de vista previa automático para cada rama que hagas push.
- Canalizaciones de compilación. npm, yarn y pnpm se detectan desde tu lockfile. El comando de instalación, comando de compilación, directorio de salida, directorio raíz y versión de Node.js son todos reemplazables.
- SSL gratuito, en todas partes. Tu URL
kaps.runy cada dominio personalizado que adjuntes obtienen un certificado aprovisionado automáticamente. - Bloqueos de despliegue y aprobaciones. Congela la producción durante un incidente, o requiere aprobación humana para cada despliegue activado por push.
- Un límite de gasto en cada proyecto. Un límite predeterminado de US$63.16 de gasto por exceso al mes, con alertas por correo al 50% y 80%, así que un bucle de compilación desbocado no puede producir una factura sorpresa.
Tu URL de Proyecto
Cuando creas un proyecto eliges un slug de Deploy URL, y Orbit le asigna al proyecto un subdominio en kaps.run. Un proyecto con el slug my-app se sirve en my-app.kaps.run.
Las vistas previas de ramas obtienen su propio nombre de host derivado del nombre de la rama, en la forma branch-<branch-name>.kaps.run. Los caracteres no alfanuméricos en el nombre de la rama se convierten en guiones y el nombre se trunca a 48 caracteres, así que una rama llamada feat/new-checkout previsualizará en branch-feat-new-checkout.kaps.run.
Puedes adjuntar tu propio dominio en cualquier momento desde la pestaña Domain del proyecto. Consulta Agregar un Dominio Personalizado a Tu Proyecto.
El slug de la URL de despliegue se elige una vez, cuando se crea el proyecto, y no se puede editar después. Elige algo que estés feliz de mantener, o adjunta un dominio personalizado después y úsalo como dirección pública.
Proveedores de Git
Orbit se conecta a GitHub, GitLab y Bitbucket. Cada proveedor se conecta una vez por cuenta y luego se puede usar para cualquier número de proyectos. Tutoriales:
- Conectar un Repositorio de GitHub
- Conectar un Repositorio de GitLab
- Conectar un Repositorio de Bitbucket
También puedes iniciar un proyecto a partir de una plantilla de inicio en lugar de tu propio repositorio. En la pantalla Nuevo proyecto, cambia de Import Git Repo a Start from Template y elige uno de los stacks predefinidos (Next.js, Astro, Remix, SvelteKit, Nuxt 3, o una API REST Express). Orbit copia la plantilla y la despliega inmediatamente.
Comenzar
- Haz clic en Orbit en la barra lateral de KPanel.
- Haz clic en New project.
- Conecta tu proveedor de Git y luego elige el repositorio que deseas desplegar.
- Rellena Project Name y Deploy URL.
- Haz clic en Create project. Tu primera compilación comienza inmediatamente y llegas a la descripción general del proyecto.
Orientarse en un Proyecto
Una vez que existe un proyecto, sus páginas se agrupan en cinco secciones en la parte superior del proyecto:
| Grupo | Páginas | Qué hay allí |
|---|---|---|
| Overview | Overview, Docs | Estado en vivo, compilación más reciente, despliegues recientes, salud del proyecto, tu README del repositorio |
| Deployments | Deployments, Releases, Branches, Pipeline | Historial completo de compilación, etiquetas de lanzamiento, estado por rama, vista de canalización de compilación |
| Observability | Analytics, Web Vitals, Build Insights, Activity, Timeline, Status page | Uso y exceso, Core Web Vitals de usuario real, tendencias de rendimiento de compilación, pista de auditoría, página de estado pública |
| Configure | Environments, Env vars, Domain, Crons, Edge functions, Hooks, Webhooks | Todo lo que configuras una vez y raramente tocas de nuevo |
| Settings | Settings | Configuración de compilación, cambios de tiempo de ejecución, seguridad, notificaciones, límites de uso, zona de peligro |
Páginas de Orbit a Nivel de Cuenta
Algunas páginas se encuentran por encima de proyectos individuales, accesibles desde los botones en el índice de Orbit en /orbit:
- Mission control (
/orbit/mission-control): una vista de consola en vivo de cada proyecto a la vez. - Queue (
/orbit/queue): cada compilación actualmente en ejecución o en espera, en todos tus proyectos. - Usage (
/orbit/usage): minutos de compilación y ancho de banda para la cuenta. - Env groups (
/orbit/env-groups): variables compartidas en varios proyectos a la vez. - Tokens (
/orbit/tokens): tokens de acceso de API para canalizaciones CI/CD. - Insights y Search: analítica de compilación entre proyectos, y búsqueda entre proyectos y despliegues.
Planes y Límites
Orbit tiene tres planes: Launch (gratuito para siempre, sin tarjeta requerida), Liftoff a US$12.00/mes, y Apex a US$30.00/mes. Difieren en cuántos proyectos puedes ejecutar, cuántos entornos puede tener cada proyecto, y tus minutos de compilación mensual y ancho de banda.
Asientos de equipo ilimitados y uso comercial se incluyen en todos los planes, incluyendo el gratuito. El tráfico de ataques de denegación de servicio nunca se cuenta contra tu ancho de banda.
Haz clic en See Plans en el índice de Orbit para comparar e intercambiar. El desglose completo está en Límites del Plan Orbit.
El plan Launch gratuito es genuinamente gratuito en lugar de una prueba. No tiene vencimiento, sin requisito de tarjeta, y se permite el uso comercial. Es un hogar permanente razonable para un sitio pequeño único.