From 2d22700d69d2983bdd7915df14ec2cddf485cb0d Mon Sep 17 00:00:00 2001 From: huqi Date: Mon, 5 Jan 2026 19:42:42 +0800 Subject: [PATCH] Docs: Add A3 Docker image guidance for Atlas A3 machines (#5256) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Fixes #3386 - Update Qwen3-30B-A3B.md to use A3-specific image tag - Update Qwen3-Dense.md to provide both A2 and A3 image options - Update Qwen3-Next.md to use A3-specific image for Atlas A3 environments Previously, documentation only mentioned A2 images (vllm-ascend:version) but Atlas A3 machines require A3-specific images (vllm-ascend:version-a3). This change ensures users select the correct image for their hardware. 🤖 Generated with [Claude Code](https://claude.com/claude-code) - vLLM version: release/v0.13.0 - vLLM main: https://github.com/vllm-project/vllm/commit/ad32e3e19ccf0526cb6744a5fed09a138a5fb2f9 Signed-off-by: hu-qi Co-authored-by: Claude --- docs/source/tutorials/Qwen3-30B-A3B.md | 5 ++++- docs/source/tutorials/Qwen3-Dense.md | 5 ++++- docs/source/tutorials/Qwen3-Next.md | 5 ++++- 3 files changed, 12 insertions(+), 3 deletions(-) diff --git a/docs/source/tutorials/Qwen3-30B-A3B.md b/docs/source/tutorials/Qwen3-30B-A3B.md index a78971c0..62243f9f 100644 --- a/docs/source/tutorials/Qwen3-30B-A3B.md +++ b/docs/source/tutorials/Qwen3-30B-A3B.md @@ -7,7 +7,10 @@ Run docker container: ```{code-block} bash :substitutions: # Update the vllm-ascend image -export IMAGE=quay.io/ascend/vllm-ascend:|vllm_ascend_version| +# For Atlas A2 machines: +# export IMAGE=quay.io/ascend/vllm-ascend:|vllm_ascend_version| +# For Atlas A3 machines: +export IMAGE=quay.io/ascend/vllm-ascend:|vllm_ascend_version|-a3 docker run --rm \ --name vllm-ascend \ --shm-size=1g \ diff --git a/docs/source/tutorials/Qwen3-Dense.md b/docs/source/tutorials/Qwen3-Dense.md index 6b5ced14..e2338bc6 100644 --- a/docs/source/tutorials/Qwen3-Dense.md +++ b/docs/source/tutorials/Qwen3-Dense.md @@ -61,7 +61,10 @@ docker pull quay.io/ascend/vllm-ascend:|vllm_ascend_version| # Update --device according to your device (Atlas A2: /dev/davinci[0-7] Atlas A3:/dev/davinci[0-15]). # Update the vllm-ascend image according to your environment. # Note you should download the weight to /root/.cache in advance. -export IMAGE=quay.io/ascend/vllm-ascend:|vllm_ascend_version| +# For Atlas A2 machines: +# export IMAGE=quay.io/ascend/vllm-ascend:|vllm_ascend_version| +# For Atlas A3 machines: +export IMAGE=quay.io/ascend/vllm-ascend:|vllm_ascend_version|-a3 docker run --rm \ --name vllm-ascend-env \ --shm-size=1g \ diff --git a/docs/source/tutorials/Qwen3-Next.md b/docs/source/tutorials/Qwen3-Next.md index 0db89a6d..5a573c25 100644 --- a/docs/source/tutorials/Qwen3-Next.md +++ b/docs/source/tutorials/Qwen3-Next.md @@ -27,7 +27,10 @@ If the machine environment is an Atlas 800I A3(64G*16), the deployment approach ```{code-block} bash :substitutions: # Update the vllm-ascend image -export IMAGE=quay.io/ascend/vllm-ascend:|vllm_ascend_version| +# For Atlas A2 machines: +# export IMAGE=quay.io/ascend/vllm-ascend:|vllm_ascend_version| +# For Atlas A3 machines: +export IMAGE=quay.io/ascend/vllm-ascend:|vllm_ascend_version|-a3 docker run --rm \ --shm-size=1g \ --name vllm-ascend-qwen3 \