一个 job 将建立一个或多个pods,而后确保指定数量的pod运行到结束。当pods成功完成,该 job 跟踪到成功运行的状态。当指定的数量到达时,该 job 自身就算完成了。删除 Job 将会清除所建立的 pods。node
一个简单的案例,建立 Job object 而后运行一个Pod到完成。该Job object在第一个pod失败或者被删除时,将会建立一个新的 Pod。react
Job 能够并行地运行多个pods。git
Kubernetes jobs:使用队列进行并行化处理。固定的处理器,避免资源峰值。github
Ubuntu上使用sshpass远程脚本免密安全交互,能够远程提交任务到集群。 shell
Linux执行按期任务命令-Cron和CronTab,关于按期任务的格式详细例子。 json
这是Job配置的例子。将计算 π to 2000 places,而后打印出来。大概十秒钟能够完成。api
controllers/job.yaml |
---|
apiVersion: batch/v1 kind: Job metadata: name: pi spec: template: spec: containers: - name: pi image: perl command: ["perl", "-Mbignum=bpi", "-wle", "print bpi(2000)"] restartPolicy: Never backoffLimit: 4 |
运行这个文件,执行命令:安全
$ kubectl create -f https://k8s.io/examples/controllers/job.yaml
job "pi" created
检查job的状态和命令的输出:app
$ kubectl describe jobs/pi Name: pi Namespace: default Selector: controller-uid=b1db589a-2c8d-11e6-b324-0209dc45a495 Labels: controller-uid=b1db589a-2c8d-11e6-b324-0209dc45a495 job-name=pi Annotations: <none> Parallelism: 1 Completions: 1 Start Time: Tue, 07 Jun 2016 10:56:16 +0200 Pods Statuses: 0 Running / 1 Succeeded / 0 Failed Pod Template: Labels: controller-uid=b1db589a-2c8d-11e6-b324-0209dc45a495 job-name=pi Containers: pi: Image: perl Port: Command: perl -Mbignum=bpi -wle print bpi(2000) Environment: <none> Mounts: <none> Volumes: <none> Events: FirstSeen LastSeen Count From SubobjectPath Type Reason Message --------- -------- ----- ---- ------------- -------- ------ ------- 1m 1m 1 {job-controller } Normal SuccessfulCreate Created pod: pi-dtn4q
查看完成job的pods,使用命令 kubectl get pods
.
列出属于该job的全部pods,以下:
$ pods=$(kubectl get pods --selector=job-name=pi --output=jsonpath={.items..metadata.name}) $ echo $pods pi-aiw0a
这里的 selector 与 job的selector相同。这里 --output=jsonpath
选项指明获取名称的表达式。
查看 pods的输出:
$ kubectl logs $pods 3.1415926535897932384626433832795028841971693993751058209749445923078164062862089986280348253421170679821480865132823066470938446095505822317253594081284811174502841027019385211055596446229489549303819644288109756659334461284756482337867831652712019091456485669234603486104543266482133936072602491412737245870066063155881748815209209628292540917153643678925903600113305305488204665213841469519415116094330572703657595919530921861173819326117931051185480744623799627495673518857527248912279381830119491298336733624406566430860213949463952247371907021798609437027705392171762931767523846748184676694051320005681271452635608277857713427577896091736371787214684409012249534301465495853710507922796892589235420199561121290219608640344181598136297747713099605187072113499999983729780499510597317328160963185950244594553469083026425223082533446850352619311881710100031378387528865875332083814206171776691473035982534904287554687311595628638823537875937519577818577805321712268066130019278766111959092164201989380952572010654858632788659361533818279682303019520353018529689957736225994138912497217752834791315155748572424541506959508295331168617278558890750983817546374649393192550604009277016711390098488240128583616035637076601047101819429555961989467678374494482553797747268471040475346462080466842590694912933136770289891521047521620569660240580381501935112533824300355876402474964732639141992726042699227967823547816360093417216412199245863150302861829745557067498385054945885869269956909272107975093029553211653449872027559602364806654991198818347977535663698074265425278625518184175746728909777727938000816470600161452491921732172147723501414419735685481613611573525521334757418494684385233239073941433345477624168625189835694855620992192221842725502542568876717904946016534668049886272327917860857843838279679766814541009538837863609506800642251252051173929848960841284886269456042419652850222106611863067442786220391949450471237137869609563643719172874677646575739624138908658326459958133904780275901
对于全部的Kubernetes config, 一个Job 须要 apiVersion
, kind
和 metadata
域。
对于Job 还须要.spec
section。
该 .spec.template
是 .spec
惟一要求的域。
该 .spec.template
是一个 pod template. 与 pod 彻底一致, 除了是嵌套在里面并且没有 apiVersion
或 kind
。
除了 Pod的域, 一个job中的 pod template 须要指明必要的 labels (see pod selector) 以及合适的重启策略(restart policy)。
只有 RestartPolicy
等于o Never
或 OnFailure
是容许的。
该 .spec.selector
是可选的。大多数状况下不须要指定,查看 specifying your own pod selector。
三种类型的 jobs:
.spec.completions
。.spec.completions
。.spec.completions
。.spec.completions
,.spec.parallelism
. - pods 本身协调或经过外部服务去肯定哪个将会 work。设置参数的说明:
.spec.completions
和 .spec.parallelism
为unset,若是都为unset, 两者缺省都为 1。.spec.completions
为完成计数。
.spec.parallelism
, 或留下为unset,将为缺省值1。.spec.completions
为unset, 以及设置 .spec.parallelism
为非负整数。关于建立更多不一样类型的的job, 参见 job patterns 部分。
要求的并行度-parallelism (.spec.parallelism
) 能够被设为任何非负整数。若是未指定,缺省为 1。若是设为 0, 该 Job 就会暂停,知道其值被增长。
实际上的 parallelism (运行同一任务的 pods数量) 可能多于或少于 parallelism,有多种缘由:
.spec.parallelism
are effectively ignored.A Container in a Pod may fail for a number of reasons, such as because the process in it exited with a non-zero exit code, or the Container was killed for exceeding a memory limit, etc. If this happens, and the .spec.template.spec.restartPolicy = "OnFailure"
, then the Pod stays on the node, but the Container is re-run. Therefore, your program needs to handle the case when it is restarted locally, or else specify .spec.template.spec.restartPolicy = "Never"
. See pods-states for more information on restartPolicy
.
An entire Pod can also fail, for a number of reasons, such as when the pod is kicked off the node (node is upgraded, rebooted, deleted, etc.), or if a container of the Pod fails and the .spec.template.spec.restartPolicy = "Never"
. When a Pod fails, then the Job controller starts a new Pod. Therefore, your program needs to handle the case when it is restarted in a new pod. In particular, it needs to handle temporary files, locks, incomplete output and the like caused by previous runs.
Note that even if you specify .spec.parallelism = 1
and .spec.completions = 1
and .spec.template.spec.restartPolicy = "Never"
, the same program may sometimes be started twice.
If you do specify .spec.parallelism
and .spec.completions
both greater than 1, then there may be multiple pods running at once. Therefore, your pods must also be tolerant of concurrency.
There are situations where you want to fail a Job after some amount of retries due to a logical error in configuration etc. To do so, set .spec.backoffLimit
to specify the number of retries before considering a Job as failed. The back-off limit is set by default to 6. Failed Pods associated with the Job are recreated by the Job controller with an exponential back-off delay (10s, 20s, 40s …) capped at six minutes. The back-off count is reset if no new failed Pods appear before the Job’s next status check.
Note: Due to a known issue #54870, when the
.spec.template.spec.restartPolicy
field is set to “OnFailure
”, the back-off limit may be ineffective. As a short-term workaround, set the restart policy for the embedded template to “Never
”.
When a Job completes, no more Pods are created, but the Pods are not deleted either. Keeping them around allows you to still view the logs of completed pods to check for errors, warnings, or other diagnostic output. The job object also remains after it is completed so that you can view its status. It is up to the user to delete old jobs after noting their status. Delete the job with kubectl
(e.g. kubectl delete jobs/pi
or kubectl delete -f ./job.yaml
). When you delete the job using kubectl
, all the pods it created are deleted too.
By default, a Job will run uninterrupted unless a Pod fails, at which point the Job defers to the .spec.backoffLimit
described above. Another way to terminate a Job is by setting an active deadline. Do this by setting the .spec.activeDeadlineSeconds
field of the Job to a number of seconds.
The activeDeadlineSeconds
applies to the duration of the job, no matter how many Pods are created. Once a Job reaches activeDeadlineSeconds
, the Job and all of its Pods are terminated. The result is that the job has a status with reason: DeadlineExceeded
.
Note that a Job’s .spec.activeDeadlineSeconds
takes precedence over its .spec.backoffLimit
. Therefore, a Job that is retrying one or more failed Pods will not deploy additional Pods once it reaches the time limit specified by activeDeadlineSeconds
, even if the backoffLimit
is not yet reached.
Example:
apiVersion: batch/v1 kind: Job metadata: name: pi-with-timeout spec: backoffLimit: 5 activeDeadlineSeconds: 100 template: spec: containers: - name: pi image: perl command: ["perl", "-Mbignum=bpi", "-wle", "print bpi(2000)"] restartPolicy: Never
Note that both the Job Spec and the Pod Template Spec within the Job have an activeDeadlineSeconds
field. Ensure that you set this field at the proper level.
The Job object can be used to support reliable parallel execution of Pods. The Job object is not designed to support closely-communicating parallel processes, as commonly found in scientific computing. It does support parallel processing of a set of independent but related work items. These might be emails to be sent, frames to be rendered, files to be transcoded, ranges of keys in a NoSQL database to scan, and so on.
In a complex system, there may be multiple different sets of work items. Here we are just considering one set of work items that the user wants to manage together — a batch job.
There are several different patterns for parallel computation, each with strengths and weaknesses. The tradeoffs are:
The tradeoffs are summarized here, with columns 2 to 4 corresponding to the above tradeoffs. The pattern names are also links to examples and more detailed description.
Pattern | Single Job object | Fewer pods than work items? | Use app unmodified? | Works in Kube 1.1? |
---|---|---|---|---|
Job Template Expansion | ✓ | ✓ | ||
Queue with Pod Per Work Item | ✓ | sometimes | ✓ | |
Queue with Variable Pod Count | ✓ | ✓ | ✓ | |
Single Job with Static Work Assignment | ✓ | ✓ |
When you specify completions with .spec.completions
, each Pod created by the Job controller has an identical spec
. This means that all pods will have the same command line and the same image, the same volumes, and (almost) the same environment variables. These patterns are different ways to arrange for pods to work on different things.
This table shows the required settings for .spec.parallelism
and .spec.completions
for each of the patterns. Here, W
is the number of work items.
Pattern | .spec.completions |
.spec.parallelism |
---|---|---|
Job Template Expansion | 1 | should be 1 |
Queue with Pod Per Work Item | W | any |
Queue with Variable Pod Count | 1 | any |
Single Job with Static Work Assignment | W | any |
Normally, when you create a job object, you do not specify .spec.selector
. The system defaulting logic adds this field when the job is created. It picks a selector value that will not overlap with any other jobs.
However, in some cases, you might need to override this automatically set selector. To do this, you can specify the .spec.selector
of the job.
Be very careful when doing this. If you specify a label selector which is not unique to the pods of that job, and which matches unrelated pods, then pods of the unrelated job may be deleted, or this job may count other pods as completing it, or one or both of the jobs may refuse to create pods or run to completion. If a non-unique selector is chosen, then other controllers (e.g. ReplicationController) and their pods may behave in unpredictable ways too. Kubernetes will not stop you from making a mistake when specifying .spec.selector
.
Here is an example of a case when you might want to use this feature.
Say job old
is already running. You want existing pods to keep running, but you want the rest of the pods it creates to use a different pod template and for the job to have a new name. You cannot update the job because these fields are not updatable. Therefore, you delete job old
but leave its pods running, using kubectl delete jobs/old --cascade=false
. Before deleting it, you make a note of what selector it uses:
kind: Job metadata: name: old ... spec: selector: matchLabels: job-uid: a8f3d00d-c6d2-11e5-9f87-42010af00002 ...
Then you create a new job with name new
and you explicitly specify the same selector. Since the existing pods have label job-uid=a8f3d00d-c6d2-11e5-9f87-42010af00002
, they are controlled by job new
as well.
You need to specify manualSelector: true
in the new job since you are not using the selector that the system normally generates for you automatically.
kind: Job metadata: name: new ... spec: manualSelector: true selector: matchLabels: job-uid: a8f3d00d-c6d2-11e5-9f87-42010af00002 ...
The new Job itself will have a different uid from a8f3d00d-c6d2-11e5-9f87-42010af00002
. Setting manualSelector: true
tells the system to that you know what you are doing and to allow this mismatch.
When the node that a pod is running on reboots or fails, the pod is terminated and will not be restarted. However, a Job will create new pods to replace terminated ones. For this reason, we recommend that you use a job rather than a bare pod, even if your application requires only a single pod.
Jobs are complementary to Replication Controllers. A Replication Controller manages pods which are not expected to terminate (e.g. web servers), and a Job manages pods that are expected to terminate (e.g. batch jobs).
As discussed in Pod Lifecycle, Job
is only appropriate for pods with RestartPolicy
equal to OnFailure
or Never
. (Note: If RestartPolicy
is not set, the default value is Always
.)
Another pattern is for a single Job to create a pod which then creates other pods, acting as a sort of custom controller for those pods. This allows the most flexibility, but may be somewhat complicated to get started with and offers less integration with Kubernetes.
One example of this pattern would be a Job which starts a Pod which runs a script that in turn starts a Spark master controller (see spark example), runs a spark driver, and then cleans up.
An advantage of this approach is that the overall process gets the completion guarantee of a Job object, but complete control over what pods are created and how work is assigned to them.
Support for creating Jobs at specified times/dates (i.e. cron) is available in Kubernetes 1.4. More information is available in the cron job documents