CronJob 清单

最小示例

apiVersion: odysseus/v1
kind: CronJob
metadata:
  name: addriva-etl-ingest
  labels: {app: addriva-etl-ingest, project: addriva}
spec:
  schedule: "17 1 1 * *"
  # no timezone: UTC, matching the retired host crontab
  concurrencyPolicy: skip
  startingDeadlineSeconds: 300
  suspend: false
  jobTemplate:
    image: registry.delta-telematics.ca/addriva/etl:0.1.0
    placement: {node: vps-71623e00}
    networks: [addriva-internal]
    command: ["ingest", "--sources", "oda,geoyukon,adresses_qc", "--version", "ODA_v1_2021"]
    environment:
      ADDRIVA_S3_ENDPOINT: "http://addriva-seaweedfs:8333"
      ADDRIVA_S3_BUCKET: "addriva-raw"
      ADDRIVA_OS_HOST: "http://addriva-opensearch:9200"
      ADDRIVA_OS_USER: "admin"
    secrets:
      - vaultPath: deployments/addriva-etl
        rotation: restart
    resources:
      limits:   {cpu: "2", memory: 3500Mi}
      requests: {cpu: 500m, memory: 1Gi}
    restartPolicy: "no"
    backoffLimit: 2
    activeDeadlineSeconds: 14400
    ttlAfterFinished: 4392h

Validated against CronJobManifest · testdata/docs-examples/monthly-cronjob.yaml

CronJob 规范

Generated from CronJobSpec. Hand edits to this table are overwritten on the next build — change the Go doc comment, or the generator.

字段	类型	必需	默认	可变性	自
`concurrencyPolicy`	string	否	—	原地	0.23.0
`failedRunsHistoryLimit`	integer	否	—	原地	0.23.0
`jobTemplate`	JobSpec	否	—	重建	0.23.0
`schedule`	string	否	—	原地	0.23.0
`startingDeadlineSeconds`	integer	否	—	原地	0.23.0
`successfulRunsHistoryLimit`	integer	否	—	原地	0.23.0
`suspend`	boolean	否	—	原地	0.23.0
`timezone`	string	否	—	原地	0.23.0

concurrencyPolicy: ConcurrencyPolicy 是当上一次运行仍在进行时触发事件到达时发生的情况：跳过、排队或替换。

failedRunsHistoryLimit: FailedRunsHistoryLimit 是在最旧的记录被清除之前保留的失败运行记录数量。省略它则使用平台默认值。

jobTemplate: JobTemplate 是每次触发运行的工作负载。该定时作业拥有一个同名的托管作业并重新运行它，而不是为每次触发创建一个新作业。

schedule: Schedule 是一个五字段的 cron 表达式。其中不允许使用 TZ= 或 CRON_TZ= 前缀——timezone: 是唯一的时区设置方式——同样不允许使用其触发可能落在夏令时春令时前跳间隙的调度。

startingDeadlineSeconds: StartingDeadlineSeconds 是当控制平面在预定时刻缺席时，一个触发仍可被启动的最晚延迟时间。0 表示使用默认值，-1 表示错过的触发永远不会被补上。

successfulRunsHistoryLimit: SuccessfulRunsHistoryLimit 是在最旧记录被修剪前保留的成功运行记录数量。省略则使用平台默认值。

suspend: 暂停会停止新的触发，但不会删除 cronjob 或其历史记录。

timezone: 时区是读取计划时所使用的 IANA 时区，例如 “Europe/Copenhagen”。省略则使用 UTC。