Ctrl K
ComunidadGuías…
GITHUB · ANALIZADO

onebox

onebox es una herramienta CLI para operaciones en un solo servidor Linux que garantiza despliegues sin tiempo de inactividad mediante un flujo explícito de planificar, aprobar y aplicar cambios.

Ficha actualizada 23 sept 2026, 20:16 · upstream 23 sept 2026, 20:07 · release v2026.9.13

00

Qué es onebox

Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.

onebox está diseñado para mantener la simplicidad económica de un único servidor Linux sin convertir la producción en una pila de scripts complejos. Utiliza un enfoque "plan-before-apply", donde cada despliegue requiere revisar y aprobar un plan detallado que incluye cambios de configuración, imágenes y estado del host antes de ejecutar cualquier acción. La herramienta conecta vía SSH con verificación de claves y no ejecuta nada contra producción sin aprobación explícita del usuario o agente.

Genera automáticamente el runtime Docker Compose, nombres estables, enrutamiento y operaciones de release a partir de una declaración simple en `ob.yml`. Soporta bases de datos como PostgreSQL y MongoDB, aunque con limitaciones específicas en la gestión de replicación o recuperación automática sin configuración explícita.

No es un gestor de clúster ni un PaaS; se centra en un único host por aplicación para evitar fallas complejas y mantener el control operativo directo sobre el sistema Linux subyacente. Ofrece capacidades de recuperación, rollback automático y gestión de secretos, manteniendo la propiedad del código generado para que pueda ser inspeccionado o transferido permanentemente mediante `ob eject`.

CASOS DE USO
  • Despliegue seguro en VPS único sin agente
  • Migración controlada de aplicaciones con validación previa
  • Gestión de entornos de staging aislados
  • Automatización de despliegues con auditoría de cambios NDJSON
  • Recuperación ante fallos mediante rollback automático
PUNTOS DESTACADOS
  • Sin agente en el host objetivo (solo SSH)
  • Flujo explícito Plan-Aprobar-Desplegar
  • Generación automática de Docker Compose
  • Rollback automático por defecto ante fallos
  • Soporte para PostgreSQL y MongoDB básico
  • Documentación generada desde el código
PRECAUCIONES
  • No soporta alta disponibilidad ni clústeres (un solo host)
  • No gestiona replicación automática de MongoDB ni transacciones multi-documento
  • Los backups requieren configuración explícita
  • No tiene interfaz web ni dashboard
  • Requiere acceso SSH manual con verificación de claves
VISUAL

Capturas del proyecto

Imágenes reales detectadas en la documentación del repositorio.

Onebox
01

Perfil de infraestructura

Estimación inicial derivada del repositorio y de los servicios detectados.

CPU4 vCPUrecomendación inicial
MEMORIA4 GBRAM estimada
DISCO30 GBalmacenamiento base
COMPLEJIDADhighnivel de operación
02

Despliegue detectado

Qué señales reales de instalación hemos encontrado.

Despliegue manual

Instalar CLI vía Homebrew, Scoop o binarios. Inicializar proyecto con `ob init`. Ejecutar `ob validate`, `ob canonical`, `ob bootstrap` (primera vez), `ob plan`, `ob approve` y `ob deploy`. Verificar siempre el plan antes de aprobar. Usar `ob eject` para asumir control permanente del Compose generado si se desea.

—Dockerfile
—Compose
—One-click
03

Stack y dependencias

Componentes inferidos a partir de manifests, configuración y documentación.

FRAMEWORKS
Node.jsGo
SERVICIOS
PostgreSQLMongoDB
BASES DE DATOS
PostgreSQLMongoDB
PUERTOS
3000
05

Puede sustituir a

Relaciones detectadas por el análisis del repositorio y su categoría.

06

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.