66 lines
2.5 KiB
Markdown
66 lines
2.5 KiB
Markdown
# 实现方案：Gitea Releases 发布三种 Docker 部署版本
|
||
|
||
实现方案文档路径：`工程分析/实现方案-2026-05-21-14-19-12.md`
|
||
|
||
## 修改目标
|
||
|
||
在 Gitea Releases 页面发布三种可下载 Docker 部署版本，并保证三种版本的根目录部署入口一致。
|
||
|
||
## 涉及路径
|
||
|
||
主项目：
|
||
|
||
- `工程分析/需求分析-2026-05-21-14-19-12.md`
|
||
- `工程分析/实现方案-2026-05-21-14-19-12.md`
|
||
- `工程分析/测试方案-2026-05-21-14-19-12.md`
|
||
- `工程分析/经验记录.md`
|
||
|
||
独立 Docker 程序包：
|
||
|
||
- `~/Desktop/ReVoxelSeg_DICOM_Docker/docker_compose.yaml`
|
||
- `~/Desktop/ReVoxelSeg_DICOM_Docker/docker_compose.nas.yaml`
|
||
- `~/Desktop/ReVoxelSeg_DICOM_Docker/.env.example`
|
||
- `~/Desktop/ReVoxelSeg_DICOM_Docker/README.md`
|
||
|
||
## 技术路线
|
||
|
||
1. 在独立 Docker 程序包仓库中基于 `docker-standalone-20260521` 创建三个发布分支。
|
||
2. 机器版：
|
||
- 使用当前本机 `docker_compose.yaml`。
|
||
- 创建 tag `revoxelseg-docker-machine-v2026.05.21`。
|
||
3. NAS 版：
|
||
- 将 `docker_compose.nas.yaml` 内容复制为根目录 `docker_compose.yaml`。
|
||
- 更新 README 为 NAS 直接部署入口。
|
||
- 创建 tag `revoxelseg-docker-nas-v2026.05.21`。
|
||
4. 通用版：
|
||
- 改写 `docker_compose.yaml`，使用环境变量占位 FRPC 配置。
|
||
- 添加 `.env.example`。
|
||
- README 说明用户需自行填写 `.env`。
|
||
- 创建 tag `revoxelseg-docker-generic-v2026.05.21`。
|
||
5. 推送三个分支和三个 tag 到 Gitea。
|
||
6. 通过 Gitea API 创建三个 Release。
|
||
|
||
## 执行步骤
|
||
|
||
1. 检查独立 Docker 目录 Git 状态。
|
||
2. 创建发布分支和 tag。
|
||
3. 对三种版本分别运行 `docker compose -f docker_compose.yaml config`。
|
||
4. 推送分支和 tag。
|
||
5. 使用 Gitea API `POST /api/v1/repos/admin/REVOXELSEG_DICOM/releases` 创建 Release。
|
||
6. 使用 Gitea API 查询 Release 列表，确认三个版本存在。
|
||
7. 更新测试方案和经验记录。
|
||
|
||
## 兼容性与回滚方案
|
||
|
||
- 若 Release 创建失败，可以保留已推送 tag，重新调用 API 创建 Release。
|
||
- 若某个版本配置错误，可新建修订 tag，而不是强推覆盖旧 tag。
|
||
- 当前正在运行的独立 Docker 容器不依赖工作树后续分支切换，不会因创建发布分支中断服务。
|
||
|
||
## 预计文件变更
|
||
|
||
独立 Docker 仓库新增发布分支/tag；主项目新增工程分析文档和经验记录。
|
||
|
||
## 提交与部署策略
|
||
|
||
本次不改业务源码，不需要重新构建前端。发布验证以 Compose config、健康接口和 Gitea Release 查询为主。主项目 `main` 只提交工程分析文档。
|