昇腾 Dockerfile 构建指南
===================================

最后更新：2025年11月14日。

我们在 verl 上添加了对华为昇腾镜像构建的支持。


硬件支持
-----------------------------------

Atlas 200T A2 Box16

Atlas 800T A3

Atlas 900 A2 PODc


组件版本信息
----------------

================= ============
组件              版本
================= ============
基础镜像          Ubuntu 22.04
Python            3.11
CANN              8.3.RC1
torch             2.7.1
torch_npu         2.7.1
vLLM              0.11.0
vLLM-ascend       0.11.0rc1
Megatron-LM       v0.12.1
MindSpeed         (f2b0977e)
triton-ascend     3.2.0rc4
================= ============

Dockerfile 构建镜像脚本
---------------------------

============== ============== ==============
设备类型       基础镜像版本   参考文件
============== ============== ==============
A2             8.2.RC1        `Dockerfile.ascend_8.2.rc1_a2 <https://github.com/volcengine/verl/blob/main/docker/ascend/Dockerfile.ascend_8.2.rc1_a2>`_
A2             8.3.RC1        `Dockerfile.ascend_8.3.rc1_a2 <https://github.com/volcengine/verl/blob/main/docker/ascend/Dockerfile.ascend_8.3.rc1_a2>`_
A3             8.2.RC1        `Dockerfile.ascend_8.2.rc1_a3 <https://github.com/volcengine/verl/blob/main/docker/ascend/Dockerfile.ascend_8.2.rc1_a3>`_
A3             8.3.RC1        `Dockerfile.ascend_8.3.rc1_a3 <https://github.com/volcengine/verl/blob/main/docker/ascend/Dockerfile.ascend_8.3.rc1_a3>`_
============== ============== ==============


镜像构建命令示例
--------------------

.. code:: bash

   # 导航到包含 Dockerfile 的目录
   cd {verl-root-path}/docker/ascend
   # 构建镜像
   docker build -f Dockerfile.ascend_8.2.rc1_a2 -t verl-ascend:8.2.rc1-a2 .


声明
--------------------
verl 中提供的 ascend 相关 Dockerfile、镜像皆为参考样例，可用于尝鲜体验，如在生产环境中使用请通过官方正式途径沟通，谢谢。