CronJob

CronJob представляет конфигурацию одного задания cron.

Документация по концепции CronJob

CronJob

CronJob запускает однократные задания по повторяющемуся расписанию.

apiVersion: batch/v1

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

CronJob

CronJob представляет конфигурацию одного задания cron.

Поле	Описание
`apiVersion` string	APIVersion определяет версионированную схему этого представления объекта. Серверы должны преобразовывать распознанные схемы в последнее внутреннее представление и могут отклонять нераспознанные значения. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
`kind` string	Kind — это строковое значение, представляющее ресурс REST, который описывает этот объект. Серверы могут определить его по конечной точке, на которую клиент отправляет запросы. Не может быть обновлено. В CamelCase. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
`metadata` ObjectMeta	Стандартные метаданные объекта. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
`spec` * CronJobSpec	Спецификация желаемого поведения задания cron, включая расписание. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
`status` CronJobStatus	Текущий статус задания cron. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status

CronJobSpec

CronJobSpec описывает, как будет выполняться задание и когда именно оно будет запущено.

Поле	Описание
`concurrencyPolicy` string	Определяет, как обрабатывать параллельные выполнения задания. Допустимые значения: - "Allow" (по умолчанию): разрешает параллельное выполнение заданий CronJob; - "Forbid": запрещает параллельные запуски, пропуская следующий запуск, если предыдущий ещё не завершился; - "Replace": отменяет выполняющееся задание и заменяет его новым Возможные значения перечисления: - `"Allow"` разрешает параллельное выполнение заданий CronJob. - `"Forbid"` запрещает параллельные запуски, пропуская следующий запуск, если предыдущий ещё не завершился. - `"Replace"` отменяет выполняющееся задание и заменяет его новым.
`failedJobsHistoryLimit` integer	Количество завершившихся неудачей заданий, которые нужно сохранить. Значение должно быть неотрицательным целым числом. По умолчанию — 1.
`jobTemplate` * JobTemplateSpec	Определяет задание, которое будет создано при выполнении CronJob.
`schedule` * string	Расписание в формате Cron, см. https://en.wikipedia.org/wiki/Cron.
`startingDeadlineSeconds` integer	Необязательный срок в секундах для запуска задания, если по какой-либо причине оно пропустило запланированное время. Пропущенные запуски заданий будут считаться неудачными.
`successfulJobsHistoryLimit` integer	Количество успешно завершившихся заданий, которые нужно сохранить. Значение должно быть неотрицательным целым числом. По умолчанию — 3.
`suspend` boolean	Этот флаг указывает контроллеру приостановить последующие запуски; он не влияет на уже начатые запуски. По умолчанию — false.
`timeZone` string	Название часового пояса для указанного расписания, см. https://en.wikipedia.org/wiki/List_of_tz_database_time_zones. Если не указано, по умолчанию используется часовой пояс процесса kube-controller-manager. Набор допустимых названий часовых поясов и смещения загружается из общесистемной базы данных часовых поясов API-сервером во время проверки CronJob и менеджером контроллеров во время выполнения. Если общесистемную базу данных часовых поясов найти не удаётся, вместо неё используется встроенная версия базы данных. Если название часового пояса становится недопустимым в течение срока существования CronJob или из-за изменения конфигурации хоста, контроллер прекратит создание новых заданий и создаст системное событие с причиной UnknownTimeZone. Дополнительную информацию см. в https://kubernetes.io/docs/concepts/workloads/controllers/cron-jobs/#time-zones

CronJobStatus

CronJobStatus представляет текущее состояние задания cron.

Поле	Описание
`active` ObjectReference array	Список ссылок на выполняющиеся в данный момент задания.
`lastScheduleTime` Time	Информация о времени последнего успешного планирования задания.
`lastSuccessfulTime` Time	Информация о времени последнего успешного завершения задания.

CronJobList

CronJobList — это коллекция заданий cron.

Поле	Описание
`apiVersion` string	APIVersion определяет версионированную схему этого представления объекта. Серверы должны преобразовывать распознанные схемы в последнее внутреннее представление и могут отклонять нераспознанные значения. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
`items` * CronJob array	items — это список объектов CronJob.
`kind` string	Kind — это строковое значение, представляющее ресурс REST, который описывает этот объект. Серверы могут определить его по конечной точке, на которую клиент отправляет запросы. Не может быть обновлено. В CamelCase. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
`metadata` ListMeta	Стандартные метаданные списка. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

JobTemplateSpec

JobTemplateSpec описывает данные, которыми должно обладать задание, созданное на основе шаблона

Поле	Описание
`metadata` ObjectMeta	Стандартные метаданные объектов заданий, созданных на основе этого шаблона. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
`spec` JobSpec	Спецификация желаемого поведения задания. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status

© 2026 The Kubernetes Authors | Documentation Distributed under CC BY 4.0
Copyright © 2026 The Linux Foundation ®. All rights reserved.
https://kubernetes.io/docs/reference/kubernetes-api/batch/cron-job-v1/