ljwx-health/backup_docs_20260104_182653/VERIFICATION_CHECKLIST.md

Dockerfile 优化验证清单

提交信息

• Commit: c671a96
• 提交时间: 2026-01-02
• 提交内容: 优化 Dockerfile 使用 Harbor 基础镜像

代码推送状态

• ✅ GitHub: 已推送
• ✅ Gitea: 已推送

验证步骤

1. 查看 Gitea Actions 构建状态 ⏳

访问链接: http://192.168.1.83:33000/gao/ljwx-health/actions

预期看到的 Jobs:

Job 1: test-build-boot

• 目的: 验证 ljwx-boot 可以成功构建
• 预期时间: ~3-5 分钟
• 关键步骤:
  • ✅ Configure Maven Aliyun mirror
  • ✅ Build ljwx-boot-starter
  • ✅ Build ljwx-boot package

Job 2: build-push (matrix: ljwx-boot, ljwx-admin, ljwx-bigscreen)

• 目的: 构建并推送 Docker 镜像到 Harbor
• 预期时间:
  • ljwx-boot: ~3 分钟
  • ljwx-admin: ~2 分钟
  • ljwx-bigscreen: ~1 分钟
• 关键步骤:
  • ✅ Checkout code
  • ✅ Log in to Harbor
  • ✅ Set up Docker Buildx
  • ✅ Prepare build context (使用 Dockerfile.gitea)
  • ✅ Build and push
  • ✅ Image digest

Job 3: update-deploy

• 目的: 更新部署仓库的镜像标签
• 预期时间: ~30 秒
• 关键步骤:
  • ✅ Clone ljwx-deploy repository
  • ✅ Update kustomization.yaml
  • ✅ Commit and push

2. 验证构建日志关键信息 🔍

在 Gitea Actions 的构建日志中，查找以下关键信息：

ljwx-boot 构建日志

✅ 应该看到: FROM harbor.omniverseai.net/ljwx-base-images/maven3.9-jdk21:latest
✅ 应该看到: Maven 依赖从阿里云镜像下载
✅ 不应该看到: apk add maven (因为 Maven 已预装)

ljwx-admin 构建日志

✅ 应该看到: FROM harbor.omniverseai.net/ljwx-base-images/node20-pnpm:latest
✅ 应该看到: pnpm install --frozen-lockfile
✅ 不应该看到: corepack enable (因为 pnpm 已预装)

ljwx-bigscreen 构建日志

✅ 应该看到: FROM harbor.omniverseai.net/ljwx-base-images/python3.12-pip:latest
✅ 应该看到: uv pip install --system
✅ 应该看到: 快速的依赖安装

3. 验证 Harbor 镜像推送 🐳

访问 Harbor: http://harbor.omniverseai.net:8080

检查项目: ljwx-health

预期看到的镜像:

• ✅ ljwx-health/ljwx-boot:main-c671a96
• ✅ ljwx-health/ljwx-boot:latest
• ✅ ljwx-health/ljwx-admin:main-c671a96
• ✅ ljwx-health/ljwx-admin:latest
• ✅ ljwx-health/ljwx-bigscreen:main-c671a96
• ✅ ljwx-health/ljwx-bigscreen:latest

4. 验证镜像大小对比 📊

在 Harbor 中查看镜像大小，对比优化效果：

镜像	预期大小范围	说明
ljwx-boot	~200-300 MB	JRE 运行时镜像
ljwx-admin	~30-50 MB	Nginx + 静态文件
ljwx-bigscreen	~150-250 MB	Python 3.12 运行时

5. 验证构建时间优化 ⏱️

在 Gitea Actions 中查看实际构建时间，对比优化目标：

组件	优化前目标	优化后目标	实际时间	达成
ljwx-boot	~8 分钟	~3 分钟	⏳ 待测	⬜
ljwx-admin	~5 分钟	~2 分钟	⏳ 待测	⬜
ljwx-bigscreen	~3 分钟	~1 分钟	⏳ 待测	⬜

6. 功能验证（可选） ✅

如果需要完整验证，可以部署并测试应用：

# 拉取最新镜像
docker pull harbor.omniverseai.net/ljwx-health/ljwx-boot:latest
docker pull harbor.omniverseai.net/ljwx-health/ljwx-admin:latest
docker pull harbor.omniverseai.net/ljwx-health/ljwx-bigscreen:latest

# 启动测试（使用 docker-compose）
docker-compose -f docker-compose.yml up -d

# 验证服务
curl http://localhost:9998/actuator/health  # ljwx-boot
curl http://localhost:3333                   # ljwx-admin
curl http://localhost:5225/health            # ljwx-bigscreen

验证问题排查

问题 1: 基础镜像拉取失败

症状: 构建日志显示 Error pulling image

排查步骤:

1. 检查 Gitea Runner 是否能访问 Harbor
2. 检查基础镜像是否存在于 Harbor
3. 检查 Harbor 登录凭据是否正确

解决方案:

# 在 Runner 节点上测试
docker pull harbor.omniverseai.net/ljwx-base-images/maven3.9-jdk21:latest
docker pull harbor.omniverseai.net/ljwx-base-images/node20-pnpm:latest
docker pull harbor.omniverseai.net/ljwx-base-images/python3.12-pip:latest

问题 2: Dockerfile 路径错误

症状: 构建日志显示 Dockerfile not found

排查步骤:

1. 检查 .gitea/workflows/ci.yml 中的 Dockerfile 路径
2. 确认所有 Dockerfile.gitea 文件都已提交

解决方案: 检查文件是否存在：

ls -l ljwx-boot/ljwx-boot-admin/Dockerfile.gitea
ls -l ljwx-admin/Dockerfile.gitea
ls -l ljwx-bigscreen/Dockerfile.gitea

问题 3: 构建上下文错误

症状: 构建时找不到文件或目录

排查步骤:

1. 检查构建上下文是否正确
2. 确认 COPY 命令路径是否正确

解决方案: 参考 .gitea/workflows/ci.yml 中的上下文配置：

• ljwx-boot: context = repo (项目根目录)
• ljwx-admin: context = repo/ljwx-admin
• ljwx-bigscreen: context = repo/ljwx-bigscreen

验证成功标准

• ✅ 所有 CI/CD jobs 都成功完成（绿色）
• ✅ 镜像成功推送到 Harbor
• ✅ 构建时间符合优化目标（减少 50%+）
• ✅ 镜像大小合理，无异常增大
• ✅ 应用功能正常（如果进行了功能测试）

后续行动

验证成功后：

1. 📝 记录实际构建时间数据
2. 📊 更新性能对比报告
3. 🎉 通知团队优化成功
4. 📚 整理最佳实践文档

验证失败时：

1. 🔍 查看详细构建日志
2. 🐛 根据错误信息排查问题
3. 🔧 修复问题后重新推送
4. 🔄 重新运行验证流程

---

开始验证时间: ___________ 验证完成时间: ___________ 验证结果: ⬜ 成功 ⬜ 失败 验证人: ___________