Inštalácia

Tieto kroky nainštalujú verziu self-hosted VM konzoly z repozitára na jednom hostiteľovi s KVM. Nenainštalujú hostovaný zostavovač obrazov ani nevytvoria produkčné nasadenie Enterprise.

1. Overenie zdroja

Checkout zamýšľanej revízie OpenFactory a pred zostavením kontajnerov skontrolujte lokálne zmeny:

git status --short
git rev-parse HEAD

Použite schválené vydanie alebo commit. Workflow Compose zostaví obrazy z lokálnych stromov zdrojov cto-gui a cto-gui-libvirt-backend.

2. Vytvorenie adresárov na hostiteľovi

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

Cesty sú v backende pripojené len na čítanie pre zdrojové artefakty. Disky hostí a nahrané ISO používajú /var/lib/libvirt/images.

3. Predbežná kontrola KVM a Libvirt

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

Pri zlyhaní akéhokoľvek príkazu zastavte. Opravte službu hostiteľa, členstvo v skupine alebo umiestnenie socketu pred spustením kontajnerov.

4. Spustenie konzoly

Spustite z adresára cto-gui:

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

Z hostiteľa otvorte http://localhost/. Pri vzdialenom hodnotení obmedzte port 80 na firewalle hostiteľa a použite dôveryhodnú privátnu cestu k hostiteľovi.

5. Overenie bežiaceho režimu

Potvrďte, že sa frontend načíta, potom skontrolujte odpoveď režimu backendu po sieťovej ceste dostupnej vo vašom nasadení. Musí hlásiť self_hosted: true. Mapa funkcií by mala ukazovať hostované zostavenie, konverzácie, plánovanie a dokumenty policy ako nedostupné.

Ďalej nahrajte jednorazové testovacie ISO, vytvorte malú VM, otvorte jej VNC konzolu, zastavte VM a zmažte ju. Pred použitím väčších obrazov potvrďte, že disk hosta a doména libvirt boli odstránené podľa očakávania.

Rollback

Zastavte hodnotenie bez zmazania pomenovaného volume:

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

Tým zostanú zachované nahrané obrazy, prostriedky libvirt, zdrojové adresáre a volume cto-data. Pred akýmkoľvek zmazaním si tieto prostriedky vymenujte. Nepoužívajte down --volumes, ak výslovne nechcete zničiť uchovaný stav konzoly a cleanup journály.