# PR #7477 完整报告

- 仓库：`verl-project/verl`
- 标题：[doc] fix: add supported tag doc for ascend docker
- 合并时间：2026-08-20 09:26
- 原文链接：http://prhub.com.cn/verl-project/verl/pull/7477

---

# 执行摘要

- 一句话：新增 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'，说明其定位为持续维护的活文档。

# 实现拆解

1. 新增文档文件 docker/ascend/supported_tags.md（+61 行，纯新增），作为 Ascend 镜像标签的权威清单。
2. 文档分为四张表：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 条）。
3. 每张表统一列结构：Device（910b / A3）、CANN Base Image（8.2.RC1 ~ 9.0.0）、Inference Backend（vLLM / SGLang）、Image Tag、Dockerfile 链接，便于按硬件、CANN 版本与后端快速筛选。
4. 无测试、配置或部署配套改动；本次为纯文档新增，文档准确性依赖后续 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 文档表格中的后端列表一致。