Installation

Ces étapes installent la console VM auto-hébergée versionnée sur un hôte KVM. Elles n’installent pas le builder d’images hébergé ni n’établissent un déploiement Enterprise de production.

1. Vérifier la source

Checkout la révision OpenFactory voulue et relisez les changements locaux avant de construire les conteneurs :

git status --short
git rev-parse HEAD

Utilisez une version ou un commit revu. Le workflow Compose construit les images depuis les arbres source locaux cto-gui et cto-gui-libvirt-backend.

2. Créer les répertoires hôte

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

Les chemins sont montés en lecture seule dans le backend pour les artefacts source. Disques invités et ISO téléversées utilisent /var/lib/libvirt/images.

3. Prévol KVM et Libvirt

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

Arrêtez si une commande échoue. Corrigez le service hôte, l’appartenance au groupe ou l’emplacement du socket avant de démarrer les conteneurs.

4. Démarrer la console

Exécutez depuis le répertoire cto-gui :

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

Ouvrez http://localhost/ depuis l’hôte. Pour une évaluation distante, restreignez le port 80 au pare-feu hôte et utilisez un chemin privé de confiance vers l’hôte.

5. Vérifier le mode en cours

Confirmez que le frontend charge, puis inspectez la réponse mode backend depuis le chemin réseau disponible dans votre déploiement. Elle doit indiquer self_hosted: true. La carte de fonctionnalités doit montrer builds hébergés, conversations, planification et documents de politique comme indisponibles.

Ensuite, téléversez une ISO de test jetable, créez une petite VM, ouvrez sa console VNC, arrêtez la VM et supprimez-la. Confirmez que le disque invité et le domaine libvirt sont retirés comme prévu avant d’utiliser de plus grandes images.

Rollback

Arrêtez l’évaluation sans supprimer son volume nommé :

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

Cela laisse images téléversées, ressources libvirt, répertoires source et volume cto-data intacts. Inventoriez ces ressources avant toute suppression. N’utilisez pas down --volumes sauf si vous entendez explicitement détruire l’état console conservé et les journaux de nettoyage.