You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/en/docs/concepts/workloads/controllers/cron-jobs.md
+9-7Lines changed: 9 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,7 +14,10 @@ weight: 80
14
14
15
15
A _CronJob_ creates {{< glossary_tooltip term_id="job" text="Jobs" >}} on a repeating schedule.
16
16
17
-
CronJob is meant for performing regular scheduled actions such as backups, report generation, and so on. One CronJob object is like one line of a _crontab_ (cron table) file on a Unix system. It runs a job periodically on a given schedule, written in [Cron](https://en.wikipedia.org/wiki/Cron) format.
17
+
CronJob is meant for performing regular scheduled actions such as backups, report generation,
18
+
and so on. One CronJob object is like one line of a _crontab_ (cron table) file on a
19
+
Unix system. It runs a job periodically on a given schedule, written in
For example, in certain circumstances, a single cron job can create multiple jobs. See the [limitations](#cron-job-limitations) below.
@@ -146,7 +149,7 @@ For another way to clean up jobs automatically, see [Clean up finished jobs auto
146
149
147
150
### Time zones
148
151
149
-
For CronJobs with no time zone specified, the kube-controller-manager interprets schedules relative to its local time zone.
152
+
For CronJobs with no time zone specified, the {{< glossary_tooltip term_id="kube-controller-manager" text="kube-controller-manager" >}} interprets schedules relative to its local time zone.
@@ -159,22 +162,21 @@ When you have the feature enabled, you can set `.spec.timeZone` to the name of a
159
162
`.spec.timeZone: "Etc/UTC"` instructs Kubernetes to interpret the schedule relative to Coordinated Universal Time.
160
163
161
164
{{< caution >}}
162
-
Historically you may find the `.spec.schedule` field can be set with a timezone like `CRON_TZ=UTC * * * * *` or `TZ=UTC * * * * *`. This way is not recommended any more and you should consider use the `.spec.timeZone` field as described above.
165
+
Historically you may set the `.spec.schedule` field to a timezone like `CRON_TZ=UTC * * * * *` or
166
+
`TZ=UTC * * * * *`. This way is not recommended any more and you should consider use the
167
+
`.spec.timeZone` field as described above.
163
168
{{< /caution >}}
164
169
165
170
A time zone database from the Go standard library is included in the binaries and used as a fallback in case an external database is not available on the system.
166
171
167
172
## CronJob limitations {#cron-job-limitations}
168
173
169
-
### Name limitations
170
-
When creating the manifest for a CronJob resource, make sure the name you provide is a valid DNS subdomain name. The name must be no longer than 52 characters. This is because the CronJob controller will automatically append 11 characters to the job name provided and there is a constraint that the maximum length of a Job name is no more than 63 characters.
171
-
172
174
### Modifying a CronJob
173
175
If you modify a CronJob, the changes you make will apply to new jobs that start to run after your modification
174
176
is complete. Jobs (and their Pods) that have already started continue to run without changes.
175
177
That is, the CronJob does _not_ update existing jobs, even if those remain running.
176
178
177
-
### How a CronJob schedules
179
+
### Job creation
178
180
179
181
A CronJob creates a job object _about_ once per execution time of its schedule. We say "about" because there
180
182
are certain circumstances where two jobs might be created, or no job might be created. We attempt to make these rare,
0 commit comments