多任务支持

bcs sub --file job.cfg    # 文件名可以随意定

1. 单个任务支持

job.cfg 内容：

[taskname]
cmd=python test.py
job_name=demo
cluster=img=img-ubuntu:type=ecs.sn1.medium
description=test job
nodes=1
pack=./src/
read_mount=oss://bucket/input/:/home/input/
write_mount=oss://bucket/output/:/home/output/

• 这个配置文件含有一个section: [taskname], 这个taskname将作为task名提交。

• 除了cmd 和 job_name 外,其他的选项, 都是通过 bcs sub -h 看到的长选项名称, 等同于使用命令—${option}。

2. 多任务支持

job.cfg 内容：

[DEFAULT]
job_name=log-count
description=demo
force=True
deps=split->count;count->merge
#下面是任务公共配置
env=public_key:value,key2:value2
read_mount=oss://bucket/input/:/home/input/
write_mount=oss://bucket/output/:/home/output/
pack=./src/

[split]
cmd=python split.py
cluster=img=img-ubuntu:type=ecs.sn1.medium
nodes=1

[count]
cmd=python count.py
cluster=img=img-ubuntu:type=ecs.sn1.medium
nodes=3

[merge]
cmd=python merge.py
cluster=img=img-ubuntu:type=ecs.sn1.medium
nodes=1

• [DEFAULT] section中指定job级别的配置, 其他section指定task配置, 其他section名为task名

• 配置项优先级：直接在命令行中的—${option}; 优先级最高,其次task section中指定的,最后是DEFAULT section中指定的。

• env, read_mount, write_mount, mount 这4个配置项, 可merge, 其他配置项遇到高优先级直接被覆盖

• deps=split->count;count->merge 指定依赖， split任务运行完成后，再运行count，count运行完成后，再运行merge.

• cluster配置用的img和type，不同region支持是不一样的，请根据当前region具体情况设置。

(1) 关于deps

如果DAG如下：

则deps配置：

deps=split->count1,count2;count1->merge;count2->merge

每个dep是一对多的形式： task1->task2,taks3

多个task之间用逗号隔开，多个dep用分号隔开。

(2) 关于 pack

./src/
   |-- split.py
   |-- ...

• 如果指定目录：pack=./src/， 则打包src下面的所有文件到 worker.tar.gz, 指定cmd时，需要从 ./src/目录下开始指定，如：cmd=python split.py

• 如果指定文件：pack=./src/split.py, 则只打包文件到worker.tar.gz, 指定cmd时，只需要指定文件名, 如：cmd=python split.py

• pack可以在[DEFAULT]这个section中配置，也可以在每个task中配置, 当然也可以在命令行中指定。

(3) 关于 mount

read_mount 为只读挂载，将OSS目录挂载到运行程序的虚拟机的文件系统中，linux可以挂载为一个目录，window下只能挂载为一个Driver，如：”E:”。

如果挂载多个，可以使用英文逗号隔开，如：read_mount=oss://bucket/input/:/home/input/,oss://bucket/input2/:/home/input2/。write_mount和mount也是如此。

write_mount 为可写挂载，将OSS目录映射到运行程序的虚拟机的目录，只能映射为一个目录，如果这个目录不存在，需要程序创建一下。写入到这个目录的所有文件将会被上传到相应的OSS目录。

mount可以用于 NAS 的挂载，比如：

mount=nas://xxxxxx-yyy50.cn-shenzhen.nas.aliyuncs.com:/:/home/mnt/:true
vpc_id=vpc-xxxxxxxxxxyyyyyy
vpc_cidr_block=192.168.0.0/16

这里mount信息中的 true/false 指的是是否支持可写。

(4) 关于cluster

有2种格式：

AutoCluster格式：

cluster=img=<img-id>:type=<instance-type>

AutoCluster指定任务运行时会自动创建相应配置的集群，运行完成后自动释放掉。

Cluster格式：

cluster=<cluster-id>

运行：bcs c 可以查看我的集群，如果没有，可以自行创建。

如：

bcs cc <cluster-name> -i <img-id> -t <instance-type> -n 3

• -n 3 表示期望启动3台虚拟机来运行程序

• -i img-id 指定image ID

• -t instance-type 指定实例类型，可以使用 bcs it 查看可用的实例类型

• 其他选项可以使用 bcs cc -h 查看说明。

使用集群可以大大缩短作业启动时间，但是由于集群是一直运行着的，会一直计费，请自行权衡。

(5) 关于docker

格式如：

docker=myubuntu@oss://bucket/dockers/

• 使用docker，需要支持docker的ImageId才能运行成功。如果你没有指定cluster，默认的imageId是支持Docker的，或者你显式指定也行，或者使用clusterId，但是这个cluster的ImageId也要支持docker才行。

• 这里的myubuntu全名为：localhost:5000/myubuntu，制作docker镜像的时候，前缀必须为localhost:5000/， 因此这里可以省略掉前缀。后面的OSS目录，是OSS私有docker镜像仓库目录，详情请看如何使用docker。

(6) 关于nodes

nodes 表示指定使用多少台虚拟机运行任务程序。

(7) 关于force

force 为 True，表示如果某台虚拟机运行程序出错，整个作业不会失败，继续运行。为False，则整个作业失败。默认为False。