Metadata-Version: 2.1
Name: ascend-deployer
Version: 26.0.0
Summary: ascend offline installer
Home-page: https://gitcode.com/ascend/ascend-deployer
License: Apache
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Requires-Python: >= 3.6
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE

# Ascend Deployer

- [Ascend Deployer](#ascend-deployer)
- [📢最新消息](#最新消息)
- [简介](#简介)
- [目录结构](#目录结构)
- [版本说明](#版本说明)
- [兼容性信息](#兼容性信息)
- [环境部署](#环境部署)
  - [编译构建](#编译构建)
    - [环境要求](#环境要求)
    - [构建](#构建)
- [快速入门](#快速入门)
- [工具限制及注意事项](#工具限制及注意事项)
- [功能介绍](#功能介绍)
- [FAQ](#faq)
- [安全声明](#安全声明)
- [分支维护策略](#分支维护策略)
- [版本维护策略](#版本维护策略)
- [免责声明](#免责声明)
- [License](#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介绍](./docs/zh/introduction.md)。

# 目录结构

```text 
├── 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发行版](https://gitcode.com/Ascend/ascend-deployer/releases)

# 兼容性信息

Ascend Deployer支持安装的硬件和部件兼容性请参见：[兼容性查询助手](https://www.hiascend.com/hardware/compatibility)

# 环境部署

Ascend Deployer工具有多种方式获取并部署使用，具体请参见[安装MindCluster Ascend Deployer工具](./docs/zh/installation_guide.md#安装mindcluster-ascend-deployer工具)

## 编译构建

### 环境要求

- wheel >= 0.38.0

### 构建

下载ascend-deployer后，进入第一层目录，该目录下方存有setup.py文件，执行以下命令构建

   ```shell
   python3 setup.py bdist_wheel
   ```

# 快速入门

指导开发者快速完成sys_pkg、Python、NPU、CANN、toolbox、fault-diag组件的部署。具体操作请参见：[Ascend Deployer安装部署工具](./docs/zh/introduction.md)。

# 工具限制及注意事项

Ascend Deployer支持下载的OS依赖、软件包及使用限制请参见[支持下载的软件包及OS](./docs/zh/appendix.md#支持下载的软件包和os)，支持安装部署的组件及相关限制请参见[支持安装及升级的软件包](./docs/zh/appendix.md#支持安装及升级的软件包)

# 功能介绍

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

| 功能名称   | 介绍                                                                                                            | 
|--------|---------------------------------------------------------------------------------------------------------------|
| 下载软件包  | [link](./docs/zh/installation_guide.md#下载昇腾软件) |
| 安装部署软件 | [link](./docs/zh/installation_guide.md#安装昇腾软件)                                                                                                 |
| 升级软件   | [link](./docs/zh/installation_guide.md#升级昇腾软件)                                                                                                  |

# FAQ

相关FAQ请参见：[FAQ](./docs/zh/faq.md)。

# 安全声明

- Ascend Deployer部署时会安装必要的一些第三方依赖，请自行对部署后的环境漏洞扫描修复和对系统安全加固。
- 配置inventory_file和large_scale_inventory.ini时，为了安全请优先配置[SSH免密](./docs/zh/installation_guide.md#远程连接服务器可选)。
- 通信矩阵详见：[通信矩阵](https://gitcode.com/Ascend/ascend-deployer/wiki/%E9%80%9A%E4%BF%A1%E7%9F%A9%E9%98%B5.md#%E9%80%9A%E4%BF%A1%E7%9F%A9%E9%98%B5)
- 公网地址详见：[公网地址](./docs/zh/resource/MindCluster%20Ascend%20Deployer工具公网地址.xlsx)

# 分支维护策略

版本分支的维护阶段如下：

| 状态          | 时间     | 说明                                                      |
|-------------|--------|---------------------------------------------------------|
| 计划          | 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文件](https://gitcode.com/Ascend/ascend-deployer/blob/dev/LICENSE)。

介绍Ascend Deployer docs目录下的文档适用CC-BY 4.0许可证，具体请参见[LICENSE文件](./docs/LICENSE)。

# 建议与交流

欢迎大家为社区做贡献。如果有任何疑问或建议，请提交[issue](https://gitcode.com/Ascend/ascend-deployer/issues)，我们会尽快回复。感谢您的支持。
