CANN/metadef环境部署指南

Environment Deployment

【免费下载链接】metadefAscend Metadata Definition项目地址: https://gitcode.com/cann/metadef

1. Environment Preparation

This project supports source code compilation. Before compiling from source, ensure CANN software (Ascend-cann-toolkit and Ascend-cann-ops (optional)) is installed. If running samples, NPU driver and firmware also need to be installed.

Select software installation method according to the following description:

Method 1: Using WebIDE Installation

For users without an environment, directly use the WebIDE development platform, namely "Operator One-Stop Development Platform". This platform provides an online directly runnable Ascend environment with essential software packages already installed, no manual installation needed. For more platform introduction, refer to LINK.

1. Enter the open source project, click the "Cloud Development" button, and log in with a certified Huawei Cloud account. If not registered or certified, follow page prompts for registration and certification.

2. Follow page prompts to create and start cloud development environment, click "Connect > WebIDE" to enter the operator one-stop development platform. Open source project resources default in/mnt/workspacedirectory.

Method 2: Docker Deployment

For developers not dependent on Ascend devices, if you want to quickly set up compilation build environment, use Docker image deployment.

Note: Image file is relatively large, download takes some time, please wait patiently. For docker command option introduction, query throughdocker --help.

1.Install Driver and Firmware (Runtime Dependency)

For Ascend driver and firmware download and installation on host machine, refer to "CANN Software Installation Guide" sections "Prepare Software Packages" and "Install NPU Driver and Firmware". Driver and firmware are runtime dependencies. If only compiling operators, installation is not required.

2.Download Image

• Step 1: Log in to host machine as root user. Ensure Docker engine is installed on host machine (version 1.11.2 or above).

• Step 2: Pull pre-integrated CANN software package and development-required dependency image from Ascend Image Repository. Commands below, select according to actual architecture (using Atlas A2 series products as example, compilation-only scenario does not need attention):

  # Example: Pull ARM architecture CANN development image docker pull --platform=arm64 swr.cn-south-1.myhuaweicloud.com/ascendhub/cann:9.0.0-beta.1-910-ubuntu22.04-py3.11 # Example: Pull X86 architecture CANN development image docker pull --platform=amd64 swr.cn-south-1.myhuaweicloud.com/ascendhub/cann:9.0.0-beta.1-910-ubuntu22.04-py3.11

3.Run DockerSelect different startup methods according to usage scenario:

• Scenario 1: Compilation Build Only (No Need to Run Samples)

  If only code compilation build is needed, without accessing NPU device, use the following simplified command:

  docker run --name cann_container -it -u root --privileged=true -v /home/metadef/:/home/metadef swr.cn-south-1.myhuaweicloud.com/ascendhub/cann:9.0.0-beta.1-910-ubuntu22.04-py3.11 bash

• Scenario 2: Need to Run Samples (Need to Access NPU Device)

  If running samples or tests is needed, container needs to access host NPU device. Using Atlas A2 series products as example:

docker run --name cann_container \ --device /dev/davinci0 \ --device /dev/davinci_manager \ --device /dev/devmm_svm \ --device /dev/hisi_hdc \ -v /usr/local/dcmi:/usr/local/dcmi \ -v /usr/local/bin/npu-smi:/usr/local/bin/npu-smi \ -v /usr/local/Ascend/driver/lib64/:/usr/local/Ascend/driver/lib64/ \ -v /usr/local/Ascend/driver/version.info:/usr/local/Ascend/driver/version.info \ -v /etc/ascend_install.info:/etc/ascend_install.info \ -it -u root --privileged=true \ swr.cn-south-1.myhuaweicloud.com/ascendhub/cann:9.0.0-beta.1-910-ubuntu22.04-py3.11 bash

Note:

• Scenario 1 is suitable for compilation build only of metadef, without NPU device support

• Scenario 2 is suitable for running samples or performing NPU-related tests, requires host machine already installed NPU driver and firmware
• If using other model chips (such as 950, Atlas A3 series products), please accordingly adjust device names in--deviceparameter

4.Initialize EnvironmentAfter entering container, execute the following commands to initialize environment:

• Scenario 1 (Compilation Build Only):

  curl -fsSL https://raw.gitcode.com/cann/metadef/raw/master/scripts/init_env.sh | bash

• Scenario 2 (Need to Run Samples, using Atlas A2 series products as example):

  curl -fsSL https://raw.gitcode.com/cann/metadef/raw/master/scripts/init_env.sh | bash -s -- --chip-type 910b

Note:

• For other chip models, replace--chip-typeparameter with corresponding model (such as950,A3)

Method 3: Manual Software Package Installation

Scenario 1: Experience Master Version Capabilities or Develop Based on Master Version

Click Download Link, select latest time version, and download corresponding package according to product model and environment architecture. Installation commands below, for more guidance refer to "CANN Software Installation Guide". CANN Toolkit development suite package installation method:

# Ensure installation package has executable permission chmod +x Ascend-cann-toolkit_${cann_version}_linux-${arch}.run # Installation command ./Ascend-cann-toolkit_${cann_version}_linux-${arch}.run --install --install-path=${install_path}

• ${cann_version}: Indicates CANN package version number.
• ${arch}: Indicates CPU architecture, such asaarch64,x86_64.
• ${install_path}: Indicates specified installation path, needs to be installed in same path as toolkit package. Root user default installation in/usr/local/Ascenddirectory.

Scenario 2: Experience Released Version Capabilities or Develop Based on Released Version

If you want to experienceofficially released CANN packagecapabilities, visit CANN Official Download Center, select corresponding version CANN software package (only supports CANN 8.5.0 and subsequent versions) for installation.

【免费下载链接】metadefAscend Metadata Definition项目地址: https://gitcode.com/cann/metadef