# 练习_使用扩展进行并行处理

参考文档: Parallel Processing using Expansions (opens new window)

在这个例子中,我们将通过同一个模板创建多个Kubernetes Job。

# 基本模板扩展

下面是一个 Job 的模板文件:




 












 


apiVersion: batch/v1
kind: Job
metadata:
  name: process-item-$ITEM
  labels:
    jobgroup: jobexample
spec:
  template:
    metadata:
      name: jobexample
      labels:
        jobgroup: jobexample
    spec:
      containers:
      - name: c
        image: busybox
        command: ["sh", "-c", "echo Processing item $ITEM && sleep 5"]
      restartPolicy: Never
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

与 pod template 不同,此处的 job template 并不是一个 Kubernetes API 对象,而仅仅是 Job 对象的 yaml 文件(其中包含一些占位符)。例子文件中的 $ITEM 对 Kubernetes 并没有任何意义,仅仅是一个占位符,必须在使用时用实际数值替换。

在此例子中,容器唯一做的事情就是 echo 一个字符串,并等待一小段时间。在实际使用中,应该是某种有意义的计算,例如渲染视频的某一帧图片,或处理数据库中某些记录。模板中的 $ITEM 占位符可用来指定视频的帧数,或者数据库记录的行数。

此 Job 及其 Pod template 包含标签 jobgroup=jobexample。对系统来说此标签并没有任何特别之处。该标签可以用来方便地操作这一组 Job。Pod 上也包含该标签,以便我们可以使用一条命令即可检查这些 Job 的所有 Pod。在 Job 创建以后,系统将添加更多的标签以区分不同的 Job 创建的 Pod。jobgroup 并不是 Kubernetes 特殊要求的标签,你可以使用任何标签达到此目的。

接下来,下载该模板文件,并将其扩展为多个文件:

# 下载 job-tmpl.yaml
curl -L -s -O https://kuboard.cn/statics/learning/job/job-tmpl.yaml

# 将模板文件扩展为多个文件,并存到一个临时文件夹
mkdir ./jobs
for i in apple banana cherry
do
  cat job-tmpl.yaml | sed "s/\$ITEM/$i/" > ./jobs/job-$i.yaml
done
1
2
3
4
5
6
7
8
9

检查结果:

ls jobs/
1

输出结果如下所示:

job-apple.yaml
job-banana.yaml
job-cherry.yaml
1
2
3

此处,我们使用 sed 将占位符 $ITEM 替换为循环变量的值。你可以使用任意模板语言(jinja2,erb等)或编写一个程序来生成 Job 对象。

接下来,创建这些 Job:

kubectl create -f ./jobs
1

输出结果如下所示:

job.batch/process-item-apple created
job.batch/process-item-banana created
job.batch/process-item-cherry created
1
2
3

执行命令,检查 Pod 的状态:

kubectl get jobs -l jobgroup=jobexample
1

输出结果如下所示:

NAME                  COMPLETIONS   DURATION   AGE
process-item-apple    1/1           14s        20s
process-item-banana   1/1           12s        20s
process-item-cherry   1/1           12s        20s
1
2
3
4

此处,我们使用 -l 选项选择这一组 Job。执行如下命令可查看这组 Job 所有的 Pod:

kubectl get pods -l jobgroup=jobexample
1

输出结果如下所示:

NAME                        READY     STATUS      RESTARTS   AGE
process-item-apple-kixwv    0/1       Completed   0          4m
process-item-banana-wrsf7   0/1       Completed   0          4m
process-item-cherry-dnfu9   0/1       Completed   0          4m
1
2
3
4

目前还不能直接使用一个命令去检查所有 Pod 的输出,但是,可以通过一个循环来检查所有 Pod 的输出:

for p in $(kubectl get pods -l jobgroup=jobexample -o name)
do
  kubectl logs $p
done
1
2
3
4

输出结果如下所示:

Processing item apple
Processing item banana
Processing item cherry
1
2
3

# 多模板参数

在前面的例子中,每一个模板的实例包含一个参数,同时,此参数也被用作标签。然而,标签的主键是受限于 句法和字符集 的。

下面这个例子稍微复杂一些,使用了 jinja2 模板语言来生成 Job 对象。我们将使用 python 脚本将模板转换为一个文件。

首先,创建一个文件 job.yaml.jinja2,其内容如下所示:











 












 




{%- set params = [{ "name": "apple", "url": "http://www.orangepippin.com/apples", },
                  { "name": "banana", "url": "https://en.wikipedia.org/wiki/Banana", },
                  { "name": "raspberry", "url": "https://www.raspberrypi.org/" }]
%}
{%- for p in params %}
{%- set name = p["name"] %}
{%- set url = p["url"] %}
apiVersion: batch/v1
kind: Job
metadata:
  name: jobexample-{{ name }}
  labels:
    jobgroup: jobexample
spec:
  template:
    metadata:
      name: jobexample
      labels:
        jobgroup: jobexample
    spec:
      containers:
      - name: c
        image: busybox
        command: ["sh", "-c", "echo Processing URL {{ url }} && sleep 5"]
      restartPolicy: Never
---
{%- endfor %}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

此模板中,使用 python 字典表(1-4行)为每个 Job 对象定义了参数。然后通过一个循环遍历这些参数,并生成 Job 的 yaml 对象文件。

  • 多个 yaml 对象可以合并到一个 yaml 文件,使用 --- 分隔即可
  • 在运行时,你的环境中需要由 jinja2 包,如果没有,可以通过 pip install --user jinja2 命令安装

执行 python 脚本,以将模板扩展为多个yaml文件:

alias render_template='python -c "from jinja2 import Template; import sys; print(Template(sys.stdin.read()).render());"'
1

输出结果将保存到一个文件中,例如:

cat job.yaml.jinja2 | render_template > jobs.yaml
1

或者直接通过 kubectl 执行,例如:

cat job.yaml.jinja2 | render_template | kubectl apply -f -
1

# 替代方案

如果您有许多的 Job 对象要创建,最终您会发现:

  • 即使使用了标签,管理数量众多的 Job 对象仍然是非常麻烦的事情
  • 一次性创建所有的 Job 对象可能会是您超出 resource quota 的限制,但您又不想等待太长时间以逐个创建 Job 对象
  • 一次性创建数量众多的 Job 对象可能使 Kubernetes apiserver、controller、scheduler 等组件过载

在这些情况下,您可以考虑其他的 job pattern

更新时间: 2019-11-19 22:28:38