ascendai/cann Docker镜像是昇腾AI异构计算架构CANN的容器化部署方案,集成CANN核心组件与工具链,深度适配昇腾系列AI芯片,提供从模型训练到推理部署的全流程加速能力。通过容器化封装简化昇腾AI开发环境配置,确保跨平台部署一致性,助力开发者快速构建高效能深度学习应用,显著提升模型训练效率与推理性能,广泛适用于科研实验、智能计算及产业级AI解决方案开发场景。

14 次收藏下载次数: 0状态:社区镜像维护者:昇腾 Ascend AI 容器镜像仓库类型:镜像最近更新:
下载命令
点击查看

Atlas CANN

CANN (Compute Architecture for Neural Networks) is a heterogeneous computing architecture launched by Huawei for AI scenarios. It supports multiple AI frameworks on the upper layer and serves AI processors and programming on the lower layer, acting as a key bridge and a key platform for improving the computing efficiency of Atlas AI processors.


Image Download

CANN 9.2.0-beta.2 has been released. Please visit the https://quay.io/repository/ascend/cann?tab=tags page to obtain it.


CANN Base Container Images && CANN Development Container Images

The CANN base images are built on Ubuntu and openEuler operating systems. They include the CANN toolkit (Toolkit development suite, ops operator package, NNAL acceleration library) and the Python environment.

CANN Development Container Images are built on CANN Base Container Images. In addition to the CANN toolkit suite and Python runtime environment, they come with extra OS utilities(such as zip, vim, tree, etc.), selected Python plugins(such as wheel, pyyaml, setuptools, etc.), and GoogleTest pre-installed.


Supported Tags and Dockerfile Links

Tag Naming Rules

CANN Tags follow this pattern:

<cann_version>-<chip_series>-<os>-<python_version>
FieldExample ValuesDescription
cann-version9.2.0-beta.2,9.1.1, 9.1.0, 9.0.1, 9.1.0-beta.3, 9.0.0, etc.CANN version number
chip-series950, a3, 910b, 910, 310pTarget Atlas chip series
osubuntu22.04, openeuler24.03Base operating system
python-versionpy3.10, py3.11, py3.12Python version
-devel-develOptional suffix, representing a development image

LATEST CANN 9.2.0-beta.2

For tags associated with historical versions, please refer to https://github.com/Ascend/cann-container-image/tree/main/supported_tags.md.

