Skip to content

Commit 9b1ba9c

Browse files
committed
adapt suggestions
1 parent 4ebf6b1 commit 9b1ba9c

File tree

1 file changed

+9
-7
lines changed

1 file changed

+9
-7
lines changed

content/en/docs/concepts/workloads/controllers/cron-jobs.md

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,10 @@ weight: 80
1414

1515
A _CronJob_ creates {{< glossary_tooltip term_id="job" text="Jobs" >}} on a repeating schedule.
1616

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
20+
[Cron](https://en.wikipedia.org/wiki/Cron) format.
1821

1922
CronJobs have limitations and idiosyncrasies.
2023
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
146149

147150
### Time zones
148151

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.
150153

151154
{{< feature-state for_k8s_version="v1.25" state="beta" >}}
152155

@@ -159,22 +162,21 @@ When you have the feature enabled, you can set `.spec.timeZone` to the name of a
159162
`.spec.timeZone: "Etc/UTC"` instructs Kubernetes to interpret the schedule relative to Coordinated Universal Time.
160163

161164
{{< 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.
163168
{{< /caution >}}
164169

165170
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.
166171

167172
## CronJob limitations {#cron-job-limitations}
168173

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-
172174
### Modifying a CronJob
173175
If you modify a CronJob, the changes you make will apply to new jobs that start to run after your modification
174176
is complete. Jobs (and their Pods) that have already started continue to run without changes.
175177
That is, the CronJob does _not_ update existing jobs, even if those remain running.
176178

177-
### How a CronJob schedules
179+
### Job creation
178180

179181
A CronJob creates a job object _about_ once per execution time of its schedule. We say "about" because there
180182
are certain circumstances where two jobs might be created, or no job might be created. We attempt to make these rare,

0 commit comments

Comments
 (0)