【PR】: 更新安装方式-graph-autofusion-AtomGit

已合并

【PR】: 更新安装方式 #1244

Sophia1213创建于 7月9日从sophia1213/graph-autofusion： develop 合入到 cann/graph-autofusion： develop

【PR】: 更新安装方式 #1244

已合并

Sophia1213创建于 7月9日

从sophia1213/graph-autofusion develop合入到cann/graph-autofusion develop

共 6 个文件变更+54-43

A.gitattributes+2-0

@@ -0,0 +1,2 @@
	1	+*.png filter=lfs diff=lfs merge=lfs -text
	2	+*.gif filter=lfs diff=lfs merge=lfs -text

Mdocs/en/quick_install.md+26-23

	@@ -2,28 +2,32 @@
2		2
3	## 1. Environment Preparation	3	## 1. Environment Preparation
4		4
5	-This project supports compilation from source. Before compiling from source, ensure you have installed CANN software (Ascend-cann-toolkit and Ascend-cann-ops (optional)). If you run samples, you also need to install NPU drivers and firmware.	5	+This project supports source code compilation. Before source code compilation, you need to ensure that CANN software (Toolkit development suite package and ops package (optional)) has been installed. If running samples, you also need to install NPU driver and firmware.
6		6
7	-Select the software installation method based on the following descriptions:	7	+Please choose the software installation method according to the following description:
8		8
9	-\| Installation Method \| Description \| Use Case \|	9	+\| Installation Method \| Description \| Usage Scenario \|
10	\| :------------- \| :----------------------------------------------------------- \| :----------------------------------------------------------- \|	10	\| :------------- \| :----------------------------------------------------------- \| :----------------------------------------------------------- \|
11	-\| WebIDE Installation \| WebIDE provides an online directly runnable Ascend environment. It currently provides single-machine computing power. It installs the latest commercial release CANN software package (currently CANN 8.5.0) and firmware/driver package by default.<br>For using the master branch, refer to Method 3 to install the latest community package. \| Suitable for developers without Ascend devices. \|	11	+\| CANNLab \| One-stop development platform, providing online directly runnable Ascend environment, no manual installation required.<br>Currently provides single-machine computing power, installs the latest commercial release CANN package by default. \| Suitable for developers without Ascend devices. \|
12	-\| Docker \| Docker images provide an efficient deployment method. One-click deployment of CANN packages and essential dependencies.<br>Currently, the OS only supports Ubuntu operating system. It installs version 9.0.0 CANN software package and firmware/driver package by default. \| Suitable for developers with Ascend devices who need to quickly set up the environment. \|	12	+\| Docker \| Docker image is an efficient deployment method, one-click deployment of CANN package and essential dependencies.<br>Currently OS only supports Ubuntu operating system, installs the latest commercial release CANN package by default. \| Suitable for developers with Ascend devices who need to quickly set up the environment. \|
13	-\| Manual Package Installation \| - \| Suitable for developers with Ascend devices who want to experience manual CANN package installation or the latest master branch capabilities. \|	13	+\| Manual Installation \| Manual installation of CANN package and basic dependencies, high flexibility. \| Suitable for developers with Ascend devices who want to experience manual CANN package installation or experience the latest master branch capabilities. \|
14		14
15	-### Method 1: Use WebIDE Installation	15	+### Method 1: CANNLab
16		16
17	-For users without an environment, use the WebIDE development platform directly. This "one-stop operator development platform" provides an online directly runnable Ascend environment. The environment has essential software packages pre-installed. No manual installation required. For more information about the development platform, refer to [LINK](https://gitcode.com/org/cann/discussions/54).	17	+For developers without Ascend devices, you can directly use CANNLab cloud development environment, which is a "one-stop development platform". This platform provides online directly runnable Ascend environment for you, with essential driver firmware, software packages and dependencies already installed, no manual installation required.
18		18
19	-> Note:	19	+> [!NOTE]NOTE
20	-The environment installs the latest commercial release CANN software package (currently CANN 8.5.0) and firmware/driver package by default. Pay attention to software compatibility when downloading source code.	20	+> The environment installs the latest commercial release CANN package by default. Please note the software compatibility when downloading source code. To experience master version capabilities or develop based on master version, please refer to [Method 3 - Scenario 1](#method-3-manual-package-installation) to install the latest CANN package dependencies.<br>For more introduction about the development platform, please refer to [CANNLab Guide](https://gitcode.com/org/cann/discussions/54).
21		21
22	-1. Enter the open-source project. Click the "`Cloud Development`" button. Log in with an authenticated Huawei Cloud account. If not registered or authenticated, follow the page prompts to register and authenticate.	22	+1. Enter the open source project and click the "`CANNLab`" button, log in with a certified Huawei Cloud account. If not registered or certified, please follow the page prompts to register and certify.
23		23
24	- <img src="../figures/cloudIDE.png" alt="Cloud Platform" width="750px" height="90px">	24	+ <img src="../figures/cloudIDE_en.png" alt="Cloud Platform" width="750px" height="90px">
25		25
26	-2. Follow the page prompts to create and start the cloud development environment. Click "`Connect > WebIDE`" to enter the one-stop operator development platform. Open-source project resources default to the `/mnt/workspace` directory.	26	+2. Create NPU environment and configure specifications according to page prompts. After starting the cloud development environment, click "`Connect > WebIDE`" to enter the one-stop development platform.
		27	+
		28	+ Currently, the open source project resource directory depends on how the environment was created:
		29	+ - If created from the CANN community repository, resources are located in `/mnt/workspace/gitCode/cann`.
		30	+ - If created from a personally forked CANN repository, resources are located in `/mnt/workspace/gitCode/{forked_repository}`.
27		31
28	<img src="../figures/webIDE.png" alt="Cloud Platform" width="1000px" height="150px">	32	<img src="../figures/webIDE.png" alt="Cloud Platform" width="1000px" height="150px">
29		33
	@@ -31,9 +35,8 @@ The environment installs the latest commercial release CANN software package (cu
31		35
32	For developers who do not depend on Ascend devices, if you want to quickly set up a compilation build environment, use Docker image deployment.	36	For developers who do not depend on Ascend devices, if you want to quickly set up a compilation build environment, use Docker image deployment.
33		37
34	-> Note:	38	+> [!NOTE]NOTE
35	-Image files are large. Downloading requires some time. Please wait patiently. For docker command option descriptions, query through `docker --help`.	39	+>Image files are large. Downloading requires some time. Please wait patiently. For docker command option descriptions, query through `docker --help`.
36	-<br>The environment installs version 9.0.0 CANN software package and firmware/driver package by default. Pay attention to software compatibility when downloading source code.
37		40
38	1.Install Driver and Firmware (Runtime Dependency)	41	1.Install Driver and Firmware (Runtime Dependency)
39		42
	@@ -98,7 +101,7 @@ Select different startup methods based on use case:
98	\| `swr.cn-south-1.myhuaweicloud.com/ascendhub/cann:...` \| Specifies the Docker image to run. \| Required. Ensure this image name and tag match exactly with the image you pulled through `docker pull`. \|	101	\| `swr.cn-south-1.myhuaweicloud.com/ascendhub/cann:...` \| Specifies the Docker image to run. \| Required. Ensure this image name and tag match exactly with the image you pulled through `docker pull`. \|
99	\| `bash` \| Command to execute immediately after container starts. \| Required \|	102	\| `bash` \| Command to execute immediately after container starts. \| Required \|
100		103
101	- > Note:	104	+ > [!NOTE]NOTE
102	> - Scenario 1 applies to compilation-only scenarios for graph-autofusion. No NPU device support required.	105	> - Scenario 1 applies to compilation-only scenarios for graph-autofusion. No NPU device support required.
103	> - Scenario 2 applies to scenarios requiring sample execution or NPU-related testing. Host machine requires NPU driver and firmware installed.	106	> - Scenario 2 applies to scenarios requiring sample execution or NPU-related testing. Host machine requires NPU driver and firmware installed.
104	> - If using other chip models (such as Ascend950PR or Atlas A3 series products), adjust device names in the `--device` parameter accordingly.	107	> - If using other chip models (such as Ascend950PR or Atlas A3 series products), adjust device names in the `--device` parameter accordingly.
	@@ -110,10 +113,10 @@ After entering the container, execute the following command to initialize the en
110	curl -fsSL https://raw.gitcode.com/cann/graph-autofusion/raw/master/scripts/init_env.sh \| bash	113	curl -fsSL https://raw.gitcode.com/cann/graph-autofusion/raw/master/scripts/init_env.sh \| bash
111	```	114	```
112		115
113	-> Note:	116	+> [!NOTE]NOTE
		117	+>
114	> - CANN package and operator package installation occurs by default.	118	> - CANN package and operator package installation occurs by default.
115	-> - For other chip models, use the `--chip-type` parameter to specify the corresponding model (such as `950` or `A3`). For optional parameters, refer to [	119	+> - For other chip models, use the `--chip-type` parameter to specify the corresponding model (such as `950` or `A3`). For optional parameters, refer to [init_env.sh](../../scripts/init_env.sh)
116	-init_env.sh](../../scripts/init_env.sh)
117		120
118	### Method 3: Manual Package Installation	121	### Method 3: Manual Package Installation
119		122
	@@ -121,7 +124,7 @@ init_env.sh](../../scripts/init_env.sh)
121		124
122	For driver and firmware download and installation operations, refer to the "Prepare Software Packages" and "Install NPU Driver and Firmware" chapters in the "[CANN Software Installation Guide](https://www.hiascend.com/document/redirect/CannCommunityInstWizard)". Driver and firmware are dependencies for running samples. If you only compile the environment, you do not need to install them.	125	For driver and firmware download and installation operations, refer to the "Prepare Software Packages" and "Install NPU Driver and Firmware" chapters in the "[CANN Software Installation Guide](https://www.hiascend.com/document/redirect/CannCommunityInstWizard)". Driver and firmware are dependencies for running samples. If you only compile the environment, you do not need to install them.
123		126
124	-2. Install CANN Package	127	+2. Install CANN Package
125		128
126	Scenario 1: Experience master version capabilities or develop based on master version	129	Scenario 1: Experience master version capabilities or develop based on master version
127		130
	@@ -139,7 +142,7 @@ init_env.sh](../../scripts/init_env.sh)
139	- `${cann_version}`: Indicates CANN package version number.	142	- `${cann_version}`: Indicates CANN package version number.
140	- `${arch}`: Indicates CPU architecture, for example, `aarch64` or `x86_64`.	143	- `${arch}`: Indicates CPU architecture, for example, `aarch64` or `x86_64`.
141	- `${install_path}`: Indicates the specified installation path. Must match the Toolkit package installation path. Root user default installation path is `/usr/local/Ascend` directory.	144	- `${install_path}`: Indicates the specified installation path. Must match the Toolkit package installation path. Root user default installation path is `/usr/local/Ascend` directory.
142	-	145	+
143	2. Install CANN ops operator package.	146	2. Install CANN ops operator package.
144		147
145	```bash	148	```bash
	@@ -153,4 +156,4 @@ init_env.sh](../../scripts/init_env.sh)
