Kubernetes 1.21版本CronJob配置CRON_TZ时区报错如何解决？

报错原因 #

• CRON_TZ前缀语法是Kubernetes 1.25版本才正式加入batch/v1版本CronJob的特性，你当前使用的1.21版本集群不支持该语法，校验时会把CRON_TZ=UTC识别为多余的第6个cron字段，因此抛出字段数量不匹配的错误。
• Kubernetes 1.21版本没有内置官方的时区指定字段（timeZone字段是1.24版本引入的alpha特性，需要集群开启对应FeatureGate才能使用，1.21版本无该特性），默认CronJob的执行时区和kube-controller-manager组件的系统时区保持一致。

解决方案 #

方案1：调整cron表达式适配集群默认时区 #

先确认你集群kube-controller-manager的系统时区，把你需要的执行时间换算成对应时区的时间写进schedule字段即可。比如默认时区是东八区，你需要UTC时间23点执行，对应东八区是次日7点，就把schedule写成0 7 * * *即可。

方案2：容器层面配置时区 #

如果不想做时区换算，可以在CronJob的Job模板中为业务容器配置时区环境变量，确保容器内业务逻辑执行时的时区符合预期，示例配置如下：

apiVersion: batch/v1
kind: CronJob
metadata:
  name: scheduler
spec:
  schedule: "0 23 * * *" # 此处时间仍为kube-controller-manager对应时区的时间
  jobTemplate:
    spec:
      template:
        spec:
          containers:
          - name: your-job-container
            image: your-business-image
            env:
            - name: TZ
              value: UTC
            # 其余业务配置
          restartPolicy: OnFailure

方案3：升级集群到支持原生时区特性的版本 #

如果要直接使用CRON_TZ前缀或者timeZone字段的原生特性，可以将你的DigitalOcean Kubernetes集群升级到1.25及以上版本，升级后直接按官方规则配置即可，示例：

apiVersion: batch/v1
kind: CronJob
metadata:
  name: scheduler
spec:
  schedule: "0 23 * * *"
  timeZone: UTC
  # 也可使用CRON_TZ前缀写法：schedule: "CRON_TZ=UTC 0 23 * * *"

内容的提问来源于stack exchange，提问作者yihereg819