--- title: ascend-operator description: 昇腾社区是基于昇腾系列处理器和基础软件构建的全栈 AI计算基础设施、行业应用及服务，包括昇腾系列处理器、系列硬件、CANN异构计算架构、AI计算框架、应用使能、开发工具链、管理运维工具、行业应用及服务等全产业链。 keywords: 公开,集群调度组件,Ascend,Operator,快速参考,应用场景,组件功能,组件上下游依赖 url: https://www.hiascend.com/developer/ascendhub/detail/ascend-operator section: (其他) --- # ascend-operator URL: https://www.hiascend.com/developer/ascendhub/detail/ascend-operator 描述: 昇腾社区是基于昇腾系列处理器和基础软件构建的全栈 AI计算基础设施、行业应用及服务，包括昇腾系列处理器、系列硬件、CANN异构计算架构、AI计算框架、应用使能、开发工具链、管理运维工具、行业应用及服务等全产业链。 关键词: 公开,集群调度组件,Ascend,Operator,快速参考,应用场景,组件功能,组件上下游依赖 昇腾镜像仓库 [了解详情](https://www.hiascend.com/developer/ascendhub) ascend-operator ## ascend-operator公开 最新版本：v26.1.0-ubuntu22.042026/08/03更新大小：106 MB发布者：Ascend855次下载 3.0 其他 镜像概述 镜像下载 镜像概述 镜像下载 ... # 集群调度组件 Ascend Operator ## 快速参考 - Ascend Operator 由MindCluster 代码仓 [了解详情](https://gitcode.com/Ascend/mind-cluster)维护 - 从哪里获取帮助 - MindCluster 代码仓 [了解详情](https://gitcode.com/Ascend/mind-cluster) - MindCluster 昇腾社区 [了解详情](https://www.hiascend.com/document/detail/zh/mindcluster/latest/clustersched/dlug/docs/zh/scheduling/01_introduction/00_overview.md) - 问题反馈 [了解详情](https://gitcode.com/Ascend/mind-cluster/issues) ## Ascend Operator Ascend Operator 是 MindCluster 集群调度组件之一，部署在管理节点上，支持 MindSpore、PyTorch 两个 AI 框架在 Kubernetes 上进行分布式训练。CRD（Custom Resource Definition）中定义了 AscendJob 任务，用户只需配置 YAML 文件，即可轻松实现分布式训练。 ### 应用场景 MindCluster 提供 Ascend Operator 组件，输入集合通信所需的主进程 IP、静态组网集合通信所需的 RankTable 信息、当前 Pod 的 rankId 等信息。 ### 组件功能 - 创建 Pod，并将集合通信参数按照环境变量的方式注入。 - 创建 RankTable 文件，并按照共享存储或 ConfigMap 的方式挂载到容器，优化集合通信建链性能。 ### 组件上下游依赖 1. 通过 Volcano 感知当前任务所需资源是否满足。 2. 资源满足后，针对任务创建对应的 Pod 并注入集合通信参数的环境变量。 3. Pod 创建完成后，Volcano 进行资源的最终选定。 4. 从 Ascend Device Plugin 获取任务的芯片编号、IP、rankId 信息，汇总后生成集合通信文件。 5. 通过共享存储或 ConfigMap，将集合通信文件挂载到容器内。 ## 支持的 Tags 及 Dockerfile 链接 ### Tag 规范 自v26.1.0版本开始 Tag 遵循以下格式： ``` <版本>-<操作系统> ``` | 字段 | 示例值 | 说明 | | --- | --- | ---| | 版本 | v26.1.0 | Ascend Operator 版本号 | | 操作系统 | ubuntu22.04 | Ascend Operator 镜像操作系统 | ### Ascend Operator 26.1.0 | Tag | Dockerfile | 镜像内容 | | --- | --- | ---| | v26.1.0-ubuntu22.04 | Dockerfile.ubuntu | Ascend Operator v26.1.0 (基础镜像 Ubuntu 22.04) | | v26.1.0-openeuler24.03 | Dockerfile.openeuler | Ascend Operator v26.1.0 (基础镜像 openEuler 24.03) | v26.0.0及以前版本的 Tag 遵循以下格式： ``` <版本> ``` | 字段 | 示例值 | 说明 | | --- | --- | ---| | 版本 | v26.0.0 | Ascend Operator 版本号 | ### Ascend Operator 26.0.0 | Tag | Dockerfile | 镜像内容 | | --- | --- | ---| | v26.0.0 | Dockerfile | Ascend Operator v26.0.0 (基础镜像 Ubuntu 22.04) | ## 快速开始 ### 前置要求 #### 软件依赖 | 软件名称 | 支持的版本 | 安装位置 | 说明 | | --- | --- | --- | ---| | Kubernetes | 1.17.x~1.34.x（推荐使用1.19.x及以上版本） | 所有节点 | 了解 K8s 的使用请参见Kubernetes 文档 | | Volcano | 请参见Volcano 官网中对应的 Kubernetes 版本 | 管理节点 | Ascend Operator 依赖 Volcano 进行资源调度 | #### 硬件规格要求 | 名称 | 要求 | | --- | ---| | CPU | 2核 | | 内存 | 2.5GB | ### 如何本地构建 #### v26.1.0 及更高版本本地镜像构建流程 示例场景：构建 linux-aarch64 架构、v26.1.0 版本、基于 Ubuntu 22.04 的 Ascend Operator 组件镜像。 1. 获取对应架构的 Dockerfile 前往支持的 Tags 及 Dockerfile 链接 [了解详情](https://www.hiascend.com/#%E6%94%AF%E6%8C%81%E7%9A%84-Tags-%E5%8F%8A-Dockerfile-%E9%93%BE%E6%8E%A5)章节，打开目标版本对应的 Dockerfile.ubuntu 链接，保存文件至 aarch64 架构环境的本地目录。 2. 本地构建 Docker 镜像（禁用缓存，保证构建纯净度） ``` docker build --no-cache -t ascend-operator:v26.1.0 ./ -f Dockerfile.ubuntu ``` 重要注意事项若 Docker 版本低于 18.09，或未手动开启 BuildKit，构建镜像时将无法读取 TARGETPLATFORM 变量，会造成镜像构建失败。 1. TARGETPLATFORM 为 Docker BuildKit 内置全局变量，用于识别当前构建目标平台，示例：linux/amd64、linux/arm64。 2. 该变量仅在 BuildKit 启用后自动注入；老旧 Docker 环境、默认BuildKit 的环境无法使用此参数。 3. 构建前可执行以下命令临时开启 BuildKit： ``` export DOCKER_BUILDKIT=1 ``` #### v26.0.0 及更早版本本地镜像构建流程 示例场景：构建 linux-aarch64 架构、v26.0.0 版本、基于 Ubuntu 22.04 的 Ascend Operator 组件镜像。 1. 下载官方发布的组件安装包 ``` wget https://gitcode.com/Ascend/mind-cluster/releases/download/v26.0.0/Ascend-mindxdl-ascend-operator_26.0.0_linux-aarch64.zip ``` 2. 解压安装包至自定义目录 ``` unzip Ascend-mindxdl-ascend-operator_26.0.0_linux-aarch64.zip -d Ascend-mindxdl-ascend-operator_26.0.0_linux-aarch64 ``` 3. 进入解压后的工作目录 ``` cd Ascend-mindxdl-ascend-operator_26.0.0_linux-aarch64 ``` 4. 本地构建 Docker 镜像（禁用缓存，保证构建纯净度） ``` docker build --no-cache -t ascend-operator:v26.0.0 ./ -f Dockerfile ``` ### 在线获取 Ascend Operator 镜像 1. 拉取官方镜像 拉取昇腾镜像仓库提供的 Ascend Operator 镜像，替换 {tag} 为实际版本号。 ``` docker pull swr.cn-south-1.myhuaweicloud.com/ascendhub/ascend-operator:{tag} ``` 2. 修改镜像标签 为拉取的官方镜像重新打本地标签，统一本地镜像命名规范，方便后续运维管理。 ``` docker tag swr.cn-south-1.myhuaweicloud.com/ascendhub/ascend-operator:{tag} ascend-operator:{tag} ``` ### 部署 Ascend Operator 1. 启动 Ascend Operator 部署前需将 YAML 文件内的镜像`{tag}`替换为实际使用的镜像版本。 ``` kubectl apply -f ascend-operator-{version}.yaml ``` 2. 验证部署 ``` kubectl get pods -A | grep ascend-operator ``` 预期结果：对应命名空间下的 ascend-operator 相关 Pod 状态为 Running。 ## 支持的硬件 当前支持的昇腾硬件型号说明，请参考官方文档：支持的产品形态和OS清单 [了解详情](https://gitcode.com/Ascend/mind-cluster/blob/master/docs/zh/scheduling/01_introduction/03_supported_product_models_and_os.md#%E6%94%AF%E6%8C%81%E7%9A%84%E4%BA%A7%E5%93%81%E5%BD%A2%E6%80%81%E5%92%8Cos%E6%B8%85%E5%8D%95) ## 许可证 查看这些镜像中包含的 Mind 系列软件的许可证信息 [了解详情](https://www.hiascend.com/zh/legal/softlicense)。 与所有容器镜像一样，预装软件包（Python、系统库等）可能受其自身许可证约束。 ascend-operator 镜像版本 | 版本 | 文件大小 | 更新时间 | 架构 | 操作 | | --- | --- | --- | --- | ---| | v26.1.0-ubuntu22.04 | 106 MB | 2026/08/03 | arm64x86_64 | 立即下载 | | v26.1.0-openeuler24.03 | 185 MB | 2026/08/03 | arm64x86_64 | 立即下载 | | v26.0.1 | 102 MB | 2026/06/23 | arm64x86_64 | 立即下载 | | v7.3.2 | 102 MB | 2026/06/04 | arm64x86_64 | 立即下载 | | v26.0.0 | 102 MB | 2026/04/28 | arm64x86_64 | 立即下载 | | v7.3.1 | 102 MB | 2026/04/28 | arm64x86_64 | 立即下载 | | v7.3.0 | 102 MB | 2026/01/20 | arm64x86_64 | 立即下载 | | v7.2.RC1 | 102 MB | 2025/11/05 | arm64x86_64 | 立即下载 | | v7.1.RC1 | 98 MB | 2025/08/01 | arm64x86_64 | 立即下载 | | v6.0.0.SPC3 | 97 MB | 2025/07/30 | arm64x86_64 | 立即下载 | 共 20 条 10条/页 20条/页 50条/页 1 2 前往