部署准备
使用发行归档与镜像安装 CMP 控制端,并通过 SSH 接入计算节点。
新环境先安装控制端,再通过控制台接入计算节点。部署依赖容器镜像,计算节点的 libvirt、QEMU/KVM、OVS 和业务网桥仍由宿主机提供。存量环境先阅读版本升级。
部署组成
| 部署位置 | 组件与职责 |
|---|---|
| 控制端 | Web、API、主机接入、计算与存储控制器。监控组件从数据库队列读取样本,写入 VictoriaMetrics。 |
| 计算节点 | Agent 维护注册身份及控制通道,计算和存储执行器各自处理任务,采集代理提供观测。 |
| 独立存储节点(可选) | 接收对应 RBD 池的任务,需准备 Ceph 配置与池访问权限。 |
| 数据服务 | PostgreSQL 保存业务及主机状态,VictoriaMetrics 保存历史指标。使用 OVN 时还需网络协调器及 NB/SB 服务。 |
准备配置和镜像
从交付入口取得 install.sh、发行归档的下载目录、归档 SHA-256、镜像仓库地址和镜像标签。安装脚本按标签下载同一批次的部署文件,再由引导脚本从仓库拉取镜像。控制端与计算节点使用同一批次镜像。先核对系统与网络要求,并准备浏览器访问域名、证书与私钥。
控制主机需要运行中的 Linux systemd,并能访问软件源和镜像仓库。引导脚本检查 /var/lib 的可用空间与 Web 端口。使用自带 HTTPS 时需同时提供证书和私钥,并确保 443 可用。
启动控制端
以下示例使用内置 PostgreSQL、VictoriaMetrics 和 HTTPS。先将示例中的 CMP_* 变量设置为交付方提供的版本标签、归档地址、摘要、完整仓库路径与拉取账号,替换域名和证书位置。仓库密码单独保存在仅属主可读的文件中。
sudo sh ./install.sh \
--version "$CMP_RELEASE" \
--release-base-url "$CMP_RELEASE_URL" \
--sha256 "$CMP_ARCHIVE_SHA256" \
-- --registry "$CMP_IMAGE_REGISTRY" \
--registry-user "$CMP_REGISTRY_USER" \
--registry-password-file /root/cmp-registry-password \
--pki-host cmp.example.com --public-origin https://cmp.example.com \
--tls-cert /root/cmp.crt --tls-key /root/cmp.key --yes-- 前是归档下载和校验选项,之后是引导参数。已有本地部署归档时,可将 --release-base-url 换成 --archive,并继续提供摘要。使用预先下载的镜像时,在引导参数中指定配套的 --image-archive。只检查安装条件时可传入 --dry-run,脚本解包并预检后退出。
脚本准备 Docker 与 Compose、持久目录和密钥,启动控制端并执行数据库迁移。首次安装使用 --yes 时,脚本在终端输出随机生成的 administrator 初始密码。确认页面 /readyz 可用后登录并修改密码。使用外部反向代理时,在入口终止 TLS,并让 HOWSTACK_PUBLIC_ORIGIN 与实际访问地址一致。
维护已有控制端
引导脚本默认将配置写入 /srv/howstack,环境文件为 compose.env,对外监听覆盖文件为 compose.public.yaml。进行重启、升级或排障时,沿用设备上实际使用的项目名(如果设置了 -p)、Compose 文件、环境文件与 profile。下面以已启用 SSH 纳管的自包含部署为例。
control_args=(-f /srv/howstack/compose.yaml -f /srv/howstack/compose.public.yaml
--env-file /srv/howstack/compose.env
--profile control --profile pilot --profile host-deploy)
sudo /srv/howstack/compose-control-up.sh --check "${control_args[@]}"
sudo /srv/howstack/compose-control-up.sh "${control_args[@]}"
sudo docker compose "${control_args[@]}" ps -a--check 要求所需镜像已在本地。默认启动使用已有组件镜像,并补拉缺失的基础服务镜像。使用完整源码构建时,可在脚本名后传入 --build。默认等待 120 秒,使用 HOWSTACK_COMPOSE_WAIT_TIMEOUT 调整。
接入外部 PostgreSQL 和 VictoriaMetrics 时,配置 HOWSTACK_MIGRATION_DATABASE_URL、HOWSTACK_DATABASE_URL 和 HOWSTACK_METRICS_URL,使用 control,按需加功能 profile。业务库与主机库分开时,还需分别设置主机库的迁移与运行连接。
| 功能 | 配置 |
|---|---|
| SSH 纳管 | 在 compose.env 设置允许连接的 HOWSTACK_HOST_DEPLOY_ALLOWED_CIDRS,用 --profile host-deploy 启动。核对主机可达的数据库连接和防火墙。 |
| 平台备份 | 加入 --profile backup。 |
| OVN | 内置 Central 追加交付的 compose.ovn.yaml,启用 network 和 ovn 并准备 TLS。接入外部 Central 时启用 network 并设置 NB/SB 地址。两种方式都需启用 HOWSTACK_OVN_ENABLED 和 HOWSTACK_NETWORK_CONTROLLER_EXTERNAL。 |
| 裸金属 | 追加交付的 compose.baremetal.yaml。启用 PXE 时加 --profile baremetal-pxe。 |
使用私有仓库时,启用 SSH 纳管前确认 /srv/howstack/config/registry-password 由部署服务的 10001:10001 持有,权限为 0600。计算节点部署时会使用该凭据拉取镜像。
启动脚本等待 migrate-iam 与 migrate-host 成功后,恢复 SSH 部署、裸金属和 DHCP 后台。迁移失败时,用同一组参数执行 docker compose "${control_args[@]}" logs migrate-iam migrate-host 查看错误。noVNC 还需设置 HOWSTACK_HOST_CONSOLE_UPSTREAM、HOWSTACK_HOST_CONSOLE_CA_FILE 和 API 与主机控制服务共用的 HOWSTACK_HOST_CONSOLE_TOKEN。
准备计算节点
- 按计算主机环境要求准备受支持的系统、KVM、管理网络与数据盘挂载。计算节点须能访问镜像仓库及控制端公布的 HTTPS 注册地址和 mTLS 通信地址。
- 在控制台进入“基础设施 → 主机管理 → 添加主机”。预检通过后,平台通过 SSH 上传节点引导脚本、清单和控制端 CA,安装宿主依赖,拉取节点镜像,注册身份并启动 Agent、采集与执行容器。详见主机管理。
- 确认主机以预期身份上线,两类执行器已就绪。验证存储、实例、网络和监控后再启用调度。存量节点按逐台切换流程处理。
节点环境文件和 Compose 清单位于 /etc/howstack-cmp/。排查时可通过 docker logs howstack-agent 检查控制通道,并核对注册地址、CA、内核和宿主服务。节点 Agent 就绪表示已建立控制通道,开放调度前仍需验证计算与存储能力。
数据盘与网络准备
引导脚本保留已有磁盘与分区。使用独立数据设备承载本地目录存储,按存储 UUID 规划挂载。核对管理网、业务上联、VLAN、DNS 与 MTU。独立存储节点使用交付方提供的 compose.storage.yaml 与 storage profile,并准备 Ceph 配置和池访问权限。
