一、产品交付与部署架构
1. 交付物说明
CMP 5.0 通常发布以下三类制品：
| 制品 | 内容 | 适用场景 |
|---|---|---|
| 整包 | 中间件、核心服务、前端和本次发行预置插件 | 新装、完整版本交付，执行一个安装包即可完成部署 |
| 插件包 | 单个业务服务或功能模块的 .tgz 包 |
按需新增、更新或替换某个服务 |
| 中间件包 | MariaDB、Redis、RabbitMQ、Nacos、Caddy、Grafana、VictoriaMetrics 等基础设施 | 只部署或升级中间件，业务服务由插件包另行交付 |
整包中的服务插件存放在安装负载的 plugIn/ 目录。安装时会先保存到 ${CMP_INSTALL_ROOT}plugIn-package/prebuilt/，再根据插件 manifest 声明的依赖顺序自动部署。
中间件包不包含预置业务插件。使用中间件包升级时，不会清空已经安装的业务插件，也不会删除现有的预置插件缓存。
2. 服务分层
CMP 5.0 将部署内容分为两层：
- 基础设施层（infra）：由主
docker-compose.yml管理； - 业务服务层：核心服务、前端和功能服务均作为独立插件管理。
当前整包预置服务如下：
| 服务 | 类型 | 默认监听端口 | 说明 |
|---|---|---|---|
| app-base | 核心服务 | 8101 | 基础业务服务 |
| app-portal | 核心服务 | 8199 | 门户服务及公共回调接口 |
| app-gateway | 核心服务 | 8200 | 后端统一网关 |
| app-frontend | 核心服务 | 8210 | 前端服务 |
| app-maintenance | 功能服务 | 8110 | 运维维护服务 |
| app-operation | 功能服务 | 8111 | 运营服务 |
| app-resource | 功能服务 | 8120 | 资源服务 |
| cps-hub | 功能服务 | 以服务配置为准 | 云平台接入聚合服务 |
外部访问统一进入 Caddy 的 8100 端口，请求路由关系如下：
- 用户浏览器访问
:8100→ Caddy 统一入口； - 页面及前端路由 → app-frontend :8210；
/api、/socket、/ws→ app-gateway :8200 → app-base :8101 / app-portal :8199 / 其他服务插件；/grafana→ Grafana :3000；- 后端服务（app-base、app-portal、其他服务插件）→ MariaDB / Redis / RabbitMQ / Nacos。
业务服务采用 host 网络模式，Compose 文件中的 ports 不能作为实际监听端口的判断依据。
3. 默认软件版本
安装包内置并统一安装以下运行环境：
| 软件 | 版本 |
|---|---|
| Docker Engine | 24.0.9 |
| Docker Compose | 2.29.7 |
| runc | 1.1.12 |
CMP 主机设计为专用部署节点。安装过程会替换现有 Docker 运行时，卸载过程也会删除 Docker 二进制和 /var/lib/docker。不得在同一主机混合部署非 CMP 容器。