Coomia DIP 私有部署试用指南

Coomia DIP 通过官网完成试用申请、审批和 License 签发，通过独立客户部署仓库交付固定摘要镜像、部署清单与操作文档。客户不需要获得产品源码，也不应从旧源码仓库自行构建镜像。

#试用流程

用户在 Coomia 官网↗ 注册并提交试用申请。
Coomia 管理员在官网后台审核申请，选择试用期限并签发 License。
用户在“我的许可证”查看 License，在“部署中心”查看获准使用的固定镜像摘要和部署文档。
当客户部署包状态变为 GO 后，用户按本文和客户部署仓库文档完成安装。
用户在线激活，或使用机器指纹下载绑定环境的离线 license.jwt。
用户完成管理员初始化、健康检查和核心业务冒烟测试后开始试用。

#当前交付状态

当前运行制品候选为 trial.22。四个一方镜像已完成安全门禁、SBOM、GHCR Public 发布和匿名 RepoDigest 读取验证。共享试用镜像的固定摘要由客户部署仓库统一维护，普通用户无需在官网逐项选择或复制；只有客户专有镜像才会显示在部署中心。

客户部署仓库当前仍为 PREPARED。部署中心会向已批准用户显示客户部署仓库、安装文档和发布状态；在完整 K8s 自助安装器、全产品回归和人工批准完成前，不提供自助安装包下载。

客户部署仓库：coomia-ai/coomia-platform-deploy↗
公共镜像包：coomia-ai packages↗
当前发布状态：RELEASE_STATUS↗

Kubernetes 核心链路与应用级恢复已经通过隔离验收，但客户仓库当前仍是适用于已有集群的参考实施。Docker Compose 不在当前 K8s 候选范围内。

#Docker Compose 环境要求（当前未开放）

Docker Compose 部署目标为全新的 Linux amd64 主机：

8 个 vCPU 或以上
16 GiB 内存或以上
50 GiB 可用磁盘或以上
Docker Engine 与 Docker Compose v2
能访问 ghcr.io 和 https://coomia.com

不要在已有生产数据的主机上按全新安装流程操作。升级、迁移、备份与恢复应使用客户部署仓库中的专门文档。

#`GO` 后的安装步骤

只有以下两个状态都为 GO 时才开始自助安装：

Plain Text

RELEASE_STATUS=GO
COMPOSE_STATUS=GO

获取客户部署仓库并确认状态：

Bash

git clone https://github.com/coomia-ai/coomia-platform-deploy.git
cd coomia-platform-deploy
grep -E '^(RELEASE_STATUS|COMPOSE_STATUS)=' RELEASE_STATUS
bash scripts/verify-package.sh --layout-only
bash scripts/preflight-linux.sh compose

初始化客户私有配置：

Bash

bash scripts/init-config.sh
vi compose/.env

将发布目录中的 12 个固定 RepoDigest 和当前环境的域名、密码等配置写入 compose/.env。不要使用 latest 等浮动标签，不要提交或分享该文件。

确认配置和变更窗口后执行：

Bash

bash install.sh compose

安装、启动、停止或重启都会改变客户环境，执行前应按客户变更流程获得批准。完整步骤以客户部署仓库的安装指南↗为准。

#License 激活

#在线激活

在产品授权页面输入官网签发的 License 密钥。产品会连接 https://coomia.com 完成环境绑定和授权同步。

#离线激活

从产品启动日志复制 cluster fingerprint。
在官网“我的许可证”中输入完整指纹。
下载与该环境绑定的 license.jwt。
按客户部署仓库的 License 操作文档↗导入并验证。

机器指纹不能为空，也不能使用截图中的占位文字。离线 License 只对签发时绑定的环境有效。

#验收清单

完成安装后至少验证：

UI 和 API 健康，用户可以登录；
首个管理员初始化完成；
License 状态、授权模块和到期时间正确；
数据源连接、数据同步和 Pipeline 可以运行；
本体建模和对象浏览可用；
Flink 作业可以运行并产生 checkpoint；
规则、事件、Action、分析和 AI Agent 的目标试用场景通过。

试用 License 到期后，产品业务门禁会进入受限状态；运行中的 Flink 作业应先生成最终 savepoint，再自动暂停，已有数据不得被删除。该到期流程已在厂商隔离环境完成验证，但不能替代全产品功能回归。

#获取支持

部署失败时先运行客户仓库提供的脱敏诊断脚本，不要公开 compose/.env、License 文件、密码、Token 或完整业务日志。联系 Coomia 时请提供版本、RELEASE_STATUS、失败时间、受影响步骤和脱敏后的诊断结果。

Coomia DIP 私有部署试用指南

#试用流程

#当前交付状态

#Docker Compose 环境要求（当前未开放）

#GO 后的安装步骤

#License 激活

#在线激活

#离线激活

#验收清单

#获取支持

#`GO` 后的安装步骤