openeuler/cann Docker 镜像
Ascend CANN的官方容器镜像仓库,基于openEuler构建,提供面向AI的异构计算架构,通过分层API助力快速构建基于昇腾平台的AI应用和服务。
快速参考
-
官方CANN Docker镜像。
-
维护者:https://gitee.com/openeuler/cloudnative。
-
获取帮助:https://gitee.com/openeuler/cloudnative、https://gitee.com/openeuler/community。
CANN | openEuler
当前CANN Docker镜像基于https://repo.openeuler.org/构建。本仓库可免费使用,且不受每用户速率限制。
面向AI的异构计算架构提供分层API,帮助您基于昇腾平台快速构建AI应用和服务。
更多信息请参见https://www.hiascend.com/en/document。
支持的标签及对应Dockerfile链接
每个cann Docker镜像的标签由完整软件栈版本组成,详情如下:
| 标签 | 当前版本说明 | 架构 |
|---|---|---|
| https://gitee.com/openeuler/openeuler-docker-images/blob/master/AI/cann/7.0.RC1.alpha002/22.03-lts-sp2/Dockerfile | CANN 7.0.RC1.alpha002 基于 openEuler 22.03-LTS-SP2 | arm64 |
| https://gitee.com/openeuler/openeuler-docker-images/blob/master/AI/cann/8.0.RC1/22.03-lts-sp4/Dockerfile | CANN 8.0.RC1(含Python 3.8)基于 openEuler 22.03-LTS-SP4 | arm64,amd64 |
| https://gitee.com/openeuler/openeuler-docker-images/blob/master/AI/cann/8.1.RC1-python3.11/22.03-lts/Dockerfile | CANN 8.1.RC1(含Python 3.11)基于 openEuler 22.03-LTS | arm64,amd64 |
| https://gitee.com/openeuler/openeuler-docker-images/blob/master/AI/cann/8.1.RC1-python3.11/24.03-lts/Dockerfile | CANN 8.1.RC1(含Python 3.11)基于 openEuler 24.03-LTS | arm64,amd64 |
| https://gitee.com/openeuler/openeuler-docker-images/blob/master/AI/cann/8.2.RC1.alpha001-python3.10/22.03-lts/Dockerfile | CANN 8.2.RC1.alpha001(含Python 3.10)基于 openEuler 22.03-LTS | arm64,amd64 |
| https://gitee.com/openeuler/openeuler-docker-images/blob/master/AI/cann/8.2.RC1.alpha002-python3.10/22.03-lts/Dockerfile | CANN 8.2.RC1.alpha002(含Python 3.10)基于 openEuler 22.03-LTS | arm64,amd64 |
使用方法
用户可根据需求选择对应的{Tag}和容器启动选项。
-
从Docker拉取
openeuler/cann镜像bashdocker pull docker.xuanyuan.run/openeuler/cann:{Tag} -
启动CANN实例
bashdocker run \ --name my-cann \ --device /dev/davinci1 \ --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 docker.xuanyuan.run/openeuler/cann:{Tag} bash -
容器启动选项说明
选项 描述 --name my-cann为容器命名为 my-cann。--device /dev/davinciXNPU设备,其中 X为芯片物理ID号,例如davinci1。--device /dev/davinci_managerDavinci相关管理设备。 --device /dev/devmm_svm内存管理相关设备。 --device /dev/hisi_hdcHDC相关管理设备。 -v /usr/local/dcmi:/usr/local/dcmi将主机的DCMI .so及接口文件目录/usr/local/dcmi挂载到容器,需根据实际情况修改。 -v /usr/local/bin/npu-smi:/usr/local/bin/npu-smi将主机npu-smi工具"/usr/local/bin/npu-smi"挂载到容器,需根据实际情况修改。 -v /usr/local/Ascend/driver/lib64/:/usr/local/Ascend/driver/lib64/将主机目录/usr/local/Ascend/driver/lib64/挂载到容器,需根据驱动.so文件实际路径修改。 -v /usr/local/Ascend/driver/version.info:/usr/local/Ascend/driver/version.info将主机版本信息文件/usr/local/Ascend/driver/version.info挂载到容器,需根据实际情况修改。 -v /etc/ascend_install.info:/etc/ascend_install.info将主机安装信息文件/etc/ascend_install.info挂载到容器。 -it以交互模式启动容器并分配终端(bash)。 openeuler/cann:{Tag}指定要运行的Docker镜像,将 {Tag}替换为所需openeuler/cann镜像的具体版本或标签。 -
查看容器运行日志
bashdocker logs -f my-cann -
获取交互式shell
bashdocker exec -it my-cann /bin/bash
问题与反馈
如有任何问题或需使用特定功能,请在https://gitee.com/openeuler/openeuler-docker-images提交issue或pull request。
openeuler 命名空间的其他可用镜像:
openeuler/openeuler
openEuler 操作系统,开源 Linux 发行版,适合企业级应用
openeuler/open-webui
Open WebUI,基于 openEuler 的 Web 用户界面
openeuler/openclaw
openEuler 发布的 OpenClaw 镜像,适合在 openEuler 或信创环境中部署
openeuler/opencode
openEuler 发布的 OpenCode AI 助手镜像,适合本地对话式开发与工具链集成
openeuler/vllm-ascend
openEuler 场景下的 vLLM Ascend 推理镜像,适合在昇腾硬件上部署大模型在线服务
openeuler/kylin
openEuler 生态中的 Kylin 基础环境镜像,适合信创/国产化环境下的应用构建与验证
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull openeuler/cann:<标签>
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务