安装

这些步骤在一台 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。