任务

任务会创建一个或者多个容器组,并确保指定数量的容器组成功结束。随着容器组成功结束,任务跟踪记录成功结束的容器组数量。当达到指定的成功结束数量时,任务(即 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:设置容器组

  1. 重启策略选择重新创建容器组。当任务未完成时,您只能将重启策略指定为重新创建容器组重启容器

    • 如果将重启策略设置为重新创建容器组,当容器组发生故障时,任务将创建一个新的容器组,并且故障的容器组不会消失。

    • 如果将重启策略设置为重启容器,当容器组发生故障时,任务会在内部重启容器,而不是创建新的容器组。

  2. 点击添加容器,它将引导您进入添加容器页面。在镜像搜索栏中输入 perl,然后按回车键。

  3. 在该页面向下滚动到启动命令。在命令框中输入以下命令,计算 pi 到小数点后 2000 位并输出结果。点击右下角的 ,然后选择下一步继续。

    perl,-Mbignum=bpi,-wle,print bpi(2000)
    

    备注

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

步骤 5:检查任务清单(可选)

  1. 在右上角启用编辑 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
    
  2. 您可以直接在清单文件中进行调整,然后点击创建,或者关闭编辑 YAML然后返回创建任务页面。

    备注

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

步骤 6:检查结果

  1. 在最后一步高级设置中,点击创建完成操作。如果创建成功,将添加新条目到任务列表中。

  2. 点击此任务,然后转到任务记录选项卡,您可以在其中查看每个执行记录的信息。先前在步骤 3 中完成数设置为 4,因此有四个已结束的容器组。

    提示

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

    提示

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

查看任务详情

任务操作

在任务详情页面上,您可以在任务创建后对其进行管理。

  • 编辑信息:编辑基本信息,但名称无法编辑。
  • 重新执行:重新执行任务,容器组将重启,并生成新的执行记录。
  • 查看配置文件:查看 YAML 格式的任务规格。
  • 删除:删除该任务并返回到任务列表页面。

任务记录

  1. 点击任务记录选项卡查看任务的执行记录。

  2. 点击 刷新执行记录。

资源状态

  1. 点击资源状态选项卡查看任务的容器组。

  2. 点击 刷新容器组信息,点击 / 显示或隐藏每个容器组中的容器。

元数据

点击元数据选项卡查看任务的标签和注解。

环境变量

点击环境变量选项卡查看任务的环境变量。

事件

点击事件选项卡查看任务的事件。

通过邮件接收 KubeSphere 最新的技术博客与产品更新的通知


感谢您的反馈。如果您有关于如何使用 KubeSphere 的具体问题,请在 Slack 上提问。如果您想报告问题或提出改进建议,请在 GitHub 存储库中打开问题。