Skip to content

tools image 可选,由 GitHub Action 构建并发布到 GHCR #19

Description

@Kherrisan

背景

当前镜像构建流程需要进一步标准化,希望把 tools image 作为一个可选构建产物纳入 CI,并由 GitHub Actions 自动构建、发布到 GHCR。

这样可以把运行时主镜像和工具镜像解耦,按需启用工具能力,同时减少手工构建和手工推送的维护成本。

目标

  • tools image 提供可选构建开关
  • 通过 GitHub Actions 自动构建 tools image
  • 将产物发布到 GHCR
  • 与主镜像发布流程保持清晰边界,避免互相耦合

需求范围

  • tools image 不应强制参与每次构建
  • 可以通过 workflow input、tag、env 或矩阵配置决定是否构建
  • 发布目标为 GHCR,命名规范需要明确
  • 支持版本化 tag,并考虑与主镜像 tag 的对应关系
  • 支持后续在部署或运行脚本中按需引用该 image

建议关注点

  • 镜像名称与 tag 规范
  • GitHub Actions 中的可选开关设计
  • 是否复用现有 build workflow,还是拆分为独立 workflow
  • GHCR 登录、权限与包可见性配置
  • 多架构支持是否需要一起纳入
  • 构建缓存与重复构建成本
  • 文档中补充 tools image 的用途、启用方式和发布方式

验收标准

  • GitHub Actions 能在指定条件下构建 tools image
  • 构建成功后自动推送到 GHCR
  • 不启用该选项时,现有主流程不受影响
  • 发布后的 image tag 可预测、可追踪
  • 文档说明清楚如何启用、如何拉取、如何使用

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions