Instalación

Estos pasos instalan el console VM autohospedado incluido en un host KVM. No instalan el builder de imágenes hosted ni establecen un despliegue Enterprise de producción.

1. Verifica el origen

Haz checkout de la revisión OpenFactory prevista y revisa cambios locales antes de compilar contenedores:

git status --short
git rev-parse HEAD

Usa una versión o commit revisado. El flujo Compose compila imágenes desde los árboles fuente locales cto-gui y cto-gui-libvirt-backend.

2. Crea directorios en el host

sudo install -d -m 0755 /opt/openfactory/iso
sudo install -d -m 0755 /var/lib/libvirt/images/.openfactory-golden

Las rutas se montan de solo lectura dentro del backend para artefactos fuente. Los discos guest e ISO subidos usan /var/lib/libvirt/images.

3. Preflight KVM y Libvirt

test -e /dev/kvm
test -S /var/run/libvirt/libvirt-sock
virsh -c qemu:///system list --all
docker compose version

Para si algún comando falla. Corrige el servicio del host, membresía de grupo o ubicación del socket antes de arrancar contenedores.

4. Arranca el console

Ejecuta esto desde el directorio cto-gui:

docker compose -f docker-compose.self-hosted.yml up --build -d
docker compose -f docker-compose.self-hosted.yml ps

Abre http://localhost/ desde el host. Para evaluación remota, restringe el puerto 80 en el firewall del host y usa una ruta privada de confianza al host.

5. Verifica el modo en ejecución

Confirma que el frontend carga, luego inspecciona la respuesta de modo del backend desde la ruta de red disponible en tu despliegue. Debe reportar self_hosted: true. El mapa de features debe mostrar compilaciones hosted, conversaciones, programación y documentos de política como no disponibles.

Después, sube un ISO de prueba desechable, crea una VM pequeña, abre su console VNC, detén la VM y elimínala. Confirma que el disco guest y el dominio libvirt se eliminan como se espera antes de usar imágenes más grandes.

Rollback

Detén la evaluación sin borrar su volumen con nombre:

docker compose -f docker-compose.self-hosted.yml down

Esto deja intactas imágenes subidas, recursos libvirt, directorios fuente y el volumen cto-data. Inventaria esos recursos antes de cualquier eliminación. No uses down --volumes salvo que quieras explícitamente destruir estado del console retenido y journals de limpieza.