安裝

這些步驟在一台 KVM 主機上安裝簽入的自承載 VM 控制台。他們不安裝託管映像產生器或建立生產企業部署。

1. 驗證來源

在建置容器之前檢查預期的 OpenFactory 修訂版並檢查本機變更：

git status --short
git rev-parse HEAD

使用經過審查的版本或提交。 Compose 工作流程從本地 cto-gui 和 cto-gui-libvirt-backend 來源樹建立映像。

2.建立主機目錄

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

這些路徑在來源工件的後端內以唯讀方式安裝。來賓磁碟和上傳的 ISO 使用 /var/lib/libvirt/images。

3. 預檢 KVM 和 Libvirt

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

如果任何命令失敗則停止。在啟動容器之前修復主機服務、群組成員身分或套接字位置。

4.啟動控制台

從 cto-gui 目錄執行此命令：

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

從主機開啟 http://localhost/。對於遠端評估，請限制主機防火牆上的連接埠 80 並使用主機的受信任專用路徑。

5. 驗證運作模式

確認前端加載，然後檢查部署中可用網路路徑的後端模式回應。它必須報告 self_hosted: true。功能圖應將託管建置、對話、排程和策略文件顯示為不可用。

接下來，上傳一次性測試 ISO，建立一個小型 VM，打開其 VNC 控制台，停止 VM，然後將其刪除。在使用較大的映像之前，請確認來賓磁碟和 libvirt 網域已如預期般刪除。

回滾

停止評估而不刪除其命名卷：

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

這使得上傳的圖像、libvirt 資源、來源目錄和 cto-data 磁碟區完好無損。在刪除之前清點這些資源。除非您明確打算銷毀保留的控制台狀態和清理日誌，否則請勿使用 down --volumes。