REVOXELSEG_DICOM/工程分析/实现方案-2026-05-21-11-13-49.md

实现方案：独立 Docker 程序目录与 Gitea 分支存储

实现方案文档路径：工程分析/实现方案-2026-05-21-11-13-49.md

修改目标

在 ~/Desktop/ReVoxelSeg_DICOM_Docker 生成可独立运行的 Docker 程序包，并将其作为 Gitea 新分支 docker-standalone-20260521 推送。

涉及路径

主项目：

• 工程分析/需求分析-2026-05-21-11-13-49.md
• 工程分析/实现方案-2026-05-21-11-13-49.md
• 工程分析/测试方案-2026-05-21-11-13-49.md
• 工程分析/经验记录.md

独立 Docker 程序目录：

• ~/Desktop/ReVoxelSeg_DICOM_Docker/WebSite/
• ~/Desktop/ReVoxelSeg_DICOM_Docker/Head_CT_DICOM/
• ~/Desktop/ReVoxelSeg_DICOM_Docker/Head_CT_ReConstruct/
• ~/Desktop/ReVoxelSeg_DICOM_Docker/Dockerfile
• ~/Desktop/ReVoxelSeg_DICOM_Docker/.dockerignore
• ~/Desktop/ReVoxelSeg_DICOM_Docker/.gitignore
• ~/Desktop/ReVoxelSeg_DICOM_Docker/docker_compose.yaml
• ~/Desktop/ReVoxelSeg_DICOM_Docker/docker_compose.nas.yaml
• ~/Desktop/ReVoxelSeg_DICOM_Docker/README.md

技术路线

1. 从主项目复制必要运行内容到独立目录：
   • 复制 WebSite/，排除 node_modules、dist、data、exports 和本地环境文件。
   • 复制默认演示数据 Head_CT_DICOM/、Head_CT_ReConstruct/。
2. 将 Dockerfile 调整为独立目录根构建：
   • COPY WebSite/package*.json ./WebSite/
   • COPY WebSite ./WebSite
   • COPY Head_CT_DICOM ./Head_CT_DICOM
   • COPY Head_CT_ReConstruct ./Head_CT_ReConstruct
3. 根目录放置两份 Compose：
   • docker_compose.yaml：本机部署，挂载 ./data 与 ./exports。
   • docker_compose.nas.yaml：NAS 部署，默认绝对路径 /share/Container/revoxelseg_dicom。
4. 在独立目录初始化 Git 仓库并推送到 Gitea 新分支。
5. 对独立目录执行 Compose 配置校验和构建验证。

执行步骤

1. 清理并重建 ~/Desktop/ReVoxelSeg_DICOM_Docker。
2. 使用 rsync 复制必要目录并排除运行态产物。
3. 写入根目录 Docker 部署文件。
4. 执行 docker compose -f docker_compose.yaml config 与 docker compose -f docker_compose.nas.yaml config。
5. 执行 docker compose -f docker_compose.yaml build 或 up -d --build 验证独立目录可用。
6. 验证本机端口与健康接口。
7. 初始化独立目录 Git 仓库，创建 docker-standalone-20260521 分支并推送。
8. 主项目提交工程分析记录。

兼容性与回滚方案

• 若独立 Docker 目录构建失败，不影响当前主项目目录和已运行的 Docker 服务。
• 若 Gitea 分支推送失败，可保留本地独立目录，并重新执行 git push origin docker-standalone-20260521。
• 若 NAS 路径不同，修改 docker_compose.nas.yaml 中的 build.context 和 volume 宿主机路径。

预计文件变更

主项目仅新增/更新工程分析文档；独立目录为新建自包含 Docker 程序包。

提交与部署策略

• 独立 Docker 程序包在新分支 docker-standalone-20260521 中存储。
• 主项目 main 分支仅提交工程分析记录，避免把独立运行包重复放进主项目。