云端任务管理

在CodeLab云端任务管理中，您可以新建云端任务、对云端已有任务进行管理和操作。

1 新建云端任务

当无云端资源时，无法创建云端任务。点击"资源管理"，跳转到资源管理，进行资源的获取绑定。

绑定资源后，您可以新建云端任务。

点击"新建云端任务"，创建新的云端任务。

在【新建云端任务】页，填写任务基本信息、运行配置和资源配置。

1.1 基本信息

名称最长不超过30个字符，可以包含英文大小写、数字、下划线、中划线，支持中文。

1.2 运行配置

• 云端存储：默认显示免费存储资源。
• 云端文件版本：

  "云端文件版本"提供了文件级的版本控制。当用户对本地环境、文件做了改变，提云端任务时，就需要用到提交版本功能。

    用户在云端目录下点击"本地推送到云端"按钮。

    选择需要上传的文件点击"提交"，弹窗中将显示修改的文件，不同文件颜色代表不同含义，如标绿文件为新建文件，红色文件为已删除文件，蓝色文件为已修改文件。上传时没有文件数目限制。

  CodeLab会自动将目录中的文件、用户安装的python包（仅限于user-site中安装的包）纳入版本控制。CodeLab会自动分析python包之间的依赖，对比当前环境和版本中的记录，并进行正确的合并和更新；如果出现不可自动处理的冲突，将会转入人工阶段，要求用户手动处理。

  云端文件默认显示最新版本。可以下拉选择其他版本，选择后将显示该版本的详细信息。

• 支持三种执行方式：单次执行、API调度和周期调度，满足您的不同调度需求。

  A. 单次执行

  选中单次执行后，任务仅运行一次；

    启动方式默认显示shell命令，在单文本输入框填写shell命令。

    启动方式切换为notebook文件时，需要填写文件路径。右击需要运行的文件，点击"复制路径"，进行路径粘贴。

  B. API调度

    对于云端任务，用户可以通过API调度执行BML CodeLab里创建的任务。启动方式也分为shell命令和notebook文件，具体操作如单次执行。

  C. 周期调度

    支持使用crontab表达式设置任务执行的周期。crontab表达式是由空格或tab分隔的时间元素。从左往右按顺序依次为 ：

分（0~59） 
时（0~23）
日（1~31，需要考虑当月的天数）
月（1~12）
星期（0~6 0=SUN，MON，TUE，WED，THU，FRI，SAT）

    每个元素可以是一个值(如6)，一个连续区间(9-12)，一个间隔时间(8-18/4),一个列表(1,3,5),通配符。

星号（ * ）：代表所有可能的值。当月字段为星号时，则表示在满足其它字段的制约条件后每月都执行该命令。

正斜线（ / ）：可以用正斜线指定时间的间隔频率，例如“0-23/2”表示每两小时执行一次。

问号（ ？）：仅被用于月和星期两个字段，表示不指定值。当两个子表达式其中之一被指定后，为了避免冲突，需要将另一个子表达式的值设为“？”。

逗号（ ，）：可以用逗号隔开的值指定一个列表范围，例如，“1,2,5,7,8,9”。

中杠（ - ）：可以用整数之间的中杠表示一个整数范围，例如“2-6”表示“2,3,4,5,6”。

    实例1：每小时的第3和第15分钟执行

    3,15 * * * *

    实例2：每隔两天的上午8点到11点的第3和第15分钟执行

    3,15 8-11 */2 * *

    任务创建后，将按照预定的周期，自动执行。启动方式也分为shell命令和notebook文件，具体操作如单次执行。

1.3 资源配置

运行资源默认显示免费资源，点击下拉，可以切换资源。

在下拉列表，点击"获取资源"，跳转到资源管理页，进行资源的获取绑定。

绑定后，点击"刷新"，下拉列表将显示新绑定的资源。

1.4 提交

点击"提交"按钮，检测表单是否有问题。

• 若有问题，显示错误提示。如下图红色错误提示，提示用户填写必填信息。

• 若无问题，跳转至【任务管理】页，新增一条任务，且提示"作业创建成功"。

2 云端已有任务的管理和操作

云端任务列表页显示已经创建过的云端任务，列表数据分为“名称”、“状态”、“运行方式”、“启动方式”、“运行资源”、"创建时间、"备注"以及“操作”八列：

2.1 名称

任务名称可以在线编辑，点击某一任务右侧的编辑按钮，允许行内编辑或取消。

2.2 状态

API调度或周期调度的任务：启用状态下，可以对任务进行多次调度；禁用状态下，任务不能调度。

2.3 运行方式

展示您新建云端任务时配置的运行方式。API调度会显示具体API，可以复制，点击右侧复制按钮后，提示"复制成功"。

注：启动器里拉取CPU镜像，用户在创建API调度任务时产生的API命令，在BML CodeLab里不能运行，需要在BML CodeLab外运行。

Windows系统需要在Postman里运行。Postman下载地址：https://www.postman.com/downloads/

Mac系统可以直接在终端里运行命令。

2.4 启动方式

展示您配置的启动方式。点击版本号，弹窗查看当前版本修改内容。如下图显示V15版本新建了一个文件夹。

2.5 运行资源

运行资源字段显示资源名称。点击按钮，显示资源规格。

2.6 创建时间

表示创建任务的时间。

2.7 备注

显示您创建任务时的备注。

2.8 操作

表示可以对任务进行的操作。

API调度或周期调度的任务：支持运行记录、禁用/启用和复制。单次执行的任务：支持运行记录和复制。

2.8.1 运行记录

点击"运行记录"，跳转至【任务运行记录】页面。

任务运行记录列表显示任务"运行名称"、"状态"、"启动时间"、"结束时间"、"返回码"和"操作"。

• 状态分为排队中、运行中、成功、失败和已终止。
• 操作分为详情、日志和终止。

  点击"详情"，查看任务运行的详情信息。

  点击"日志"，跳转到【运行日志】页面，预览或下载日志。

  运行和排队中的任务可以终止，点击"终止"，需要二次确认。

2.8.2 禁用/启用

点击"禁用/启用"，需要二次确认。

2.8.3 复制

点击"复制"，进入【新建云端任务】页面，复制该条任务的所有信息，可以修改。