执行摘要
- 一句话:新增 Ascend Docker 受支持镜像标签文档
- 推荐动作:值得快速浏览(约 1 分钟):对 Ascend 部署用户有直接参考价值。值得关注的模式是把"最新 / 版本发布 / 模型专用 / 历史归档"分表组织,兼顾检索效率与历史留存;建议后续在 docs/ascend_tutorial 安装文档中引用该文件,并考虑用 CI 校验表格标签与实际 Dockerfile 的一致性。
功能与动机
PR body 只有一句 'add supported tag doc for ascend docker',未关联 Issue。动机可合理推断为:Ascend(910b/A3)镜像数量多,CANN 版本与推理后端组合复杂,用户难以判断哪个 tag 与自己的设备、后端和 verl 版本匹配;且近期 Ascend CI 镜像更新频繁(如 #7444、#7293),需要一份权威清单避免误用或过期标签。文档顶部标注 'Last updated: 08/19/2026',说明其定位为持续维护的活文档。
实现拆解
- 新增文档文件 docker/ascend/supported_tags.md(+61 行,纯新增),作为 Ascend 镜像标签的权威清单。
- 文档分为四张表:Latest Images(4 条最新标签)、verl Release Images(按 v0.8.0 / v0.7.1 / v0.7.0 / v0.6.1 版本归档 8 条)、Model-Specific Images(Qwen3.5 专用镜像 2 条)、History Images(历史标签归约 12 条)。
- 每张表统一列结构:Device(910b / A3)、CANN Base Image(8.2.RC1 ~ 9.0.0)、Inference Backend(vLLM / SGLang)、Image Tag、Dockerfile 链接,便于按硬件、CANN 版本与后端快速筛选。
- 无测试、配置或部署配套改动;本次为纯文档新增,文档准确性依赖后续 Dockerfile 变更时的人工同步维护。
关键文件:
docker/ascend/supported_tags.md(模块 镜像文档;类别 docs;类型 documentation): 本 PR 唯一变更文件,新增 Ascend 镜像标签清单,按设备、CANN 版本、推理后端、版本号组织,是本次变更的全部内容。
关键符号:未识别
评论区精华
本 PR 没有任何 review 评论(review_comments_count = 0),维护者 wucong25 以空 body 直接批准,因此没有设计权衡或正确性交锋可供提炼。唯一值得注意的是作者仅用一条 commit "new doc" 提交,信息量有限;PR 标题符合仓库模板,但 commit message 质量一般。
风险与影响
- 风险:回归风险几乎为零:不触碰任何运行时代码、配置或依赖。主要风险在文档自身:1)大量引用 main 与 release 分支下的 Dockerfile 链接,后续重命名或删除文件会导致表格链接失效,存在链接漂移风险。2)"Last updated: 08/19/2026" 的日期与仓库当前活跃周期似乎不符,建议核对实际日期;标签清单长期不更新会误导用户。3)当前没有 CI 或脚本校验表格中的标签与 docker/ascend 目录下实际 Dockerfile 的对应关系,缺少自动化保障。
- 影响:对用户是正向影响:Ascend(910b / A3)部署者可通过该文档快速定位正确的镜像 tag 和对应 Dockerfile,降低用错镜像导致部署失败的概率。对系统无运行时影响:不涉及任何训练、推理或配置逻辑。对团队是新增加文档维护负担:后续新增、移除或升级 Ascend 镜像时,需要在对应 PR 中同步更新本清单,否则文档会逐渐失真。
- 风险标记:纯文档变更, 链接易漂移, 无自动化校验, 日期标注待核对
关联脉络
- PR #7444 [ci] chore: Update ci image: 夜间 Ascend CI 镜像迁移与标签更新,与本文档维护的镜像标签属同一镜像管理脉络。
- PR #7293 [ci] chore: Update ci image: 更新 Ascend CI 镜像标签、依赖与 Dockerfile,是本文档试图集中记录的镜像变更来源之一。
- PR #7374 [ci, trainer] feat: remove mindspeedllm backend engine support.: 移除 Mindspeed-LLM 后端后,Ascend 镜像仅保留 vLLM 与 SGLang 两个推理后端,与本 PR 文档表格中的后端列表一致。
参与讨论