Skip to content

创建定时任务（CronJob）

本文介绍如何通过镜像和 YAML 文件两种方式创建定时任务（CronJob）。

定时任务（CronJob）适用于于执行周期性的操作，例如备份、报告生成等。这些任务可以配置为周期性重复的（例如：每天/每周/每月一次），可以定义任务开始执行的时间间隔。

前提条件

创建定时任务（CronJob）之前，需要满足以下前提条件：

镜像创建

参考以下步骤，使用镜像创建一个定时任务。

  1. 点击左侧导航栏上的 集群列表 ，然后点击目标集群的名称，进入 集群详情 页面。

    集群详情

  2. 在集群详情页面，点击左侧导航栏的 工作负载 -> 定时任务 ，然后点击页面右上角的 镜像创建 按钮。

    工作负载

  3. 依次填写基本信息、容器配置、定时任务配置、高级配置后，在页面右下角点击 确定 完成创建。

    系统将自动返回 定时任务 列表。点击列表右侧的 ┇ ，可以对定时任务执行执行更新、删除、重启等操作。

    操作菜单

基本信息

在 创建定时任务 页面中，根据下表输入信息后，点击 下一步 。

基本信息

  • 负载名称：最多包含 63 个字符，只能包含小写字母、数字及分隔符（“-”），且必须以小写字母或数字开头及结尾。同一命名空间内同一类型工作负载的名称不得重复，而且负载名称在工作负载创建好之后不可更改。
  • 命名空间：选择将新建的定时任务部署在哪个命名空间，默认使用 default 命名空间。找不到所需的命名空间时可以根据页面提示去创建新的命名空间。
  • 描述：输入工作负载的描述信息，内容自定义。字符数量应不超过 512 个。

容器配置

容器配置分为基本信息、生命周期、健康检查、环境变量、数据存储、安全设置六部分，点击下方的相应页签可查看各部分的配置要求。

容器配置仅针对单个容器进行配置，如需在一个容器组中添加多个容器，可点击右侧的 + 添加多个容器。

在配置容器相关参数时，必须正确填写容器的名称、镜像参数，否则将无法进入下一步。参考以下要求填写配置后，点击 确认 。

基本信息

  • 容器类型：默认为工作容器。有关初始化容器，参见 k8s 官方文档。
  • 容器名称：最多包含 63 个字符，支持小写字母、数字及分隔符（“-”）。必须以小写字母或数字开头及结尾，例如 nginx-01。
  • 镜像：
    • 容器镜像：从列表中选择一个合适的镜像。输入镜像名称时，默认从官方的 DockerHub 拉取镜像。 接入算丰 AI 算力平台的镜像仓库模块后，可以点击右侧的 选择镜像 按钮来选择镜像。
    • 镜像版本：从下拉列表选择一个合适的版本。
    • 镜像拉取策略：勾选 总是拉取镜像 后，负载每次重启/升级时都会从仓库重新拉取镜像。 如果不勾选，则只拉取本地镜像，只有当镜像在本地不存在时才从镜像仓库重新拉取。 更多详情可参考镜像拉取策略。
    • 镜像仓库密钥：可选。如果目标仓库需要 Secret 才能访问，需要先去创建一个密钥。
  • 特权容器：容器默认不可以访问宿主机上的任何设备，开启特权容器后，容器即可访问宿主机上的所有设备，享有宿主机上的运行进程的所有权限。
  • CPU/内存配额：CPU/内存资源的请求值（需要使用的最小资源）和限制值（允许使用的最大资源）。请根据需要为容器配置资源，避免资源浪费和因容器资源超额导致系统故障。默认值如图所示。
  • GPU 配置：为容器配置 GPU 用量， 仅支持输入正整数。
    • 整卡模式：
      • 物理卡数量：容器能够使用的物理 GPU 卡数量。配置后，容器将占用整张物理 GPU卡。同时物理卡数量需要 ≤ 单节点插入的最大 GPU 卡数。
    • 虚拟化模式：
      • 物理卡数量：容器能够使用的物理 GPU 卡数量， 物理卡数量需要 ≤ 单节点插入的最大 GPU 卡数。
      • GPU 算力：每张物理 GPU 卡上需要使用的算力百分比，最多为100%。
      • 显存：每张物理卡上需要使用的显存数量。
      • 调度策略（Binpack / Spread）：支持基于 GPU 卡和基于节点的两种维度的调度策略。Binpack 是集中式调度策略，优先将容器调度到同一个节点的同一张 GPU 卡上；Spread 是分散式调度策略，优先将容器调度到不同节点的不同 GPU 卡上，根据实际场景可组合使用。（当工作负载级别的 Binpack / Spread 调度策略与集群级别的 Binpack / Spread 调度策略冲突时，系统优先使用工作负载级别的调度策略）。
      • 任务优先级：GPU 算力会优先供给高优先级任务使用，普通任务会减少甚至暂停使用 GPU 算力，直到高优先级任务结束，普通任务会重新继续使用 GPU 算力，常用于在离线混部场景。
      • 指定型号：将工作负载调度到指定型号的 GPU 卡上，适用于对 GPU 型号有特殊要求的场景。
    • Mig 模式
      • 规格：切分后的物理 GPU 卡规格。
      • 数量：使用该规格的数量。

