kep2140

kubernetes · Mar 30, 2022 · ce96f83 · ce96f83
1 parent 6da9c34
commit ce96f83
Show file tree

Hide file tree

Showing 2 changed files with 11 additions and 0 deletions.
diff --git a/content/en/docs/concepts/workloads/controllers/cron-jobs.md b/content/en/docs/concepts/workloads/controllers/cron-jobs.md
@@ -36,6 +36,8 @@ for parsing and calculating the next Job creation time. Any usage of it is not
 recommended in a production cluster.
 {{< /caution >}}
 
+**ALPHA**: CronJob now supports a new `timeZone` field and requires the `CronJobTimeZone` featuregate to be enabled to use.
+
 When creating the manifest for a CronJob resource, make sure the name you provide
 is a valid [DNS subdomain name](/docs/concepts/overview/working-with-objects/names#dns-subdomain-names).
 The name must be no longer than 52 characters. This is because the CronJob controller will automatically
@@ -91,6 +93,14 @@ For example, the line below states that the task must be started every Friday at
 
 To generate CronJob schedule expressions, you can also use web tools like [crontab.guru](https://crontab.guru/).
 
+## TimeZone Support
+**ALPHA** as of 1.24
+
+There is now a new `timeZone` field and requires the `CronJobTimeZone` featuregate to be enabled to use. It is an optional field that should be set either to nil or a non-empty string. The `timeZone` string value should be a valid time zone name. Please see: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones. If not specified, the local time zone of kube-controller-manager is used.
+
+An external time zone database should be available for use. In the event that one is not available, one from the Go standard library will be embedded into the binaries.
+
+
 ## CronJob limitations {#cron-job-limitations}
 
 A cron job creates a job object _about_ once per execution time of its schedule. We say "about" because there

diff --git a/content/en/docs/reference/command-line-tools-reference/feature-gates.md b/content/en/docs/reference/command-line-tools-reference/feature-gates.md
@@ -70,6 +70,7 @@ different Kubernetes components.
 | `CPUManagerPolicyBetaOptions` | `true` | Beta | 1.23 | |
 | `CPUManagerPolicyOptions` | `false` | Alpha | 1.22 | 1.22 |
 | `CPUManagerPolicyOptions` | `true` | Beta | 1.23 | |
+| `CronJobTimeZone` | `false` | Alpha | 1.24 | |
 | `CSIInlineVolume` | `false` | Alpha | 1.15 | 1.15 |
 | `CSIInlineVolume` | `true` | Beta | 1.16 | - |
 | `CSIMigration` | `false` | Alpha | 1.14 | 1.16 |