# PR #6889 完整报告

- 仓库：`verl-project/verl`
- 标题：[ci] chore: add qwen3_5 megatron images
- 合并时间：2026-06-29 19:28
- 原文链接：http://prhub.com.cn/verl-project/verl/pull/6889

---

# 执行摘要

- 一句话：为 Ascend 镜像添加 Megatron 组件
- 推荐动作：建议合并，但需确认 bot 指出的续行符问题已在第二个 commit 中完全解决。同时建议后续跟踪镜像构建日志。

# 功能与动机

PR body 中指出需要添加 Qwen3.5 的 Megatron 镜像，以支持在 Ascend 硬件上运行 Qwen3.5 模型。

# 实现拆解

1. **修改 Dockerfile.ascend_8.5.2_a2_qwen3-5**：在 transformers 克隆之后添加 MindSpeed、Megatron-LM 仓库的克隆和安装命令；在安装 vllm 之前添加 MindSpeed、Megatron-LM 和 Megatron-Bridge 的 pip 安装步骤。
2. **修改 Dockerfile.ascend_8.5.2_a3_qwen3-5**：与 A2 版本类似，添加相同的克隆和安装命令。
3. **注意**：两个 Dockerfile 的修改模式相同，分别对应不同硬件架构（A2/A3）。

关键文件：
- `docker/ascend/Dockerfile.ascend_8.5.2_a2_qwen3-5`（模块 部署脚本；类别 infra；类型 infrastructure）: A2 架构的 Dockerfile，新增 MindSpeed、Megatron-LM、Megatron-Bridge 安装步骤。
- `docker/ascend/Dockerfile.ascend_8.5.2_a3_qwen3-5`（模块 部署脚本；类别 infra；类型 infrastructure）: A3 架构的 Dockerfile，与 A2 版本对应修改。

关键符号：未识别

## 关键源码片段

### `docker/ascend/Dockerfile.ascend_8.5.2_a2_qwen3-5`

A2 架构的 Dockerfile，新增 MindSpeed、Megatron-LM、Megatron-Bridge 安装步骤。

```dockerfile
# 安装 MindSpeed、Megatron-LM 和 Megatron-Bridge
# 注意：每行末尾必须添加 && \ 以构成一条完整的 RUN 指令
RUN git clone https://gitcode.com/Ascend/MindSpeed.git && \
    cd MindSpeed && git checkout core_r0.16.0 && cd .. && \
    git clone --depth 1 --branch core_r0.16.0 https://github.com/NVIDIA/Megatron-LM.git && \
    pip install -e MindSpeed && \
    pip install -e Megatron-LM && \
    pip install git+https://github.com/NVIDIA-NeMo/Megatron-Bridge.git@de93536e --no-deps --no-build-isolation

```

# 评论区精华

gemini-code-assist[bot] 在 review 中指出两个 Dockerfile 中新增的 git clone 命令前一行的末尾缺少行续行符 `&& \`，可能导致 Docker 构建语法错误。这是潜在的构建故障点。

- Dockerfile 缺少行续行符 (correctness): PR 作者在第二个 commit 中已修复，补丁中已包含正确的续行符。

# 风险与影响

- 风险：
 - **构建失败风险**：如 bot 所述，缺少续行符可能导致 Docker 构建失败，影响 CI 和开发者使用。但 PR 作者已通过第二个 commit 修复了该问题（但源码片段显示补丁中已包含正确续行符，可能 bot 评论针对中间版本）。
 - **镜像体积增大**：新增的 MindSpeed、Megatron-LM、Megatron-Bridge 会显著增加镜像体积，可能影响分发效率。
 - **依赖锁定**：所有组件均固定到指定 commit/tag，需定期更新以获取 bug 修复。

- 影响：
 - **影响用户**：使用 Ascend 镜像进行 Megatron 训练的用户可以直接使用新镜像，无需手动安装依赖。
 - **影响团队**：维护者需关注镜像构建是否正常，并在基础镜像更新时同步升级这些依赖。
 - **影响系统**：不涉及运行时代码变更，仅影响镜像构建流程。

- 风险标记：构建语法风险 , 镜像体积增大

# 关联脉络

- PR #6820 [env] chore: add verl release 0.8.0 docker for ascend: 同为 Ascend 镜像新增的 PR，涉及类似的 Dockerfile 修改模式。