昇腾软件安装部署参考设计，提供系统组件、python第三方依赖自动下载以及一键式安装的功能，并支持驱动、固件、CANN软件包以及MindCluster的安装。

文件	最后提交记录	最后更新时间
.gitee	资料易用性整改 Co-authored-by: xuchuan19<coobeam@163.com>	2 天前
ascend_deployer	修复的hccn check和多master场景 Co-authored-by: xuchuan19<coobeam@163.com>	18 天前
assets	readme	1 年前
docs	【docs】修改描述中的Torch-npu为TorchNPU Co-authored-by: zhang1234mei<zhangmei59@h-partners.com>	10 小时前
parse_excel	新增大规模部署	1 年前
pre-commit	增加敏感词扫描 Co-authored-by: xuchuan19<coobeam@163.com>	10 天前
test	修复的hccn check和多master场景 Co-authored-by: xuchuan19<coobeam@163.com>	18 天前
.gitignore	【docs】修改描述中的Torch-npu为TorchNPU Co-authored-by: zhang1234mei<zhangmei59@h-partners.com>	10 小时前
.pre-commit-config.yaml	资料易用性整改 Co-authored-by: xuchuan19<coobeam@163.com>	2 天前
LICENSE	Add Apache 2.0 license and gitee pull request template	5 年前
MANIFEST.in	适配目录调整	3 年前
NOTICE	Add Apache 2.0 license and gitee pull request template	5 年前
OWNERS	update OWNERS. Signed-off-by: 王睿驹 <12988463+wang-ruiju@user.noreply.gitee.com>	2 年前
README-EN.md	【docs】【AscendDeployer】合入Ascend Deployer英文资料 Co-authored-by: zhang1234mei<zhangmei59@h-partners.com>	20 天前
README.md	【docs】修改描述中的Torch-npu为TorchNPU Co-authored-by: zhang1234mei<zhangmei59@h-partners.com>	10 小时前
Third_Party_Open_Source_Software_Notice	增加第三方开源组件notice Co-authored-by: xuchuan19<coobeam@163.com>	2 天前
contributing.md	资料易用性整改 Co-authored-by: xuchuan19<coobeam@163.com>	2 天前
setup.py	更新readme Co-authored-by: xuchuan19<coobeam@163.com>	6 个月前
version.info	ST: update run_st.sh Co-authored-by: Wu,Qiang-Roy<wuqiangroy@live.com>	3 个月前

Ascend Deployer

📢最新消息
简介
软件架构
版本说明
兼容性信息
环境部署
- 编译构建
  - 环境要求
  - 构建
快速入门
工具限制及注意事项
功能介绍
FAQ
安全声明
分支维护策略
版本维护策略
免责声明
License
贡献声明
建议与交流

📢最新消息

2026-3-30: 🐧 优化下载逻辑，支持culinux的系统依赖包从备用源下载
2026-3-30: 🐧 新增支持部署MAMI软件包
2026-3-30: 🐧 新增支持部署安装Python 3.12版本
2026-3-30: 🐧 新增支持Atlas A5 350硬件上部署软件
2026-3-30: 📥 支持下载和部署Ascend社区软件包7.3.0版本

简介

昇腾软件安装部署参考设计，提供系统组件、Python 第三方依赖自动下载以及一键式安装的功能，并支持驱动、固件、CANN 软件包以及 MindCluster 的安装。更多详情请参见 Ascend Deployer 介绍。

软件架构

Ascend Deployer 采用分层架构，基于 Ansible 实现昇腾软件的下载与部署，整体由入口层、核心层和配置资源层构成：

Ascend Deployer 软件架构

版本说明

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支持下载的OS依赖、软件包及使用限制请参见支持下载的软件包及OS，支持安装部署的组件及相关限制请参见支持安装及升级的软件包

功能介绍

Ascend Deployer组件提供批量部署Python、NPU、CANN、toolbox、fault-diag和MindCluster集群调度等功能。具体特性介绍如下：

功能名称	介绍
下载软件包	下载软件包
安装部署软件	安装部署软件
升级软件	升级软件

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	长期支持	维护	2026-03-05	预计2026-12-31起进入无维护状态	-
v7.2.RC1	常规分支	EOL	2025-12-18	-	2026-03-24
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 文件。

贡献声明

贡献前，请先签署开放项目贡献者许可协议（CLA）。
如果您遇到bug，请提交issue。
如果您计划贡献bug-fixes，请提交Pull Requests，参见具体要求。
如果您计划贡献新特性、功能，请先创建issue与我们讨论。写明需求背景/目的，如何设计，对现有API等的影响。未经讨论提交PR可能会导致请求被拒绝，因为项目演进方向可能与您的想法存在偏差。
更详细的贡献流程，请参考贡献指南。

建议与交流

欢迎大家为社区做贡献。如果有任何疑问或建议，请提交issue，我们会尽快回复。感谢您的支持。

项目介绍