CANN/ops-solver环境部署指南
环境部署【免费下载链接】ops-solver本项目是CANN提供的高级数值求解算子库实现矩阵分解、求逆、特征值求解等功能在NPU上的加速计算。项目地址: https://gitcode.com/cann/ops-solver您在学习QuickStart或各类教程操作之前请先参考下面步骤完成基础环境搭建确保已安装NPU驱动、固件和CANN软件Ascend-cann-toolkit和Ascend-cann-ops等。环境安装本项目提供多种搭建昇腾环境的方式请按需选择。说明本文提到的编译态和运行态含义如下请根据实际情况选择。编译态针对仅编译本项目不运行的场景只需安装CANN toolkit包。运行态针对运行本项目的场景编译运行或纯运行需安装驱动与固件、CANN toolkit包、CANN ops包。安装方式使用说明使用场景WebIDE一站式开发平台提供在线直接运行的昇腾环境无需手动安装。当前可提供单机算力默认安装最新商发版CANN包。适用于没有昇腾设备的开发者。DockerDocker镜像是一种高效部署方式已预集成CANN包和必备依赖。当前仅适用于Atlas A2系列产品OS仅支持Ubuntu操作系统。默认安装最新商发版CANN包。适用有昇腾设备需要快速搭建环境的开发者。手动安装-适用有昇腾设备想体验手动安装CANN包或体验最新master分支能力的开发者。方式1WebIDE环境对于无昇腾设备的开发者可直接使用WebIDE开发平台即“一站式开发平台”该平台为您提供在线可直接运行的昇腾环境环境中已安装必备的驱动固件、软件包和依赖无需手动安装。说明环境默认安装最新商发版CANN包源码下载时注意与软件配套。更多关于开发平台的介绍请参考WebIDE指导。进入开源项目单击“云开发”按钮使用已认证过的华为云账号登录。若未注册或认证请根据页面提示进行注册和认证。根据页面提示创建NPU环境并配置规格启动云开发环境后单击“连接 WebIDE”进入一站式开发平台。当前开源项目资源默认在/mnt/workspace/gitCode/${gitCode_id}目录下${gitCode_id}表示开发者个人gitCode账号。方式2Docker部署对于有昇腾设备的开发者若您想快速搭建昇腾环境可使用Docker镜像部署。说明镜像文件比较大下载需要一定时间请您耐心等待。关于docker命令的选项介绍可通过docker --help查询。环境默认安装最新商发版CANN包源码下载时注意与软件配套。1.安装驱动与固件运行态依赖宿主机上昇腾驱动与固件的下载和安装操作请参考《CANN软件安装指南》中“准备软件包”和“安装NPU驱动和固件”章节。驱动与固件是运行态依赖若仅编译算子可以不安装。2.下载镜像步骤1以root用户登录宿主机。确保宿主机已安装Docker引擎版本1.11.2及以上。步骤2从昇腾镜像仓库拉取已预集成CANN软件包及ops-solver所需依赖的镜像。命令如下根据实际架构选择# 示例拉取ARM架构的CANN开发镜像 docker pull --platformarm64 swr.cn-south-1.myhuaweicloud.com/ascendhub/cann:8.5.0-910b-ubuntu22.04-py3.10-ops # 示例拉取X86架构的CANN开发镜像 docker pull --platformamd64 swr.cn-south-1.myhuaweicloud.com/ascendhub/cann:8.5.0-910b-ubuntu22.04-py3.10-ops3.运行Docker拉取镜像后需要以特定参数启动容器以便容器内能访问宿主的昇腾设备。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 swr.cn-south-1.myhuaweicloud.com/ascendhub/cann:8.5.0-910b-ubuntu22.04-py3.10-ops bash参数说明注意事项--name cann_container为容器指定名称便于管理。可自定义。--device /dev/davinci0核心将宿主机的NPU设备卡映射到容器内可指定映射多张NPU设备卡。必须根据实际情况调整davinci0对应系统中的第0张NPU卡。请先在宿主机执行npu-smi info命令根据输出显示的设备号如NPU 0,NPU 1来修改此编号。--device /dev/davinci_manager映射NPU设备管理接口。---device /dev/devmm_svm映射设备内存管理接口。---device /dev/hisi_hdc映射主机与设备间的通信接口。--v /usr/local/dcmi:/usr/local/dcmi挂载设备容器管理接口DCMI相关工具和库。--v /usr/local/bin/npu-smi:/usr/local/bin/npu-smi挂载npu-smi工具。使容器内可以直接运行此命令来查询NPU状态和性能信息。-v /usr/local/Ascend/driver/lib64/:/usr/local/Ascend/driver/lib64/关键挂载将宿主机的NPU驱动库映射到容器内。--v /usr/local/Ascend/driver/version.info:/usr/local/Ascend/driver/version.info挂载驱动版本信息文件。--v /etc/ascend_install.info:/etc/ascend_install.info挂载CANN软件安装信息文件。--it-i交互式和-t分配伪终端的组合参数。-swr.cn-south-1.myhuaweicloud.com/ascendhub/cann:8.5.0-910b-ubuntu22.04-py3.10-ops指定要运行的Docker镜像。请确保此镜像名和标签tag与你通过docker pull拉取的镜像完全一致。bash容器启动后立即执行的命令。-方式3手动安装对于有昇腾设备的开发者若您想手动搭建昇腾环境请参考下述步骤。前置依赖请先确保编译环境的基础库依赖已安装注意满足版本号要求。python 3.7.0建议版本 3.10gcc 7.3.0cmake 3.16.0pigz可选安装后可提升打包速度建议版本 2.4dos2unixgawkmakepatchgoogletest仅执行UT时依赖建议版本 release-1.11.0上述依赖可通过项目根目录install_deps.sh一键安装命令如下若遇到不支持系统请参考该文件自行适配。bash install_deps.sh安装完上述依赖后可通过项目根目录requirements.txt继续安装python三方库依赖命令如下。pip3 install -r requirements.txt软件安装场景1体验master版本能力或基于master版本进行开发安装驱动与固件运行态依赖下载和安装操作请参考《CANN软件安装指南》中“准备软件包”和“安装NPU驱动和固件”章节。驱动与固件是运行态依赖若仅编译算子可以不安装。安装CANN包请单击下载链接选择最新时间版本并根据产品型号和环境架构下载对应包。安装命令如下更多指导参考《CANN软件安装指南》。安装CANN toolkit包# 确保安装包具有可执行权限 chmod x Ascend-cann-toolkit_${cann_version}_linux-${arch}.run # 安装命令 ./Ascend-cann-toolkit_${cann_version}_linux-${arch}.run --install --install-path${install_path}安装CANN ops包运行态依赖ops包是运行态依赖若仅编译算子可不安装此包。# 确保安装包具有可执行权限 chmod x Ascend-cann-${soc_name}-ops_${cann_version}_linux-${arch}.run # 安装命令 ./Ascend-cann-${soc_name}-ops_${cann_version}_linux-${arch}.run --install --install-path${install_path}${cann_version}表示CANN包版本号。${arch}表示CPU架构如aarch64、x86_64。${soc_name}表示NPU型号名称。${install_path}表示指定安装路径ops包需与toolkit包安装在相同路径root用户默认安装在/usr/local/Ascend目录。场景2体验已发布版本能力或基于已发布版本进行开发请访问CANN官网下载中心选择发布版本仅支持CANN 8.5.0及后续版本并根据产品型号和环境架构下载对应包最后参考网页提供的命令完成安装。环境验证安装完CANN包后需验证环境和驱动是否正常。检查NPU设备# 运行npu-smi若能正常显示设备信息则驱动正常 npu-smi info检查CANN版本# 查看CANN toolkit包版本信息默认路径安装WebIDE场景下将/usr/local替换为/home/developer cat /usr/local/Ascend/cann/${arch}-linux/ascend_toolkit_install.info # 查看CANN ops包版本信息默认路径安装WebIDE场景下将/usr/local替换为/home/developer cat /usr/local/Ascend/cann/${arch}-linux/ascend_ops_install.info环境变量配置按需选择合适的命令使环境变量生效。# 默认路径安装以root用户为例非root用户将/usr/local替换为${HOME} source /usr/local/Ascend/cann/set_env.sh # 指定路径安装 # source ${install_path}/cann/set_env.sh源码下载通过如下命令下载项目源码${tag_version}请替换为版本分支标签名源码版本与CANN版本配套关系参见release仓库。# 下载项目对应分支源码 git clone -b ${tag_version} https://gitcode.com/cann/ops-solver.git对于WebIDE或Docker环境已默认提供最新商发版本的项目源码如需获取其他版本的源码也需通过上述命令下载源码。[!NOTE] 注意gitcode平台在使用HTTPS协议的时候要配置并使用个人访问令牌代替登录密码进行克隆推送等操作。若您的编译环境无法访问网络无法通过git指令下载代码请先在联网环境中下载源码再手动上传至目标环境。【免费下载链接】ops-solver本项目是CANN提供的高级数值求解算子库实现矩阵分解、求逆、特征值求解等功能在NPU上的加速计算。项目地址: https://gitcode.com/cann/ops-solver创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考