orbital
Orbital es una plataforma autoalojada para desplegar, ejecutar y gestionar aplicaciones Streamlit en Kubernetes. Permite clonar repositorios Git, construir imágenes contenedoras imutables y desplegarlas con autogestión de secretos, logs, redeploys automáticos y habilitación de OIDC.
Ficha actualizada 23 sept 2026, 8:31 · upstream 23 sept 2026, 8:25 · release v0.1.0
Qué es orbital
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Orbital es una plataforma autoalojada para desplegar, ejecutar y gestionar aplicaciones Streamlit en Kubernetes. Punto a punto con un repositorio Git, la plataforma clona el proyecto, resuelve dependencias (uv.lock, requirements.txt o pyproject.toml), construye una imagen contenedora inmutable y despliega detrás de Ingress. El dashboard muestra el estado del build y los logs en tiempo real.
Además soporta sitios estáticos no compilados, con un paso opcional de construcción. Incluye gestión automática de secretos mediante TOML editado directamente desde la interfaz, que se monta en .streamlit/secrets.toml para mantener la funcionalidad de st.secrets sin reiniciar el app.
Se implementan roles de acceso granulares: admin/creador/viewer por grupos y permisos por aplicación. Se habilita hibernación automática de apps inactivas, con escalado a cero y wake-up automático al recibir una solicitud. También se ofrecen indicadores de CPU y memoria por aplicación, así como la capacidad de revertir un build anterior.
La arquitectura incluye BuildKit rootless para construir imágenes en un namespace separado, lo que garantiza que los builds no corran con privilegios elevados. Además, cada app es un Deployment aislado con rootfs solo leída, sin tokens de servicio-usuario.
- Desplegar aplicaciones Streamlit personalizadas en producción sin necesidad de despliegues manuales
- Gestionar múltiples apps con diferentes dependencias y configuraciones mediante un único dashboard
- Automatizar el ciclo de vida del desarrollo: push a git → build automático → deploy detrás de Ingress
- Seguridad mediante secretos gestionados en TOML, sin necesidad de configurar Kubernetes Secrets
- Auditoría y monitoreo con logs en tiempo real y métricas por aplicación
- Escalado automático de apps inactivas para reducir costos en entornos de producción
- Soporta tanto aplicaciones Streamlit como sitios estáticos no compilados, con un solo flujo de despliegue
- Gestión de secretos mediante TOML editado directamente desde la interfaz sin necesidad de configurar Kubernetes Secrets
- BuildKit rootless para construir imágenes en un namespace separado, garantizando que los builds no corran con privilegios elevados
- Hibernación automática de apps inactivas con escalado a cero y wake-up automático al recibir una solicitud
- Roles granulares por grupo (admin/creador/viewer) y permisos por aplicación para un control de acceso preciso
- No soporta bases de datos persistentes ni servicios externos, ya que cada app es un Deployment aislado con rootfs solo leída
- La gestión de secretos requiere editar manualmente el archivo .streamlit/secrets.toml en cada aplicación
- El despliegue de sitios estáticos no compilados no incluye un paso automático de construcción (se debe configurar manualmente)
- No se soporta la integración con CI/CD pipelines externos como GitHub Actions o GitLab CI
- La gestión de dependencias se realiza mediante uv.lock, lo que limita el uso de pip en entornos multi-tenant
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Para desplegar Orbital en un cluster Kubernetes existente, utiliza el Helm chart oficial. Instale la versión más reciente desde https://github.com/gggard/orbital/releases. En la configuración del Helm Chart, defina el namespace de la aplicación y los secretos como variables de entorno o archivos TOML. Para habilitar hibernación, asegúrese de que la app tenga un timeout de inactividad configurado en su archivo de configuración Streamlit. Los logs se pueden visualizar desde el dashboard mediante la API REST /api/v1/apps/<app-name>/logs. Se recomienda mantener el repositorio Git actualizado para evitar desincronización entre el build y el despliegue.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.