#CronJobs

#了解 CronJobs

请参阅 Kubernetes 官方文档：

• CronJobs
• 使用 CronJob 运行自动化任务

CronJob 定义运行至完成后停止的任务。它允许你根据调度计划多次运行同一个 Job。

CronJob 是 Kubernetes 中的一种工作负载控制器。你可以通过 Web 控制台或 CLI 创建 CronJob，以周期性或重复运行非持久性程序，例如定时备份、定时清理或定时发送电子邮件。

#创建 CronJobs

#使用 CLI 创建 CronJob

#前提条件

• 确保已配置 kubectl 并连接到你的集群。

#YAML 文件示例

# example-cronjob.yaml
apiVersion: batch/v1
kind: CronJob
metadata:
  name: hello
spec:
  schedule: "* * * * *" 
  jobTemplate:
    spec:
      template:
        spec:
          containers:
          - name: hello
            image: busybox:1.28
            imagePullPolicy: IfNotPresent
            command:
            - /bin/sh
            - -c
            - date; echo Hello from the Kubernetes cluster
          restartPolicy: OnFailure

#通过 YAML 创建 CronJobs

kubectl apply -f example-cronjob.yaml

#使用 Web 控制台创建 CronJobs

#前提条件

获取镜像地址。镜像可以来自平台管理员通过工具链集成的镜像仓库，也可以来自第三方镜像仓库。

• 对于集成镜像仓库中的镜像，管理员通常会将镜像仓库分配给你的项目，使你能够使用其中的镜像。如果找不到所需的镜像仓库，请联系管理员进行分配。

• 如果使用第三方镜像仓库，请确保可以在当前集群中直接从该仓库拉取镜像。

#操作步骤 - 配置基本信息

1. 在容器平台中，导航至左侧边栏中的工作负载 > CronJobs。

2. 单击创建 CronJob。

3. 选择或输入镜像，然后单击确认。

   注意：仅当使用平台集成镜像仓库中的镜像时，才能筛选镜像。例如，containers (docker-registry-projectname) 这样的集成项目名称表示平台项目名称为 projectname，镜像仓库项目名称为 containers。

4. 在 Cron 配置部分中，配置任务执行方式及相关参数。

   执行类型：

   • 手动：手动执行要求每次运行任务时都显式手动触发。

   • 定时：定时执行需要配置以下调度参数：

     参数	描述
     调度计划	使用 Crontab 语法定义 cron 调度计划。CronJob 控制器根据所选时区计算下一次执行时间。 注意： 对于 Kubernetes 集群 < v1.25：不支持选择时区；调度计划必须使用 UTC。 对于 Kubernetes 集群 ≥ v1.25：支持时区感知调度（默认值：用户的本地时区）。
     并发策略	指定如何处理并发 Job 执行（根据 K8s 规范，可选 Allow、Forbid 或 Replace）。

   Job 历史记录保留：

   • 设置已完成 Job 的保留限制：
     • 历史记录限制：成功 Job 的历史记录限制（默认值：20）
     • 失败的 Job：失败 Job 的历史记录限制（默认值：20）
   • 超出保留限制时，将优先对最早的 Job 进行垃圾回收。

5. 在 Job 配置部分中，选择 Job 类型。 CronJob 管理由 Pod 组成的 Job。根据工作负载类型配置 Job 模板：

   参数	描述
   Job 类型	选择 Job 完成模式（根据 K8s Job 模式，可选 Non-parallel、Parallel with fixed completion count 或 Indexed Job）。
   退避限制	设置将 Job 标记为失败之前的最大重试次数。

#操作步骤 - 配置 Pod

• 有关 Pod 部分，请参阅 Deployment - 配置 Pod

#操作步骤 - 配置容器

• 有关容器部分，请参阅 Deployment - 配置容器

#创建

• 单击创建。

#立即执行

#找到 CronJob 资源

• Web 控制台：在容器平台中，导航至左侧边栏中的工作负载 > CronJobs。
• CLI：

  kubectl get cronjobs -n <namespace>

#启动临时执行

• Web 控制台：立即执行
  1. 单击 cronjob 列表右侧的垂直省略号 (⋮)。
  2. 单击立即执行。（也可以在 CronJob 详情页面中单击右上角的“操作”，然后选择立即执行）。
• CLI：

  kubectl create job --from=cronjob/<cronjob-name> <job-name> -n <namespace>

#验证 Job 详情：

kubectl describe job/<job-name> -n <namespace>
kubectl logs job/<job-name> -n <namespace>

#监控执行状态

#删除 CronJobs

#使用 Web 控制台删除 CronJobs

1. 在容器平台中，导航至工作负载 > CronJobs。
2. 找到要删除的 CronJobs。
3. 在操作下拉菜单中，单击删除按钮并确认。

#使用 CLI 删除 CronJobs

  kubectl delete cronjob <cronjob-name>