云端任务管理
在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 复制
点击"复制",进入【新建云端任务】页面,复制该条任务的所有信息,可以修改。