153		156
154	Scenario 2: Experience released version capabilities or develop based on released version	157	Scenario 2: Experience released version capabilities or develop based on released version
155		158
156	- If you want to experience official released CANN package capabilities, visit the [CANN Official Download Center](https://www.hiascend.com/cann/download). Select the corresponding version CANN software package (only supports CANN 8.5.0 and later versions) for installation.	159	+ If you want to experience official released CANN package capabilities, visit the [CANN Official Download Center](https://www.hiascend.com/cann/download). Select the corresponding version CANN software package (only supports CANN 8.5.0 and later versions) for installation.

Mdocs/figures/cloudIDE.png+0-0

Adocs/figures/cloudIDE_en.png+3-0

@@ -0,0 +1,3 @@
	1	+version https://git-lfs.github.com/spec/v1
	2	+oid sha256:9c48b3fca4bf03dfe245e4f36d0792e91ea3f49caedb52b0ebb5105656e8b73e
	3	+size 40860

Mdocs/figures/webIDE.png+0-0

Mdocs/zh/quick_install.md+23-20

	@@ -2,28 +2,32 @@
2		2
3	## 1. 环境准备	3	## 1. 环境准备
4		4
5	-本项目支持源码编译，在源码编译前，需要确保已经安装CANN软件（Ascend-cann-toolkit和Ascend-cann-ops（可选）），若运行样例，还需要安装NPU驱动和固件。	5	+本项目支持源码编译，在源码编译前，需要确保已经安装CANN软件（Toolkit开发套件包和ops包（可选）），若运行样例，还需要安装NPU驱动和固件。
6		6
7	软件安装方式请根据如下描述进行选择：	7	软件安装方式请根据如下描述进行选择：
8		8
9	\| 安装方式 \| 说明 \| 使用场景 \|	9	\| 安装方式 \| 说明 \| 使用场景 \|
10	\| :------------- \| :----------------------------------------------------------- \| :----------------------------------------------------------- \|	10	\| :------------- \| :----------------------------------------------------------- \| :----------------------------------------------------------- \|
11	-\| 使用WebIDE安装 \| WebIDE可提供在线直接运行的昇腾环境，当前可提供单机算力，默认安装最新商发版CANN软件包（目前是CANN 8.5.0）和固件/驱动包。<br>对于master分支的使用，需要参考方式三安装最新社区包。 \| 适用于没有昇腾设备的开发者。 \|	11	+\| CANNLab \| 一站式开发平台，提供在线直接运行的昇腾环境，无需手动安装。<br>当前可提供单机算力，默认安装最新商发版CANN包。 \| 适用于没有昇腾设备的开发者。 \|
12	-\| Docker \| Docker镜像是一种高效部署方式，一键部署CANN包和必备依赖。<br>当前OS仅支持Ubuntu操作系统。默认安装9.0.0版本的CANN软件包和固件/驱动包。 \|适用有昇腾设备，需要快速搭建环境的开发者。\|	12	+\| Docker \| Docker镜像是一种高效部署方式，一键部署CANN包和必备依赖。<br>当前OS仅支持Ubuntu操作系统，默认安装最新商发版CANN包。 \|适用有昇腾设备，需要快速搭建环境的开发者。\|
13	-\| 手动安装软件包 \| - \| 适用有昇腾设备，想体验手动安装CANN包或体验最新master分支能力的开发者。 \|	13	+\| 手动安装 \| 手动安装CANN包和基础依赖，灵活性高。 \| 适用有昇腾设备，想体验手动安装CANN包或体验最新master分支能力的开发者。 \|
14		14
15	-### 方式一：使用WebIDE安装	15	+### 方式一：CANNLab
16		16
17	-对于无环境的用户，可直接使用WebIDE开发平台，即“算子一站式开发平台”，该平台为您提供在线可直接运行的昇腾环境，环境中已安装必备的软件包，无需手动安装。更多关于开发平台的介绍请参考[LINK](https://gitcode.com/org/cann/discussions/54)。	17	+对于无昇腾设备的开发者，可直接使用CANNLab云开发环境，即“一站式开发平台”，该平台为您提供在线可直接运行的昇腾环境，环境中已安装必备的驱动固件、软件包和依赖，无需手动安装。
18		18
19	-> 说明：	19	+> [!NOTE]说明
20	-环境默认安装最新商发版CANN软件包（目前是CANN 8.5.0）和固件/驱动包，源码下载时注意与软件配套。	20	+> 环境默认安装最新商发版CANN包，源码下载时注意与软件配套。体验master版本能力或基于master版本进行开发，请参考[方式三-场景1](#方式三手动安装软件包)安装最新CANN包依赖。<br>更多关于开发平台的介绍请参考[CANNLab指导](https://gitcode.com/org/cann/discussions/54)。
21		21
22	-1. 进入开源项目，单击“`云开发`”按钮，使用已认证过的华为云账号登录。若未注册或认证，请根据页面提示进行注册和认证。	22	+1. 进入开源项目，单击“`CANNLab`”按钮，使用已认证过的华为云账号登录。若未注册或认证，请根据页面提示进行注册和认证。
23		23
24	<img src="../figures/cloudIDE.png" alt="云平台" width="750px" height="90px">	24	<img src="../figures/cloudIDE.png" alt="云平台" width="750px" height="90px">
25		25
26	-2. 根据页面提示创建并启动云开发环境，单击“`连接 > WebIDE`”进入算子一站式开发平台，开源项目的资源默认在`/mnt/workspace`目录下。	26	+2. 根据页面提示创建NPU环境并配置规格，启动云开发环境后，单击“`连接 > WebIDE`”进入一站式开发平台。
		27	+
		28	+ 当前开源项目资源目录根据环境创建方式有所不同：
		29	+ - 如果是从CANN社区仓库创建的环境，资源默认在`/mnt/workspace/gitCode/cann`目录下。
		30	+ - 如果是从个人仓库fork的CANN仓库创建的环境，资源默认在`/mnt/workspace/gitCode/{fork仓库}`目录下。
27		31
28	<img src="../figures/webIDE.png" alt="云平台" width="1000px" height="150px">	32	<img src="../figures/webIDE.png" alt="云平台" width="1000px" height="150px">
29		33
	@@ -31,9 +35,8 @@
31		35
32	对于不依赖昇腾设备的开发者，若您想快速搭建编译构建环境，可使用Docker镜像部署。	36	对于不依赖昇腾设备的开发者，若您想快速搭建编译构建环境，可使用Docker镜像部署。
33		37
34	-> 说明：	38	+> [!NOTE]说明
35	-镜像文件比较大，下载需要一定时间，请您耐心等待。关于docker命令的选项介绍可通过`docker --help`查询。	39	+> 镜像文件比较大，下载需要一定时间，请您耐心等待。关于docker命令的选项介绍可通过`docker --help`查询。
36	-<br>环境默认安装9.0.0版本的CANN软件包和固件/驱动包，源码下载时注意与软件配套。
37		40
38	1.安装驱动与固件（运行态依赖）	41	1.安装驱动与固件（运行态依赖）
39		42
	@@ -98,7 +101,7 @@
98	\| `swr.cn-south-1.myhuaweicloud.com/ascendhub/cann:...` \| 指定要运行的Docker镜像。 \| 必选，请确保此镜像名和标签（tag）与你通过`docker pull`拉取的镜像完全一致。 \|	101	\| `swr.cn-south-1.myhuaweicloud.com/ascendhub/cann:...` \| 指定要运行的Docker镜像。 \| 必选，请确保此镜像名和标签（tag）与你通过`docker pull`拉取的镜像完全一致。 \|
99	\| `bash` \| 容器启动后立即执行的命令。 \| 必选 \|	102	\| `bash` \| 容器启动后立即执行的命令。 \| 必选 \|
100		103
101	- > 说明：	104	+ > [!NOTE]说明
102	> - 场景1适用于仅编译构建graph-autofusion的场合，无需NPU设备支持。	105	> - 场景1适用于仅编译构建graph-autofusion的场合，无需NPU设备支持。
103	> - 场景2适用于需要运行样例或进行NPU相关测试的场合，需要宿主机已安装NPU驱动和固件。	106	> - 场景2适用于需要运行样例或进行NPU相关测试的场合，需要宿主机已安装NPU驱动和固件。
104	> - 如果使用其他型号芯片（如Ascend950PR、Atlas A3系列产品），请相应调整 `--device` 参数中的设备名称。	107	> - 如果使用其他型号芯片（如Ascend950PR、Atlas A3系列产品），请相应调整 `--device` 参数中的设备名称。
	@@ -110,10 +113,10 @@
110	curl -fsSL https://raw.gitcode.com/cann/graph-autofusion/raw/master/scripts/init_env.sh \| bash	113	curl -fsSL https://raw.gitcode.com/cann/graph-autofusion/raw/master/scripts/init_env.sh \| bash
111	```	114	```
112		115
113	-> 说明：	116	+> [!NOTE]说明
		117	+>
114	> - 默认进行CANN包和算子包的安装。	118	> - 默认进行CANN包和算子包的安装。
115	-> - 对于其他芯片型号，请使用 `--chip-type` 参数指定对应的型号（如 `950`、`A3` ）。可选参数具体参考[	119	+> - 对于其他芯片型号，请使用 `--chip-type` 参数指定对应的型号（如 `950`、`A3` ）。可选参数具体参考[init_env.sh](../../scripts/init_env.sh)
116	-init_env.sh](../../scripts/init_env.sh)
117		120
118	### 方式三：手动安装软件包	121	### 方式三：手动安装软件包
119		122
	@@ -121,7 +124,7 @@ init_env.sh](../../scripts/init_env.sh)
121		124
122	驱动与固件的下载和安装操作请参考《[CANN软件安装指南](https://www.hiascend.com/document/redirect/CannCommunityInstWizard)》中“准备软件包”和“安装NPU驱动和固件”章节。驱动与固件是运行样例依赖，若仅编译环境，可以不安装。	125	驱动与固件的下载和安装操作请参考《[CANN软件安装指南](https://www.hiascend.com/document/redirect/CannCommunityInstWizard)》中“准备软件包”和“安装NPU驱动和固件”章节。驱动与固件是运行样例依赖，若仅编译环境，可以不安装。
123		126
124	-2. 安装CANN包	127	+2. 安装CANN包
125		128
126	场景1：体验master版本能力或基于master版本进行开发	129	场景1：体验master版本能力或基于master版本进行开发
127		130
	@@ -139,7 +142,7 @@ init_env.sh](../../scripts/init_env.sh)
139	- `${cann_version}`：表示CANN包版本号。	142	- `${cann_version}`：表示CANN包版本号。
140	- `${arch}`：表示CPU架构，如`aarch64`、`x86_64`。	143	- `${arch}`：表示CPU架构，如`aarch64`、`x86_64`。
141	- `${install_path}`：表示指定安装路径，需要与Toolkit包安装在相同路径，root用户默认安装在`/usr/local/Ascend`目录。	144	- `${install_path}`：表示指定安装路径，需要与Toolkit包安装在相同路径，root用户默认安装在`/usr/local/Ascend`目录。
142	-	145	+
143	2. 安装CANN ops算子包。	146	2. 安装CANN ops算子包。
144		147
145	```bash	148	```bash
	@@ -153,4 +156,4 @@ init_env.sh](../../scripts/init_env.sh)
153		156
154	场景2：体验已发布版本能力或基于已发布版本进行开发	157	场景2：体验已发布版本能力或基于已发布版本进行开发
155		158
156	- 如果您想体验官网正式发布的CANN包能力，请访问[CANN官网下载中心](https://www.hiascend.com/cann/download)，选择对应版本CANN软件包（仅支持CANN 8.5.0及后续版本）进行安装。	159	+ 如果您想体验官网正式发布的CANN包能力，请访问[CANN官网下载中心](https://www.hiascend.com/cann/download)，选择对应版本CANN软件包（仅支持CANN 8.5.0及后续版本）进行安装。