39 lines
2.1 KiB
Markdown
39 lines
2.1 KiB
Markdown
# 知识中心发布包
|
|
|
|
发布编号：knowledge-20260916-100045
|
|
|
|
状态：2026-09-16 已部署并验收通过。详见 ../knowledge-deployed.md。
|
|
|
|
目标：192.168.110.111，服务目录 /opt/im-admin/deploy/im-admin。
|
|
|
|
## 内容
|
|
|
|
- payload.tar.gz：知识中心后端代码、测试、前端构建产物和 compose.yaml。
|
|
- manifest.json：每个文件的 SHA-256 与大小。
|
|
- Dockerfile.overlay：以备份的生产镜像为基础，仅覆盖本次代码与静态资源。
|
|
|
|
发布包不包含数据库、密钥、环境变量文件或聊天数据。
|
|
|
|
## 上线顺序
|
|
|
|
1. 确认当前镜像、生产源文件、磁盘空间及服务健康状态，对比生产改动。
|
|
2. 保存原源码、compose 配置和镜像标签；一致性备份数据库及密钥，验证备份。
|
|
3. 在 /home/ps 下的独立发布目录解包并核对 manifest.json，避免遍历生产备份目录。
|
|
4. 使用 Dockerfile.overlay 构建独立候选镜像。BASE_IMAGE 必须指定刚备份的生产镜像标签。
|
|
5. 在候选镜像中使用临时数据库运行 test_knowledge、test_model_gateway。
|
|
6. 安装审核过的源文件和 compose.yaml，保留生产 .env、data 目录；将候选镜像标为 current。
|
|
7. 执行 docker compose up -d --no-build api gateway knowledge-worker。
|
|
8. 检查 API、网关、worker、前端资源、鉴权、归档条数与数据库完整性；记录实际结果。
|
|
|
|
上线不自动提取四十万条聊天，不自动开启租户检索。管理员应先选定账号、小批量提取、审核发布，再开启检索。
|
|
|
|
## 回滚原则
|
|
|
|
停止 knowledge-worker，恢复备份的 compose、源码与静态资源，将备份镜像重新标为 current，再启动 api、gateway。新增知识表保留，不恢复旧数据库，以免丢失上线后新增的聊天。
|
|
|
|
## 部署结果
|
|
|
|
API 与网关健康，knowledge-worker 正常运行，三个容器重启计数为 0。生产镜像内 56 项测试通过，归档消息 414003 条，数据库完整性检查 ok。知识默认关闭，无加工任务。
|
|
|
|
大库首次索引构建使用磁盘临时目录已完成；操作经过及备份位置见 ../knowledge-deployed.md。
|