Ascend Deployer
- Ascend Deployer
- 📢最新消息
- 简介
- 目录结构
- 版本说明
- 兼容性信息
- 环境部署
- 快速入门
- 工具限制及注意事项
- 功能介绍
- FAQ
- 安全声明
- 分支维护策略
- 版本维护策略
- 免责声明
- License
- 建议与交流
📢最新消息
- 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工具有多种方式获取并部署使用，具体请参见安装MindCluster 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，我们会尽快回复。感谢您的支持。
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ascend_deployer-26.0.0-py3-none-any.whl.
File metadata
- Download URL: ascend_deployer-26.0.0-py3-none-any.whl
- Upload date:
- Size: 796.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/4.0.2 CPython/3.10.11
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
42805278741368296a68f81ef69968c60a951399da5a54620d89cf5fb4f69068
|
|
| MD5 |
6367313877aabc6f2d27ad5553a22431
|
|
| BLAKE2b-256 |
0e07aa2b87484fae66d595f746c89e8e274044c47f4ababdcdfcb1376298c405
|
