Ascend Deployer
📢最新消息
- 2025-12-30: 🚫 不再支持hccl-controller组件的安装与升级操作
- 2025-12-30: 🚫 不再支持tfplugin组件的安装与升级操作
- 2025-12-30: 🐧 新增支持在麒麟Kylin V11操作系统上部署软件
- 2025-12-30: 🐧 新增支持在VesselOS 2.0操作系统上部署软件
- 2025-12-30: 📥 支持下载Ascend社区软件包7.2.0版本
简介
昇腾软件安装部署参考设计，提供系统组件、Python第三方依赖自动下载以及一键式安装的功能，并支持驱动、固件、CANN软件包以及MindCluster的安装。更多详情请参见Ascend Deployer介绍。
目录结构
├── ascend_deployer # 主程序目录，包含部署相关的核心脚本和配置
│ ├── ansible_plugin # Ansible 插件目录，包含日志、部署信息输出等插件
│ ├── downloader # 下载器模块，用于下载 Ascend 相关软件包和依赖
│ │ ├── config # 各操作系统下的依赖配置信息
│ │ ├── python_requirements # 各 Python 版本的依赖包配置
│ │ ├── software # 各软件包的下载配置信息（CANN、MindSpore等）
│ │ └── yum_metadata # YUM 元数据相关工具
│ ├── playbooks # Ansible Playbooks 脚本目录，包含安装、处理、场景等相关剧本
│ ├── tools # 工具脚本集合
│ ├── group_vars # Ansible 组变量定义目录
│ ├── patch # 补丁文件存放目录
│ ├── scripts # 部署过程中使用的辅助脚本
│ ├── yamls # YAML 配置文件目录
│ ├── library # 自定义库文件目录，包含各类安装检查功能模块
│ ├── module_utils # Ansible 模块工具目录
│ │ ├── check_library_utils # 检查库工具
│ │ ├── deepseek_cntr # DeepSeek 控制器相关工具
│ │ └── deepseek_pd # DeepSeek PD 相关工具
│ ├── templates # 模板文件目录
│ ├── large_scale_deploy # 大规模部署相关文件目录
│ │ ├── common # 公共数据模块
│ │ ├── config_model # 配置模型
│ │ ├── handler # 库存分割处理器
│ │ ├── process # 远程部署任务处理
│ │ ├── tools # 大规模部署工具集
│ │ └── view # 视图展示模块
│ ├── start_deploy.py # 启动部署流程的主入口脚本
│ ├── install.sh # 安装脚本
│ ├── large_scale_install.sh # 大规模部署安装脚本
│ ├── large_scale_deployer.py # 大规模部署主逻辑脚本
│ ├── inventory_file # 默认库存文件
│ ├── ansible.cfg # Ansible 配置文件
│ ├── version.json # 版本信息文件
│ └── utils.py # 工具函数模块，包含版本比较、路径复制等功能
版本说明
Ascend Deployer最新发行版下载链接：Ascend Deployer发行版
兼容性信息
Ascend Deployer支持安装的硬件和部件兼容性请参见：兼容性查询助手
环境部署
Ascend Deployer工具有多种方式获取并部署使用，具体请参见Ascend Deployer获取方式
编译构建
环境要求
- wheel >= 0.38.0
构建
下载ascend-deployer后，进入第一层目录，该目录下方存有setup.py文件，执行以下命令构建
python3 setup.py bdist_wheel
快速入门
指导开发者快速完成sys_pkg、Python、NPU、CANN、toolbox、fault-diag组件的部署。具体操作请参见：Ascend Deployer安装部署工具。
工具限制及注意事项
Ascend Deployer支持下载的OS依赖、软件包及使用限制请参见支持下载的软件包及OS，支持安装部署的组件及相关限制请参见支持安装及升级的软件包
功能介绍
Ascend Deployer组件提供批量部署Python、NPU、CANN、toolbox、fault-diag和MindCluster集群调度等功能。具体特性介绍如下：
| 功能名称 | 介绍 |
|---|---|
| 下载软件包 | link |
| 安装部署软件 | link |
| 升级软件 | link |
FAQ
相关FAQ请参见：FAQ。
安全声明
- Ascend Deployer部署时会安装必要的一些第三方依赖，请自行对部署后的环境漏洞扫描修复和对系统安全加固。
- 配置inventory_file和large_scale_inventory.ini时，为了安全请优先配置SSH免密。
- 通信矩阵详见：通信矩阵
- 公网地址详见：公网地址
分支维护策略
版本分支的维护阶段如下：
| 状态 | 时间 | 说明 |
|---|---|---|
| 计划 | 1-3个月 | 计划特性 |
| 开发 | 3个月 | 开发新特性并修复问题，定期发布新版本 |
| 维护 | 3-12个月 | 常规分支维护3个月，长期支持分支维护12个月。对重大BUG进行修复，不合入新特性，并视BUG的影响发布补丁版本 |
| 生命周期终止（EOL） | N/A | 分支不再接受任何修改 |
版本维护策略
| 版本 | 维护策略 | 当前状态 | 发布日期 | 后续状态 | EOL日期 |
|---|---|---|---|---|---|
| dev | 长期支持 | 开发 | 在研分支，不发布 | - | - |
| v7.3.0 | 长期支持 | 开发 | 在研分支，未发布 | - | - |
| v7.2.RC1 | 常规分支 | 开发 | 在研分支，未发布 | - | - |
| v7.1.RC1 | 常规分支 | EOL | 2025-07-24 | 2025-10-24 | |
| v7.0.RC1 | 常规分支 | EOL | 2025-04-27 | 2025-07-27 | |
| v6.0.0 | 长期支持 | 维护 | 2024-12-31 | 预计2025-12-31起进入无维护状态 | |
| v6.0.RC3 | 常规分支 | EOL | 2024-11-20 | 2025-02-20 | |
| v6.0.RC2 | 常规分支 | EOL | 2024-11-20 | 2025-02-20 | |
| v6.0.RC1 | 常规分支 | EOL | 2024-11-20 | 2025-02-20 | |
| v5.0.0.3 | 长期支持 | EOL | 2023-11-20 | 2024-11-20 |
免责声明
- 本代码仓库中包含多个开发分支，这些分支可能包含未完成、实验性或未测试的功能。在正式发布之前，这些分支不应被用于任何生产环境或依赖关键业务的项目中。请务必仅使用我们的正式发行版本，以确保代码的稳定性和安全性。 使用开发分支所导致的任何问题、损失或数据损坏，本项目及其贡献者概不负责。本仓库提供Ansible运维示例，请勿直接用于生产环境。
- 正式版本请参见Ascend Deployer正式release版本https://gitcode.com/Ascend/ascend-deployer/releases。
License
Ascend Deployer以Apache 2.0许可证许可，具体请参见LICENSE文件。
介绍Ascend Deployer docs目录下的文档适用CC-BY 4.0许可证，具体请参见LICENSE文件。
建议与交流
欢迎大家为社区做贡献。如果有任何疑问或建议，请提交issue，我们会尽快回复。感谢您的支持。