任务

任务

任务会创建一个或者多个容器组，并确保指定数量的容器组成功结束。随着容器组成功结束，任务跟踪记录成功结束的容器组数量。当达到指定的成功结束数量时，任务（即 Job）完成。删除任务的操作会清除其创建的全部容器组。

在简单的使用场景中，您可以创建一个任务对象，以便可靠地运行一个容器组直到结束。当第一个容器组故障或者被删除（例如因为节点硬件故障或者节点重启）时，任务对象会启动一个新的容器组。您也可以使用一个任务并行运行多个容器组。

下面的示例演示了在 KubeSphere 中创建任务的具体步骤，该任务会计算 π 到小数点后 2000 位。

准备工作

您需要创建一个企业空间、一个项目和一个用户 (project-regular)，务必邀请该用户到项目中并赋予 operator 角色。有关更多信息，请参见创建企业空间、项目、用户和角色。

创建任务

步骤 1：打开仪表板

以 project-regular 身份登录控制台。转到应用负载下的任务，点击创建。

步骤 2：输入基本信息

输入基本信息。请参考下图作为示例。

名称：任务的名称，也是唯一标识符。
别名：任务的别名，使资源易于识别。
描述信息：任务的描述，简要介绍任务。

步骤 3：策略设置（可选）

您可以在该步骤设置值，或点击下一步以使用默认值。有关每个字段的详细说明，请参考下表。

名称	定义	描述信息
最大重试次数	`spec.backoffLimit`	指定将该任务视为失败之前的重试次数。默认值为 6。
容器组完成数量	`spec.completions`	指定该任务应该运行至成功结束的容器组的期望数量。如果设置为 nil，则意味着任何容器组成功结束即标志着所有容器组成功结束，并且允许并行数为任何正数值。如果设置为 1，则意味着并行数限制为 1，并且该容器组成功结束标志着任务成功完成。有关更多信息，请参见 Jobs。
并行容器组数量	`spec.parallelism`	指定该任务在任何给定时间应该运行的最大期望容器组数量。当剩余工作小于最大并行数时 ((`.spec.completions - .status.successful`) < `.spec.parallelism`)，实际稳定运行的容器组数量会小于该值。有关更多信息，请参见 Jobs。
最大运行时间（s）	`spec.activeDeadlineSeconds`	指定该任务在系统尝试终止任务前处于运行状态的持续时间（相对于 stratTime），单位为秒；该值必须是正整数。

步骤 4：设置容器组

重启策略选择重新创建容器组。当任务未完成时，您只能将重启策略指定为重新创建容器组或重启容器：
- 如果将重启策略设置为重新创建容器组，当容器组发生故障时，任务将创建一个新的容器组，并且故障的容器组不会消失。
- 如果将重启策略设置为重启容器，当容器组发生故障时，任务会在内部重启容器，而不是创建新的容器组。
点击添加容器，它将引导您进入添加容器页面。在镜像搜索栏中输入 perl，然后按回车键。
在该页面向下滚动到启动命令。在命令框中输入以下命令，计算 pi 到小数点后 2000 位并输出结果。点击右下角的 √，然后选择下一步继续。
```
perl,-Mbignum=bpi,-wle,print bpi(2000)
```
备注

有关设置镜像的更多信息，请参见容器组设置。

步骤 5：检查任务清单（可选）

在右上角启用编辑 YAML，显示任务的清单文件。您可以看到所有值都是根据先前步骤中指定的值而设置。

apiVersion: batch/v1
kind: Job
metadata:
  namespace: cc
  labels:
    app: job-test-1
  name: job-test-1
  annotations:
    kubesphere.io/alias-name: Test
    kubesphere.io/description: A job test
spec:
  template:
    metadata:
      labels:
        app: job-test-1
      annotations:
        kubesphere.io/containerSecrets: null
    spec:
      containers:
        - name: container-xv4p2o
          imagePullPolicy: IfNotPresent
          image: perl
          command:
            - perl
            - '-Mbignum=bpi'
            - '-wle'
            - print bpi(2000)
      restartPolicy: Never
      serviceAccount: default
      initContainers: []
      volumes: []
      imagePullSecrets: null
  backoffLimit: 5
  parallelism: 2
  completions: 4
  activeDeadlineSeconds: 300

您可以直接在清单文件中进行调整，然后点击创建，或者关闭编辑 YAML然后返回创建任务页面。

备注

您可以跳过本教程的存储卷设置和高级设置。有关更多信息，请参见挂载存储卷和配置高级设置。

步骤 6：检查结果

在最后一步高级设置中，点击创建完成操作。如果创建成功，将添加新条目到任务列表中。
点击此任务，然后转到任务记录选项卡，您可以在其中查看每个执行记录的信息。先前在步骤 3 中完成数设置为 4，因此有四个已结束的容器组。

提示

如果任务失败，您可以重新运行该任务，失败原因显示在消息下。
在资源状态中，您可以查看容器组状态。先前将并行容器组数量设置为 2，因此每次会创建两个容器组。点击右侧的，然后点击查看容器日志，该日志显示了预期的计算结果。

提示
- 在资源状态中，容器组列表提供了容器组的详细信息（例如创建时间、节点、容器组 IP 和监控数据）。
- 您可以点击容器组查看容器信息。
- 点击容器日志图标查看容器的输出日志。
- 您可以点击容器组名称查看容器组详情页面。