Saltar a contenido

Despliegue

Procedimiento para desplegar Cortex HIVE en staging y producción.

Entornos

Entorno Orquestador Uso
Local docker compose en deploy/ Desarrollo integrado
Staging / prod Coolify Despliegue gestionado

Guía operativa completa: deploy/COOLIFY.md.

Arranque local

git submodule update --init --recursive
cd deploy
docker compose up --build
  • Panel: http://localhost:5173
  • API: http://localhost:8000/api/v1/health

Activación de plugins

En producción la activación es vía /control/plugins (superadmin). El estado persiste en PostgreSQL (platform_plugin_state).

No se usa CORTEX_ENABLED_PLUGINS como fuente de verdad en despliegues gestionados — ver ADR 023.

Build de imágenes

Imagen Dockerfile Contenido
API deploy/Dockerfile.api Python, wheels cortex + plugins habilitados
Web deploy/Dockerfile.web Build Vite @cortex/web-shadcn + nginx

Wheels: deploy/build-wheels.sh.

Documentación del sitio

El sitio público (docs.cortex-ia.com.co) se despliega desde el repo cortex-docs vía Cloudflare Pages — ver Publicar documentación.

Referencias