云端任务管理

更新时间：2021-04-21

在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文件，具体操作如单次执行。