设置 GPU 之前，需要管理员预先在集群上安装 GPU Operator 和 nvidia-vgpu（仅 vGPU 模式需要安装），并在集群设置中开启 GPU 特性。

设置容器启动时、启动后、停止前需要执行的命令。详情可参考容器生命周期配置。

生命周期

用于判断容器和应用的健康状态，有助于提高应用的可用性。详情可参考容器健康检查配置。

健康检查

配置 Pod 内的容器参数，为 Pod 添加环境变量或传递配置等。详情可参考容器环境变量配置。

环境变量

配置容器挂载数据卷和数据持久化的设置。详情可参考容器数据存储配置。

数据存储

通过 Linux 内置的账号权限隔离机制来对容器进行安全隔离。您可以通过使用不同权限的账号 UID（数字身份标记）来限制容器的权限。例如，输入 0 表示使用 root 账号的权限。

安全设置

定时任务配置

定时任务配置

  • 并发策略：是否允许多个 Job 任务并行执行。

    • Allow ：可以在前一个任务未完成时就创建新的定时任务，而且多个任务可以并行。任务太多可能抢占集群资源。
    • Forbid ：在前一个任务完成之前，不能创建新任务，如果新任务的执行时间到了而之前的任务仍未执行完，CronJob 会忽略新任务的执行。
    • Replace ：如果新任务的执行时间到了，但前一个任务还未完成，新的任务会取代前一个任务。

    上述规则仅适用于同一个 CronJob 创建的多个任务。多个 CronJob 创建的多个任务总是允许并发执行。

  • 定时规则：基于分钟、小时、天、周、月设置任务执行的时间周期。支持用数字和 * 自定义 Cron 表达式，输入表达式后下方会提示当前表达式的含义。有关详细的表达式语法规则，可参考 Cron 时间表语法。

  • 任务记录：设定保留多少条任务执行成功或失败的记录。 0 表示不保留。
  • 超时时间：超出该时间时，任务就会被标识为执行失败，任务下的所有 Pod 都会被删除。为空时表示不设置超时时间。默认值为 360 s。
  • 重试次数：任务可重试次数，默认值为 6。
  • 重启策略：设置任务失败时是否重启 Pod。

服务配置

为有状态负载配置服务（Service），使有状态负载能够被外部访问。

  1. 点击 创建服务 按钮。

    服务配置

  2. 参考创建服务，配置服务参数。

    创建服务

  3. 点击 确定 ，点击 下一步 。

高级配置

定时任务的高级配置主要涉及标签与注解。

可以点击 添加 按钮为工作负载实例 Pod 添加标签和注解。

定时任务配置

YAML 创建

除了通过镜像方式外，还可以通过 YAML 文件更快速地创建创建定时任务。

  1. 点击左侧导航栏上的 集群列表 ，然后点击目标集群的名称，进入 集群详情 页面。

    集群详情

  2. 在集群详情页面，点击左侧导航栏的 工作负载 -> 定时任务 ，然后点击页面右上角的 YAML 创建 按钮。

    工作负载

  3. 输入或粘贴事先准备好的 YAML 文件，点击 确定 即可完成创建。

    工作负载

点击查看创建定时任务的 YAML 示例 
apiVersion: batch/v1
kind: CronJob
metadata:
  creationTimestamp: '2022-12-26T09:45:47Z'
  generation: 1
  name: demo
  namespace: default
  resourceVersion: '92726617'
  uid: d030d8d7-a405-4dcd-b09a-176942ef36c9
spec:
  concurrencyPolicy: Allow
  failedJobsHistoryLimit: 1
  jobTemplate:
    metadata:
      creationTimestamp: null
    spec:
      activeDeadlineSeconds: 360
      backoffLimit: 6
      template:
        metadata:
          creationTimestamp: null
        spec:
          containers:
            - image: nginx
              imagePullPolicy: IfNotPresent
              lifecycle: {}
              name: container-3
              resources:
                limits:
                  cpu: 250m
                  memory: 512Mi
                requests:
                  cpu: 250m
                  memory: 512Mi
              securityContext:
                privileged: false
              terminationMessagePath: /dev/termination-log
              terminationMessagePolicy: File
          dnsPolicy: ClusterFirst
          restartPolicy: Never
          schedulerName: default-scheduler
          securityContext: {}
          terminationGracePeriodSeconds: 30
  schedule: 0 0 13 * 5
  successfulJobsHistoryLimit: 3
  suspend: false
status: {}