CronJob v1beta1

apiVersion: batch/v1beta1

import "k8s.io/api/batch/v1beta1"

CronJob

CronJob represents the configuration of a single cron job.

• apiVersion: batch/v1beta1

• kind: CronJob

• metadata (ObjectMeta)

  Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

• spec (CronJobSpec)

  Specification of the desired behavior of a cron job, including the schedule. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status

• status (CronJobStatus)

  Current status of a cron job. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status

CronJobSpec

CronJobSpec describes how the job execution will look like and when it will actually run.

• jobTemplate (JobTemplateSpec), required

  Specifies the job that will be created when executing a CronJob.

  JobTemplateSpec describes the data a Job should have when created from a template

  • jobTemplate.metadata (ObjectMeta)

    Standard object's metadata of the jobs created from this template. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

  • jobTemplate.spec (JobSpec)

    Specification of the desired behavior of the job. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status

• schedule (string), required

  The schedule in Cron format, see https://en.wikipedia.org/wiki/Cron.

• concurrencyPolicy (string)

  Specifies how to treat concurrent executions of a Job. Valid values are: - "Allow" (default): allows CronJobs to run concurrently; - "Forbid": forbids concurrent runs, skipping next run if previous run hasn't finished yet; - "Replace": cancels currently running job and replaces it with a new one

• startingDeadlineSeconds (int64)

  Optional deadline in seconds for starting the job if it misses scheduled time for any reason. Missed jobs executions will be counted as failed ones.

• suspend (boolean)

  This flag tells the controller to suspend subsequent executions, it does not apply to already started executions. Defaults to false.

• successfulJobsHistoryLimit (int32)

  The number of successful finished jobs to retain. This is a pointer to distinguish between explicit zero and not specified. Defaults to 3.

• failedJobsHistoryLimit (int32)

  The number of failed finished jobs to retain. This is a pointer to distinguish between explicit zero and not specified. Defaults to 1.

CronJobStatus

CronJobStatus represents the current state of a cron job.

• active ([]ObjectReference)

  A list of pointers to currently running jobs.

• lastScheduleTime (Time)

  Information when was the last time the job was successfully scheduled.

  Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.

CronJobList

CronJobList is a collection of cron jobs.

• apiVersion: batch/v1beta1

• kind: CronJobList

• metadata (ListMeta)

  Standard list metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

• items ([]CronJob), required

  items is the list of CronJobs.