Instalacja

Te kroki instalują zapisany w repozytorium self-hosted konsolę VM na jednym hoście KVM. Nie instalują hostowanego buildera obrazów ani nie konfigurują produkcyjnego wdrożenia Enterprise.

1. Weryfikacja źródła

Pobierz zamierzoną rewizję OpenFactory i przejrzyj lokalne zmiany przed budową kontenerów:

git status --short
git rev-parse HEAD

Użyj sprawdzonego wydania lub commita. Workflow Compose buduje obrazy z lokalnych drzew źródłowych cto-gui i cto-gui-libvirt-backend.

2. Utworzenie katalogów na hoście

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

Ścieżki są montowane w backendzie tylko do odczytu dla artefaktów źródłowych. Dyski gościa i przesłane ISO używają /var/lib/libvirt/images.

3. Preflight KVM i Libvirt

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

Zatrzymaj się, jeśli któreś polecenie się nie powiedzie. Napraw usługę hosta, członkostwo w grupie lub lokalizację gniazda przed uruchomieniem kontenerów.

4. Uruchomienie konsoli

Uruchom to z katalogu cto-gui:

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

Otwórz http://localhost/ z hosta. Przy zdalnej ewaluacji ogranicz port 80 w zaporze hosta i użyj zaufanej prywatnej ścieżki do hosta.

5. Weryfikacja trybu działania

Potwierdź, że frontend się ładuje, a następnie sprawdź odpowiedź trybu backendu ze ścieżki sieciowej dostępnej w Twoim wdrożeniu. Musi zgłaszać self_hosted: true. Mapa funkcji powinna pokazywać hosted builds, conversations, scheduling i policy documents jako unavailable.

Następnie prześlij jednorazowy testowy ISO, utwórz małą VM, otwórz konsolę VNC, zatrzymaj VM i usuń ją. Potwierdź, że dysk gościa i domena libvirt zostały usunięte zgodnie z oczekiwaniem, zanim użyjesz większych obrazów.

Rollback

Zatrzymaj ewaluację bez usuwania named volume:

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

Przesłane obrazy, zasoby libvirt, katalogi źródłowe i wolumen cto-data pozostają nienaruszone. Spisz te zasoby przed każdym usunięciem. Nie używaj down --volumes, chyba że świadomie chcesz zniszczyć zachowany stan konsoli i dzienniki cleanup.