TagDockerfilecontent
https://www.hiascend.com/developer/ascendhub/detail/17da20d1c2b6493cb38765adeba85884?version=9.2.0-beta.2-310p-ubuntu22.04-py3.12https://github.com/Ascend/cann-container-image/blob/main/cann/9.2.0-beta.2-310p-ubuntu22.04-py3.12/Dockerfiletoolkit, ops, nnal
https://www.hiascend.com/developer/ascendhub/detail/17da20d1c2b6493cb38765adeba85884?version=9.2.0-beta.2-310p-openeuler24.03-py3.12https://github.com/Ascend/cann-container-image/blob/main/cann/9.2.0-beta.2-310p-openeuler24.03-py3.12/Dockerfiletoolkit, ops, nnal
https://www.hiascend.com/developer/ascendhub/detail/17da20d1c2b6493cb38765adeba85884?version=9.2.0-beta.2-910-ubuntu22.04-py3.12https://github.com/Ascend/cann-container-image/blob/main/cann/9.2.0-beta.2-910-ubuntu22.04-py3.12/Dockerfiletoolkit, ops, nnal
https://www.hiascend.com/developer/ascendhub/detail/17da20d1c2b6493cb38765adeba85884?version=9.2.0-beta.2-910-openeuler24.03-py3.12https://github.com/Ascend/cann-container-image/blob/main/cann/9.2.0-beta.2-910-openeuler24.03-py3.12/Dockerfiletoolkit, ops, nnal
https://www.hiascend.com/developer/ascendhub/detail/17da20d1c2b6493cb38765adeba85884?version=9.2.0-beta.2-910b-ubuntu22.04-py3.12https://github.com/Ascend/cann-container-image/blob/main/cann/9.2.0-beta.2-910b-ubuntu22.04-py3.12/Dockerfiletoolkit, ops, nnal
https://www.hiascend.com/developer/ascendhub/detail/17da20d1c2b6493cb38765adeba85884?version=9.2.0-beta.2-910b-openeuler24.03-py3.12https://github.com/Ascend/cann-container-image/blob/main/cann/9.2.0-beta.2-910b-openeuler24.03-py3.12/Dockerfiletoolkit, ops, nnal
https://www.hiascend.com/developer/ascendhub/detail/17da20d1c2b6493cb38765adeba85884?version=9.2.0-beta.2-950-ubuntu22.04-py3.12https://github.com/Ascend/cann-container-image/blob/main/cann/9.2.0-beta.2-950-ubuntu22.04-py3.12/Dockerfiletoolkit, ops, nnal
https://www.hiascend.com/developer/ascendhub/detail/17da20d1c2b6493cb38765adeba85884?version=9.2.0-beta.2-950-openeuler24.03-py3.12https://github.com/Ascend/cann-container-image/blob/main/cann/9.2.0-beta.2-950-openeuler24.03-py3.12/Dockerfiletoolkit, ops, nnal
https://www.hiascend.com/developer/ascendhub/detail/17da20d1c2b6493cb38765adeba85884?version=9.2.0-beta.2-a3-ubuntu22.04-py3.12https://github.com/Ascend/cann-container-image/blob/main/cann/9.2.0-beta.2-a3-ubuntu22.04-py3.12/Dockerfiletoolkit, ops, nnal
https://www.hiascend.com/developer/ascendhub/detail/17da20d1c2b6493cb38765adeba85884?version=9.2.0-beta.2-a3-openeuler24.03-py3.12https://github.com/Ascend/cann-container-image/blob/main/cann/9.2.0-beta.2-a3-openeuler24.03-py3.12/Dockerfiletoolkit, ops, nnal
https://www.hiascend.com/developer/ascendhub/detail/17da20d1c2b6493cb38765adeba85884?version=9.2.0-beta.2-310p-ubuntu22.04-py3.12-develhttps://github.com/Ascend/cann-container-image/blob/main/cann/9.2.0-beta.2-310p-ubuntu22.04-py3.12-devel/Dockerfiletoolkit, ops, nnal, os-tool, Python-plugin, googletest
https://www.hiascend.com/developer/ascendhub/detail/17da20d1c2b6493cb38765adeba85884?version=9.2.0-beta.2-310p-openeuler24.03-py3.12-develhttps://github.com/Ascend/cann-container-image/blob/main/cann/9.2.0-beta.2-310p-openeuler24.03-py3.12-devel/Dockerfiletoolkit, ops, nnal, os-tool, Python-plugin, googletest
https://www.hiascend.com/developer/ascendhub/detail/17da20d1c2b6493cb38765adeba85884?version=9.2.0-beta.2-910-ubuntu22.04-py3.12-develhttps://github.com/Ascend/cann-container-image/blob/main/cann/9.2.0-beta.2-910-ubuntu22.04-py3.12-devel/Dockerfiletoolkit, ops, nnal, os-tool, Python-plugin, googletest
https://www.hiascend.com/developer/ascendhub/detail/17da20d1c2b6493cb38765adeba85884?version=9.2.0-beta.2-910-openeuler24.03-py3.12-develhttps://github.com/Ascend/cann-container-image/blob/main/cann/9.2.0-beta.2-910-openeuler24.03-py3.12-devel/Dockerfiletoolkit, ops, nnal, os-tool, Python-plugin, googletest
https://www.hiascend.com/developer/ascendhub/detail/17da20d1c2b6493cb38765adeba85884?version=9.2.0-beta.2-910b-ubuntu22.04-py3.12-develhttps://github.com/Ascend/cann-container-image/blob/main/cann/9.2.0-beta.2-910b-ubuntu22.04-py3.12-devel/Dockerfiletoolkit, ops, nnal, os-tool, Python-plugin, googletest
https://www.hiascend.com/developer/ascendhub/detail/17da20d1c2b6493cb38765adeba85884?version=9.2.0-beta.2-910b-openeuler24.03-py3.12-develhttps://github.com/Ascend/cann-container-image/blob/main/cann/9.2.0-beta.2-910b-openeuler24.03-py3.12-devel/Dockerfiletoolkit, ops, nnal, os-tool, Python-plugin, googletest
https://www.hiascend.com/developer/ascendhub/detail/17da20d1c2b6493cb38765adeba85884?version=9.2.0-beta.2-950-ubuntu22.04-py3.12-develhttps://github.com/Ascend/cann-container-image/blob/main/cann/9.2.0-beta.2-950-ubuntu22.04-py3.12-devel/Dockerfiletoolkit, ops, nnal, os-tool, Python-plugin, googletest
https://www.hiascend.com/developer/ascendhub/detail/17da20d1c2b6493cb38765adeba85884?version=9.2.0-beta.2-950-openeuler24.03-py3.12-develhttps://github.com/Ascend/cann-container-image/blob/main/cann/9.2.0-beta.2-950-openeuler24.03-py3.12-devel/Dockerfiletoolkit, ops, nnal, os-tool, Python-plugin, googletest
https://www.hiascend.com/developer/ascendhub/detail/17da20d1c2b6493cb38765adeba85884?version=9.2.0-beta.2-a3-ubuntu22.04-py3.12-develhttps://github.com/Ascend/cann-container-image/blob/main/cann/9.2.0-beta.2-a3-ubuntu22.04-py3.12-devel/Dockerfiletoolkit, ops, nnal, os-tool, Python-plugin, googletest
https://www.hiascend.com/developer/ascendhub/detail/17da20d1c2b6493cb38765adeba85884?version=9.2.0-beta.2-a3-openeuler24.03-py3.12-develhttps://github.com/Ascend/cann-container-image/blob/main/cann/9.2.0-beta.2-a3-openeuler24.03-py3.12-devel/Dockerfiletoolkit, ops, nnal, os-tool, Python-plugin, googletest

