部署与离线安装

Diting 支持单机、性能集群和 HA 集群三种形态。三种形态使用同一套安装包与升级路径，区别只在组件副本与资源规划。

三种形态

形态	适合	扩容方式
单机	评估、分支机构、边缘机房	纵向
性能集群	主机与容器规模较大的生产环境	gateway、collector、ClickHouse 分别扩
HA 集群	不能停的核心系统	多副本与故障转移

离线包在发布机生成，包含镜像 tar、依赖、License、校验清单。生成入口是 ci/pack-standalone-from-spec.sh：

cd diting-deploy
bash ci/pack-standalone-from-spec.sh \
  --spec <package-spec.json> --version <version> \
  --output <dist-dir> --workspace <ws-dir>

这个脚本只做校验与装配，不构建、不推送镜像。镜像 tar 必须提前放在 diting-deploy/images/，文件名按 <image_ref> 把 / 和 : 换成 _，再加 .tar。

包内会记录每个 tar 的 sha256 与 config_digest。导入内网后先校验清单，再执行安装。

平台通过 Helm chart 部署到 k3s 或标准 Kubernetes。安装前确认：

安装过程按组件输出状态。任何一步失败都会停在原地，不会带着半套服务继续。

License 是离线文件，使用非对称签名校验。安装时导入，到期前离线续期。平台不会连接厂商服务器。

升级包与安装包走同一条离线路径。升级前会备份关键配置，失败可以回到上一版本。

Agent 的采集模式可以单独回滚：在 /etc/diting/agent.yaml 的 collectors.traces.capture.mode 显式写入 tc_ebpf 或 socket_syscall，重启 agent 即可，不需要更换二进制。

安装完成后依次检查：

kubectl -n diting get pods
kubectl -n diting get svc

确认 core 的 /readyz 返回就绪，再打开控制台。依赖没有就绪时 core 会保持 NotReady，这是预期行为。