已开启
docs: include the RAS suffix in custom package activation paths #134
docs: include the RAS suffix in custom package activation paths #134
已开启
tianjun创建于 17 天前
tianjun
17 天前

描述

中英文 docs/*/install/compile.md 指导 source ${install_path}/vendors/${vendor_name}/bin/set_env.bash,但 cmake/variables.cmake 将 VENDOR_PACKAGE_NAME 设置为 ${VENDOR_NAME}_ras,cmake/package.cmake 把这个名字传给 npu_op_package 的 VENDOR_NAME。实际 vendor 目录带 _ras;同页卸载路径也已带该后缀。按激活说明会找不到脚本,ASCEND_CUSTOM_OPP_PATH 未配置。

将中英文激活命令中的 vendor 目录统一改为 ${vendor_name}_ras,保留原有安装根目录约定。

关联的Issue

Fixes #62

测试

对照实际 variables.cmake 的 VENDOR_PACKAGE_NAME、全部自定义安装目录和 pack_custom() 的 VENDOR_NAME 参数,确认统一为 *_ras。Host 临时目录按该布局创建示例 set_env.bash,原文 source 路径退出1(No such file),修复路径退出0并设置环境变量。仅模拟文件布局和激活命令,没有构建或安装算子包,未使用NPU。git diff --check 通过。 仓库适用 pre-commit hooks 与 diff --check 通过。

本地无 NPU,未执行设备测试;提交后评论 /compile。

文档更新

  • docs/zh/install/compile.md
  • docs/en/install/compile.md

类型标签

likedislike
合并受阻
Ttianjun
17 天前 创建了 pull request,commit 2b112413
Ttianjun
17 天前 关联了issue:[Documentation|文档反馈] 自定义包环境激活路径缺少真实 vendor 目录的 _ras 后缀
atomgit-bot
atomgit-bot
17 天前 评论:

变更摘要

本次变更属于文档修正,目的是让中英文安装编译文档中的自定义算子包激活命令与实际产物目录保持一致。文档指导执行的 source ${install_path}/vendors/${vendor_name}/bin/set_env.bash 路径缺少 _ras 后缀,而 cmake/variables.cmake 中的 VENDOR_PACKAGE_NAME 被设为 ${VENDOR_NAME}_ras,并经 cmake/package.cmake 传给 npu_op_package 的 VENDOR_NAME,因此实际 vendor 目录带 _ras 后缀,按原文执行会找不到脚本、导致 ASCEND_CUSTOM_OPP_PATH 未被配置。此改动将激活命令中的 vendor 目录统一改为 ${vendor_name}_ras,同时保留原有安装根目录约定。

主要改动

  • 中文文档激活路径修正: 在 docs/zh/install/compile.md 中将 source 激活命令的 vendor 目录由 ${vendor_name} 改为 ${vendor_name}_ras,使其指向真实存在的 set_env.bash。
  • 英文文档激活路径修正: 在 docs/en/install/compile.md 中做同样修改,使英文指引的激活命令与 _ras 后缀目录保持一致。
  • 与配置及卸载路径对齐: 修改后激活路径与 VENDOR_PACKAGE_NAME/VENDOR_NAME 的 _ras 后缀以及同页已带后缀的卸载路径统一,保证激活时能正确设置 ASCEND_CUSTOM_OPP_PATH。
  • 安装根目录约定保持不变: 仅调整 vendor 目录名后缀,${install_path} 等安装根目录约定维持原样。
likedislike
不准确?
atomgit-bot
atomgit-bot
17 天前 评论:

🤖 本次改动均为数据 / 生成 / 二进制文件(如测试用例、锁文件、媒体资源),没有可审查的代码逻辑,已跳过 AI 代码审查。

likedislike
不准确?
CANN-robotCANN-robot成员
17 天前 添加了label:cann-cla/yes
CANN-robot
CANN-robot成员
17 天前 评论:

Thanks for your pull-request.
The full list of commands accepted by me can be found at here.
You can get sig-info at here.
You can self-configure the PR merge rules for this repository. For more details, please refer to Here.
For more, you also can visit HICANN.


PR Approval Progress

⚠️ This PR does not yet meet the following requirements:lgtm (requires ≥ 2 person(s) per module)、approve (requires ≥ 1 person(s) per module)

Module Approval Details

module lgtm status approve status
repo-cann/ops-ras ❌ (0/2)(You can also ask: 冯彤, 徐鲁威, 陈兴宇, yue-ma, 唐燕峰) ❌ (0/1)(You can also ask: 陈兴宇, 王林木, 徐鲁威, 冯彤, 於欣洁)

💡 Tip:

  • Committer can comment /approve or /lgtm
  • Commenting /approve implies both code review (lgtm) and intent to merge (approve)
likedislike
CANN-robot
CANN-robot成员
17 天前 评论:

CLA Signature Pass

Ethan_Zou, thanks for your pull request. All authors of the commits have signed the CLA. 👍

likedislike
tianjun
17 天前 评论:

/compile

likedislike
CANN-robotCANN-robot成员
17 天前 添加了label:ci-pipeline-running
CANN-robot
CANN-robot成员
17 天前 评论:

流水线任务触发成功
任务链接 [5642160f0af047618cdf367ab1812383][流水线指导]

任务名称状态日志下载链接
PreSmoke_ATK_Test_A2 ✅ SUCCESS >>>>>

[2026-10-02 13:32:49]    CI执行结束

likedislike
CANN-robot
CANN-robot成员
17 天前 评论:

流水线任务触发成功
任务链接 [d42b7ed7a3f44351a2c8a28e47bb50e3][流水线指导]

任务名称状态日志下载链接
Compile_Ascend_X86 ✅ SUCCESS >>>>> >>>>>
Compile_Ascend_X86_mobile_station ✅ SUCCESS >>>>> >>>>>
Compile_Ascend_ARM ✅ SUCCESS >>>>> >>>>>
Compile_Ascend_single ✅ SUCCESS >>>>> >>>>>
pre_comment ✅ SUCCESS >>>>>
Compile_Ascend_X86_ubuntu24 ✅ SUCCESS >>>>> >>>>>
Compile_Ascend_X86_mobile_station_ubuntu24 ✅ SUCCESS >>>>> >>>>>
Compile_Ascend_ARM_ubuntu24 ✅ SUCCESS >>>>> >>>>>
Compile_Ascend_single_ubuntu24 ✅ SUCCESS >>>>> >>>>>
UT_Test_ophost ✅ SUCCESS
UT_Test_opapi ✅ SUCCESS
API_Check ✅ SUCCESS >>>>>

[2026-10-02 13:36:52]    CI执行结束

likedislike
CANN-robotCANN-robot成员
17 天前 添加了label:api-check-pass
CANN-robotCANN-robot成员
17 天前 删除了label:api-check-pass
CANN-robot
CANN-robot成员
17 天前 评论:

流水线任务触发成功
任务链接 [9796d83b5ebb4c1188719b1183328d65][流水线指导]

任务名称状态日志下载链接
codecheck ✅ SUCCESS >>>>>
SCA ✅ SUCCESS >>>>>
antipoison ✅ SUCCESS >>>>>
codecheck_Pr ✅ SUCCESS
codecheck_codestyle ✅ SUCCESS >>>>>
codecheck_precommit ✅ SUCCESS >>>>>

[2026-10-02 13:40:12]    CI执行结束

likedislike
CANN-robotCANN-robot成员
17 天前 删除了label:ci-pipeline-running
CANN-robotCANN-robot成员
17 天前 添加了label:ci-pipeline-passed
tianjun
10 天前 评论:

compile

likedislike
CANN-robotCANN-robot成员
10 天前 删除了label:ci-pipeline-passed
CANN-robotCANN-robot成员
10 天前 添加了label:ci-pipeline-running
CANN-robot
CANN-robot成员
10 天前 评论:

流水线任务触发成功
任务链接 [4ae421b04bd8447eaae1b406c700f54e][流水线指导]

任务名称状态日志下载链接
PreSmoke_ATK_Test_A2 ✅ SUCCESS >>>>>

[2026-10-10 00:42:34]    CI执行结束

likedislike
CANN-robot
CANN-robot成员
10 天前 评论:

流水线任务触发成功
任务链接 [946e751e2dda4de283caa606c5b21c35][流水线指导]

任务名称状态日志下载链接
Compile_Ascend_X86 ✅ SUCCESS >>>>> >>>>>
Compile_Ascend_X86_mobile_station ✅ SUCCESS >>>>> >>>>>
Compile_Ascend_ARM ✅ SUCCESS >>>>> >>>>>
Compile_Ascend_single ✅ SUCCESS >>>>> >>>>>
pre_comment ✅ SUCCESS >>>>>
Compile_Ascend_X86_ubuntu24 ✅ SUCCESS >>>>> >>>>>
Compile_Ascend_X86_mobile_station_ubuntu24 ✅ SUCCESS >>>>> >>>>>
Compile_Ascend_ARM_ubuntu24 ✅ SUCCESS >>>>> >>>>>
Compile_Ascend_single_ubuntu24 ✅ SUCCESS >>>>> >>>>>
UT_Test_ophost ✅ SUCCESS
UT_Test_opapi ✅ SUCCESS
API_Check ✅ SUCCESS >>>>>

[2026-10-10 00:44:26]    CI执行结束

likedislike
CANN-robot
CANN-robot成员
10 天前 评论:

流水线任务触发成功
任务链接 [ba289fcbf1474950b89a5c3779a9c21e][流水线指导]

任务名称状态日志下载链接
codecheck ✅ SUCCESS >>>>>
SCA ✅ SUCCESS >>>>>
antipoison ✅ SUCCESS >>>>>
codecheck_Pr ✅ SUCCESS
codecheck_codestyle ✅ SUCCESS >>>>>
codecheck_precommit ✅ SUCCESS >>>>>

[2026-10-10 00:44:15]    CI执行结束

likedislike
CANN-robotCANN-robot成员
10 天前 添加了label:api-check-pass
CANN-robotCANN-robot成员
10 天前 删除了label:ci-pipeline-running
CANN-robotCANN-robot成员
10 天前 添加了label:ci-pipeline-passed