Note: On aarch64, the 9.2.0-beta.2-950-* images additionally include URMA (Unified RoCE Message Access) for RoCE-based distributed communication; x86_64 images do not include it.


Quick Start

Prerequisites

Install Driver

An Atlas NPU driver compatible with the CANN version inside the container must be installed on the host. Please visit the https://www.hiascend.com/developer/download/compatibility for the correspondence between driver and CANN versions.

Run a CANN Container

bash
export CANN_REPO=quay.io/ascend/cann
export CANN_TAG=9.2.0-beta.2-a3-ubuntu22.04-py3.12

docker run \
    --name cann_container \
    --device /dev/davinci0 \
    --device /dev/davinci_manager \
    --device /dev/devmm_svm \
    --device /dev/hisi_hdc \
    -v /usr/local/dcmi:/usr/local/dcmi \
    -v /usr/local/bin/npu-smi:/usr/local/bin/npu-smi \
    -v /usr/local/Ascend/driver/lib64/:/usr/local/Ascend/driver/lib64/ \
    -v /usr/local/Ascend/driver/version.info:/usr/local/Ascend/driver/version.info \
    -v /etc/ascend_install.info:/etc/ascend_install.info \
    -it $CANN_REPO:$CANN_TAG bash

Run a CANN Container on 950 Series aarch64 Products

bash
export CANN_REPO=quay.io/ascend/cann
export CANN_TAG=9.2.0-beta.2-950-openeuler24.03-py3.12

docker run \
    --name cann_container \
    --device /dev/davinci0 \
    --device /dev/davinci_manager \
    --device /dev/hisi_hdc \
    --device /dev/ummu \
    --device /dev/uburma \
    -v /usr/local/dcmi:/usr/local/dcmi \
    -v /usr/local/bin/npu-smi:/usr/local/bin/npu-smi \
    -v /usr/local/Ascend/driver/lib64/:/usr/local/Ascend/driver/lib64/ \
    -v /usr/local/Ascend/driver/version.info:/usr/local/Ascend/driver/version.info \
    -v /etc/ascend_install.info:/etc/ascend_install.info \
    -it $CANN_REPO:$CANN_TAG bash

How to Build Locally

bash
git clone https://github.com/Ascend/cann-container-image.git
cd cann-container-image
export CANN_REPO=my-cann
export CANN_TAG=9.2.0-beta.2-a3-ubuntu22.04-py3.12
# need to install buildx
docker buildx build -t $CANN_REPO:$CANN_TAG -f cann/$CANN_TAG/Dockerfile .

References

If you want to learn how to download CANN software packages, please visit the https://www.hiascend.com/cann/download?versionId=769&ids=d806%2Ch0501%2Ch0601%2Ch0702. If you want to learn more about CANN, including release notes, programming guides, APIs, and development tools, please visit the https://www.hiascend.com/cann/document.


License

View the https://www.hiascend.com/en/legal/cannua-download?isNewCon=true for CANN software included in these images.

As with all container images, pre-installed packages (Python, system libraries, etc.) may be subject to their own licenses.

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

轩辕镜像加速拉取命令点我查看更多 cann 镜像标签

docker pull docker.xuanyuan.run/ascendai/cann:<标签>

DockerHub 原生拉取命令

docker pull ascendai/cann:<标签>
专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载在线技术支持专业版保障服务可用付费会员免广告