63 lines
2.3 KiB
Markdown
63 lines
2.3 KiB
Markdown
# 需求分析：Gitea Releases 发布三种 Docker 部署版本
|
||
|
||
开始时间：2026-05-21-14-19-12
|
||
|
||
## 原始需求摘要
|
||
|
||
用户要求在 `https://gitea.huijutec.cn/admin/REVOXELSEG_DICOM/releases` 发布三个版本：
|
||
|
||
- 机器直接部署版本。
|
||
- NAS 直接部署版本。
|
||
- 通用版本，删除其中具体的 FRPC 反向代理地址、token、端口和域名信息，使其适配其他需求和环境。
|
||
|
||
## 业务目标
|
||
|
||
让使用者可以直接从 Gitea Release 页面下载对应部署版本，分别用于当前本机、威联通 NAS 和通用 Docker 环境部署，减少手动挑选 Compose 文件和替换敏感配置的操作。
|
||
|
||
## 输入与输出
|
||
|
||
输入：
|
||
|
||
- 独立 Docker 程序包目录：`~/Desktop/ReVoxelSeg_DICOM_Docker`。
|
||
- 已推送 Gitea 分支：`docker-standalone-20260521`。
|
||
- 当前机器版和 NAS 版 Compose 配置。
|
||
|
||
输出：
|
||
|
||
- Gitea Release：机器直接部署版本。
|
||
- Gitea Release：NAS 直接部署版本。
|
||
- Gitea Release：通用版本。
|
||
- 对应 Git tag 与 release 分支。
|
||
- 工程分析记录和经验记录。
|
||
|
||
## 影响范围
|
||
|
||
- 独立 Docker 程序包仓库会新增发布分支和 tag。
|
||
- Gitea Releases 页面新增三个 Release。
|
||
- 主项目仅提交本次工程分析文档。
|
||
|
||
## 关键约束
|
||
|
||
- 三个 Release 下载后的根目录都应有 `docker_compose.yaml`。
|
||
- 机器版保留当前本机和 FRPC 具体配置。
|
||
- NAS 版使用 NAS/QTS 绝对路径和当前 FRPC 具体配置。
|
||
- 通用版不能包含具体 FRPC 服务地址、token、远端端口和域名，应使用 `.env.example` 和环境变量占位。
|
||
- 不重复提交软著材料、工程分析目录到独立 Docker 版本中。
|
||
|
||
## 风险点
|
||
|
||
- Gitea Release 依赖 tag；若 tag 重名需先检查并避免覆盖已有发布。
|
||
- Gitea 自动源码包包含完整默认 DICOM/STL 数据，下载体积较大。
|
||
- 通用版移除具体 FRPC 配置后，用户必须自行填写 `.env` 或修改 Compose 才能启用公网映射。
|
||
|
||
## 默认假设
|
||
|
||
- 使用三个 tag：
|
||
- `revoxelseg-docker-machine-v2026.05.21`
|
||
- `revoxelseg-docker-nas-v2026.05.21`
|
||
- `revoxelseg-docker-generic-v2026.05.21`
|
||
- 为避免 Release 之间源码结构混淆，分别创建轻量发布分支：
|
||
- `release/docker-machine-20260521`
|
||
- `release/docker-nas-20260521`
|
||
- `release/docker-generic-20260521`
|