k8s 中定时任务必须用 cronjob 而非 job，go 程序应通过 client-go 提交 cronjob 清单，注意 schedule 格式、restartpolicy 必须显式设为 onfailure 或 never，并配置 rbac 权限。
Job 对象本身不支持定时，必须用 CronJob
直接创建 Job 资源无法实现“定时”，它只是一次性执行任务。K8s 原生支持周期性调度的资源是 CronJob，不是 Job。Golang 程序若想触发定时任务，本质是构造并提交 CronJob YAML 或通过 client-go 创建 CronJob 对象。
常见误区：用 time.Ticker 在 Pod 内轮询创建 Job —— 这既绕过 K8s 调度逻辑，又无法保证高可用（Pod 重启后定时器丢失），还可能因并发导致重复创建。
-
CronJob是集群级控制器，由cronjob-controller管理，自动按 schedule 创建Job - 你的 Go 程序只需调用 K8s API 提交一个
CronJob清单，后续完全由 K8s 自动处理 - 注意 RBAC：ServiceAccount 需有
create权限在cronjobs资源上（batch/v1组）
用 client-go 创建 CronJob 的关键字段
使用 client-go 构造 CronJob 时，最易出错的是 API 版本、schedule 格式、jobTemplate 结构嵌套层级。v1 版本（batch/v1）已废弃 v1beta1，且 jobTemplate.spec.template 必须是完整 PodSpec，不能省略 spec.containers 或 spec.restartPolicy。
示例核心字段设置：
apiVersion: batch/v1
kind: CronJob
metadata:
name: "my-cron-job"
namespace: "default"
spec:
schedule: "0 * * * *" # 注意：必须是标准 cron 格式（5 字段），不支持秒
concurrencyPolicy: "Forbid" # 防止前一个未结束就触发下一个
jobTemplate:
spec:
template:
spec:
restartPolicy: OnFailure # 必须显式指定，Job Pod 默认不自动重启
containers:
- name: worker
image: "my-app:latest"
command: ["/app", "-mode=process"]
-
schedule字符串必须符合Minute Hour DayOfMonth Month DayOfWeek，不支持第六位秒字段 -
jobTemplate.spec.template.spec.restartPolicy只能是OnFailure或Never；设为Always会校验失败 - 如果容器需要挂载 ConfigMap/Secret，请在
template.spec.volumes和containers.volumeMounts中完整定义
调试 CronJob 失败的三个高频检查点
提交 CronJob 后没看到 Job 创建，或 Job 处于 Failed 状态，优先查这三项：
- 看
kubectl get cronjob my-cron-job -o wide输出中的LAST SCHEDULE列是否为空 —— 若为空，说明schedule格式非法或时区不匹配（K8s controller 使用 UTC，非本地时区） - 运行
kubectl describe cronjob my-cron-job，检查 Events 是否有FailedCreate类似事件，典型错误如：error validating data: ValidationError(CronJob.spec.jobTemplate.spec.template.spec): missing required field "restartPolicy" - 若 Job 已创建但 Pod 始终
Pending或CrashLoopBackOff，请kubectl get job找对应 Job 名，再kubectl describe job <job-name></job-name>查失败原因 —— 很多时候是镜像拉取失败、资源请求超限、或容器启动命令退出码非 0
避免用 Go 定时器轮询替代 CronJob
有人试图在 Go 程序中用 time.NewTicker 每分钟调一次 client-go 创建 Job，看似可控，实则埋下多个隐患：
- 单点故障：该 Go 程序一旦崩溃或被驱逐，所有定时任务中断，且无自动恢复机制
- 竞态风险：多个副本同时运行时，可能重复创建相同 Job（除非加分布式锁，成本远高于直接用 CronJob）
- 语义错位：Job 的设计目标是“一次性完成某件事”，而周期性调度属于调度层职责 —— 把调度逻辑下沉到应用层，违背 K8s 声明式设计原则
真正需要动态生成定时任务（比如用户自定义 schedule），也应让 Go 程序作为 CronJob 的“配置生成器”，而非“调度执行器”。生成完 CronJob 清单后，交给 K8s 自己管。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
