Instalação

Estes passos instalam o console de VM self-hosted versionado em um host KVM. Não instalam o builder de imagem hospedado nem estabelecem deployment Enterprise de produção.

1. Verifique a origem

Faça checkout da revisão OpenFactory pretendida e revise alterações locais antes de construir containers:

git status --short
git rev-parse HEAD

Use release ou commit revisado. O workflow Compose constrói imagens a partir das árvores locais cto-gui e cto-gui-libvirt-backend.

2. Crie diretórios no host

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

Os paths são montados read-only dentro do backend para artefatos de origem. Discos guest e ISOs enviados usam /var/lib/libvirt/images.

3. Preflight KVM e Libvirt

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

Pare se qualquer comando falhar. Corrija serviço do host, membership de grupo ou localização do socket antes de iniciar containers.

4. Inicie o console

Execute a partir do diretório cto-gui:

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

Abra http://localhost/ a partir do host. Para avaliação remota, restrinja porta 80 no firewall do host e use caminho privado confiável ao host.

5. Verifique o mode em execução

Confirme que o frontend carrega, depois inspecione resposta de mode do backend pelo caminho de rede disponível no deployment. Deve reportar self_hosted: true. O mapa de features deve mostrar builds hospedados, conversas, agendamento e documentos de política como indisponíveis.

Em seguida, envie ISO de teste descartável, crie VM pequena, abra console VNC, pare a VM e delete. Confirme que disco guest e domínio libvirt são removidos como esperado antes de usar imagens maiores.

Rollback

Pare a avaliação sem deletar o volume nomeado:

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

Isso mantém imagens enviadas, recursos libvirt, diretórios de origem e volume cto-data intactos. Inventarie esses recursos antes de qualquer deleção. Não use down --volumes salvo se pretender destruir explicitamente estado retido do console e journals de cleanup.