功能说明
命令功能
生成鲲鹏自动调优的参数空间和应用程序场景模板的配置。配置生成后可运行“devkit kat train -t task.json -f param.json”开始自动调优。
命令格式
1
|
devkit kat template [-h] [-l {0,1,2,3}] [-g] [-o <dir>] |
参数说明
参数 |
参数选项 |
说明 |
---|---|---|
-h/--help |
- |
获取帮助信息。 |
-l/--log-level |
0/1/2/3 |
设置日志级别,默认为2。
|
-g/--generate |
- |
进入模板配置交互界面,生成对应应用的简易模板文件,仅包含任务必须参数。 |
-c/--convert |
- |
将简易模板文件转换为全参数的通用模板文件。 |
-o/--output |
- |
设置生成的模板文件的输出路径。 |
使用示例
- 生成简易模板:
1
devkit kat template -g -o /opt/template
命令中使用参数“-g”将进入交互界面,用户可选择模板文件需要的基本参数,参数“-o /opt/template”为生成的模板文件存放目录。
- 选择应用。
使用“↑”、“↓”键选择,按“Enter”键选中应用。
图1 选择应用 - 选择应用版本。
按“Enter”键进入版本列表选择需要的版本,按“Esc”键返回上一级目录,按“Space”键切换选中与否。
图2 选择版本 - 选择参数类型。
按“Space”键切换选项前的[Y/N]表示是否启用此项参数;OS选项为系统参数调优,uarch为微架构参数调优。
图3 选择需要配置的参数类型 - 选择应用参数。按“Enter”键进入应用参数配置界面,选择需要启用的参数。图4 选择spark应用参数
- 保存配置,生成简易模板文件。
配置完成后按“S”键保存简易模板文件至指定目录下,如果未指定保存目录,将在命令运行目录下生成名为“kat-template-YMD-HMS”格式的模板文件。
图5 生成简易模板文件 - 退出配置交互界面。
按“Q”键选择退出,再按“Y”键确认退出;将在终端显示模板文件保存目录。
返回信息如下:
1
[2024-12-30 09:46:49 UTC] [KAT] [message] - The path of the saved file is as follows:: ['/home/kat_show/DevKit-CLI-xx.xx.xx-Linux-Kunpeng/template_Spark_20241230_094556']
- 查看简易模板文件。
1
ls /home/kat_show/DevKit-CLI-xx.0.xx-Linux-Kunpeng/template_Spark_20241230_094556
返回信息如下:
1
param_Spark_uarch.json task_Spark_uarch.json
- 查看应用参数文件。
1
vim /home/kat_show/DevKit-CLI-xx.0.xx-Linux-Kunpeng/template_Spark_20241230_094556/param_Spark_OS_uarch.json
param_xxx_xxxx.json文件是交互界面中选择的应用参数。
图6 应用参数文件 - 查看并完善任务参数文件。
1
vim /opt/template/template_spark_20241218_075615/task_Spark_OS_uarch.json
该模板文件中一些任务必须参数值需用户根据实际情况填写,比如环境信息、应用所在服务器、性能测试工具所在服务器及压测指标等,参数详情可查看简易模板参数说明。
图7 任务模板文件 - 保存退出任务参数文件。
完善好基本配置后按“Esc”键,键入“:wq”再按“Enter”键保存退出。
父主题: 生成模板文件