Installation

Diese Schritte installieren die eingecheckte selbst gehostete VM-Konsole auf einem KVM-Host. Sie installieren weder den gehosteten Image-Builder noch eine produktive Enterprise-Bereitstellung.

1. Quelle verifizieren

Intended OpenFactory-Revision auschecken und lokale Änderungen prüfen, bevor Container gebaut werden:

git status --short
git rev-parse HEAD

Reviewed Release oder Commit nutzen. Der Compose-Workflow baut Images aus lokalen cto-gui- und cto-gui-libvirt-backend-Source-Trees.

2. Host-Verzeichnisse anlegen

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

Die Pfade werden read-only im Backend für Source-Artefakte gemountet. Gast-Disks und hochgeladene ISOs nutzen /var/lib/libvirt/images.

3. KVM und Libvirt Preflight

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

Stoppen, wenn ein Befehl fehlschlägt. Host-Service, Gruppenmitgliedschaft oder Socket-Ort fixen, bevor Container starten.

4. Konsole starten

Aus dem cto-gui-Verzeichnis:

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

http://localhost/ vom Host öffnen. Für Remote-Evaluierung Port 80 am Host-Firewall einschränken und vertrauenswürdigen privaten Pfad zum Host nutzen.

5. Laufenden Mode verifizieren

Frontend lädt, dann Backend-Mode-Response vom in Ihrem Deployment verfügbaren Netzwerkpfad prüfen. Muss self_hosted: true melden. Die Feature-Map sollte gehostete Builds, Konversationen, Scheduling und Policy-Dokumente als unavailable zeigen.

Danach disposable Test-ISO hochladen, kleine VM anlegen, VNC-Konsole öffnen, VM stoppen und löschen. Bestätigen, dass Gast-Disk und libvirt-Domain wie erwartet entfernt werden, bevor größere Images genutzt werden.

Rollback

Evaluierung stoppen ohne Named Volume zu löschen:

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

Das lässt hochgeladene Images, libvirt-Ressourcen, Source-Verzeichnisse und das cto-data-Volume intakt. Diese Ressourcen inventarisieren vor jeder Löschung. Nutzen Sie down --volumes nicht, sofern Sie retained console state und cleanup journals nicht absichtlich zerstören wollen.