编译任务

创建编译任务

1. 在左侧菜单栏中单击“训练服务 > 编译管理”。
2. 选择“编译任务”页签，单击“新建编译任务”，填写基本信息。
   图1 新建编译任务
   
   • 名称：任务组名称，只能包含数字、英文、中文、下划线、中划线，不得超过32个字符。
   • 描述：简要描述任务信息。不得包含＂@#$%^&*< > \＂，不得超过256个字符。
   • 资源规格：当前项目中可用的资源规格，资源规格需要平台管理员在纳管模型编译用途的任务作业集群后创建。
   • 优先级：设定任务的优先级，数值取[-50,50]的整数，数字越大，优先级越高。

3. 选择镜像。
   图2 选择镜像
   
   • 编译镜像：需提前在＂编译镜像＂中创建成功，编译镜像创建请参考创建编译镜像。
   • 环境变量：由编译镜像携带，参数不支持修改。
   

   • Key：只能由英文、数字、和特殊符号（,-_）组成，且需要以字母开头 。长度不超过64个字符。
   • Value： 只能由英文、数字和特殊符号（\/,.[]-_）组成 。长度不超过512个字符。

4. 选择待编译模型版本。
   图3 选择待编译模型版本
   

   模型可以为训练任务产生的模型版本或者通过本地模型文件上传产生的模型版本。

5. 以上信息填写无误，单击＂创建＂。编译任务创建成功。

编译任务相关操作

在“编译任务”列表，可对任务进行以下操作。

编译任务相关操作与任务所处状态约束关系请见下表：

编译任务日志查看下载

编译任务运行过程中生成日志，编译任务模块提供了日志的查看以及下载功能，支持用户查看编译任务的运行情况。编译任务生成的日志文件有以下四种：

• train-{id}-{index}.log：用户实际训练任务的训练日志。
• train-{id}-{index}-init.log：Octopus平台提供的前置数据的准备日志。
• train-{id}-{index}-sidecar.log：Octopus平台提供的任务流程控制日志，包括日志同步、结果上传。
• octopus-train-{id}-{index}-supplemental.logs: Octopus平台任务异常退出或停止产生的错误信息输出日志，运行正常时不产生该日志。

在该编译任务的详情页面，单击“任务日志”，可查看该编译任务日志详情。支持下载至本地。如果日志较多，用户可在搜索框中输入关键字，查找指定日志内容。

如图，在日志服务页面中的日志列表部分详细展示了该编译任务包含的日志文件的大小以及最近写入时间。单击文件后的“查看”，该文件的详细执行过程则在日志详情部分展示。用户也可在日志文件后的“操作”栏中，单击“下载”，即可将该日志文件下载到本地查看。

图4 任务日志

资源占用情况

在任务运行中，资源占用情况模块显示任务占用的CPU、内存百分比的折线图。默认显示CPU占用情况折线图。

图5 资源占用情况

• 双击任一图例：显示全部资源占用折线图。
• 单击指定图例：只显示该图例折线图。

此模块也可显示多个计算节点运行任务时，资源占用的情况。

• 如果选择2个计算节点运行任务，则可选择查看单个节点资源占用情况。

资源占用情况功能模块，需要用户在制作自定义镜像时安装psutil与pynvml，参考命令如下：

pip install psutil pynvml

如果未安装psutil与pynvml，则页面无法显示资源使用状况。