73 lines
3.3 KiB
Markdown
73 lines
3.3 KiB
Markdown
# 测试方案：Gitea Releases 发布三种 Docker 部署版本
|
||
|
||
测试方案文档路径：`工程分析/测试方案-2026-05-21-14-19-12.md`
|
||
|
||
## 静态检查
|
||
|
||
- 检查三个版本 tag 是否存在。
|
||
- 检查三个 Release 是否存在。
|
||
- 检查通用版不包含具体 FRPC 地址、token、远端端口和域名。
|
||
- 检查三种版本根目录均有 `docker_compose.yaml`。
|
||
|
||
## 构建检查
|
||
|
||
- 对机器版执行 `docker compose -f docker_compose.yaml config`。
|
||
- 对 NAS 版执行 `docker compose -f docker_compose.yaml config`。
|
||
- 对通用版执行 `docker compose --env-file .env.example -f docker_compose.yaml config`。
|
||
|
||
## 关键业务场景验证
|
||
|
||
- 当前独立 Docker 服务仍可通过 `/api/health` 正常响应。
|
||
- `https://revoxel.huijutec.cn/` 当前入口仍可访问。
|
||
- Release 下载用户可依据 README 使用对应 Compose 启动。
|
||
|
||
## 医学影像数据相关边界验证
|
||
|
||
- 发布分支仍包含默认 `Head_CT_DICOM/` 和 `Head_CT_ReConstruct/`。
|
||
- 发布分支不包含 `data/`、`exports/`、`WebSite/node_modules/`、`WebSite/dist/` 等运行态和构建产物。
|
||
|
||
## 部署验证
|
||
|
||
- 不重新启动服务；保持当前独立 Docker 服务运行。
|
||
- 使用 `curl http://127.0.0.1:4000/api/health` 验证服务状态。
|
||
- 使用 `curl https://revoxel.huijutec.cn/` 验证公网入口。
|
||
|
||
## Git/Gitea 备份验证
|
||
|
||
- 推送三个发布分支和三个 tag。
|
||
- 使用 Gitea API 创建三个 Release。
|
||
- 使用 Gitea API 查询 Release 列表确认发布成功。
|
||
- 主项目工程分析记录 commit message 包含 `2026-05-21-14-19-12`。
|
||
|
||
## 风险与回归关注点
|
||
|
||
- 通用版删除具体 FRPC 信息后不能直接公网访问，需使用者自行填写 `.env`。
|
||
- Gitea Release 的源码包较大，下载时间与网络有关。
|
||
- 不应把 Gitea 管理员密码写入任何文件或 Release 正文。
|
||
|
||
## 实际执行结果
|
||
|
||
- 已创建并推送发布分支：
|
||
- `release/docker-machine-20260521`
|
||
- `release/docker-nas-20260521`
|
||
- `release/docker-generic-20260521`
|
||
- 已创建并推送 tag：
|
||
- `revoxelseg-docker-machine-v2026.05.21`，目标提交 `57415a1`
|
||
- `revoxelseg-docker-nas-v2026.05.21`，目标提交 `ce78e3e`
|
||
- `revoxelseg-docker-generic-v2026.05.21`，目标提交 `3ad83a6`
|
||
- 机器版 `docker_compose.yaml` 配置校验通过。
|
||
- NAS 版 `docker_compose.yaml` 配置校验通过。
|
||
- 通用版 `docker_compose.yaml` 配置校验通过。
|
||
- 通用版启用 `--profile frpc` 后配置校验通过。
|
||
- 通用版全目录检查未发现固定 FRPC 服务地址、固定 token、远端端口 `10008`、固定公网域名或本机固定内网地址。
|
||
- 已通过 Gitea API 创建 Release：
|
||
- `ReVoxelSeg DICOM Docker 机器直接部署版 v2026.05.21`
|
||
- `ReVoxelSeg DICOM Docker NAS 直接部署版 v2026.05.21`
|
||
- `ReVoxelSeg DICOM Docker 通用版 v2026.05.21`
|
||
- Gitea API 查询确认三个 Release 均存在：
|
||
- `https://gitea.huijutec.cn/admin/REVOXELSEG_DICOM/releases/tag/revoxelseg-docker-machine-v2026.05.21`
|
||
- `https://gitea.huijutec.cn/admin/REVOXELSEG_DICOM/releases/tag/revoxelseg-docker-nas-v2026.05.21`
|
||
- `https://gitea.huijutec.cn/admin/REVOXELSEG_DICOM/releases/tag/revoxelseg-docker-generic-v2026.05.21`
|
||
- 当前独立 Docker 服务健康检查通过：`/api/health` 返回 `ok: true`。
|
||
- 当前公网入口 `https://revoxel.huijutec.cn/` 返回 `200 OK`。
|