fquiz/memory/2026-04-29.md

Work Log - GitHub Actions workflow 与 Docker 拓扑对齐（2026-04-29）

• 背景：

  • 用户反馈现有 GitHub workflow 与仓库实际 Docker 构建/部署配置不匹配，要求改造 workflow。

• 本次改动：

  • 文件：.github/workflows/main.yml
  • 构建阶段对齐：
    • API 镜像构建参数补齐 PYTHON_BASE_IMAGE、PIP_RETRIES，并将 PIP_DEFAULT_TIMEOUT 默认值改为 300。
    • Web 镜像构建参数补齐 NODE_BASE_IMAGE，并统一 NEXT_PUBLIC_API_BASE_URL 默认值为 http://localhost:8000。
  • 部署阶段对齐：
    • workflow 内生成的 docker-compose.prod.yml 从 db/api/web 扩展为与仓库主 compose 一致的核心拓扑：
      • db
      • redis
      • minio
      • minio-init
      • api
      • celery-worker
      • celery-beat
      • web
    • 补齐 api 运行所需的 DB_* / MINIO_* / CELERY_* / WINE_* 环境变量口径。
    • 将 ACCESS_TOKEN_EXPIRE_MINUTES 默认值从 15 校正为 480，与仓库基线一致。
    • .env 模板补齐 Redis/MinIO/Celery/Wine 相关配置默认值。

• 验证：

  • 通过 git diff -- .github/workflows/main.yml 逐项核对 workflow 变更。
  • 通过 nl -ba .github/workflows/main.yml 抽查关键片段（构建参数、compose 服务拓扑、.env 模板）确认已对齐。
  • 本次未执行远端部署或 GitHub Actions 实跑。

• 风险与影响：

  • 影响范围限定在 CI/CD workflow，不涉及应用业务代码。
  • 部署拓扑扩展后，目标服务器需具备额外镜像拉取与运行资源（Redis/MinIO/Celery）。