KEP-3140keps/sig-apps/3140-TimeZone-support-in-CronJob

TimeZone support in CronJob

implementablestablesig-appslatest v1.271 open finding

KEP on GitHub kep.yaml Ask about this KEP

CronJob creates Jobs based on the schedule specified by the author, but the Time Zone used during the creation depends on where kube-controller-manager is running. This proposal aims to extend CronJob resource with the ability for a user to define the TimeZone when a Job should be created.

Facts

Authors: @soltysh
Approvers: @janetkuo
Reviewers: @atiratree @iterion @ravig
PRR approvers: @deads2kalpha@deads2kbeta@deads2kstable
Tracking issue: #3140(opens GitHub in a new tab) closedcompletedclosed 2024-01-16 09:47 UTCsig/appsstage/stable
Milestones: alpha v1.24beta v1.25stable v1.27
Participating SIGs: none
Feature gates: CronJobTimeZone
Created / last updated: 2022-01-14 / none

Who decided each state, with the evidence.
Decided	Decision	Deciders	Evidence
2022-01-14 16:13 UTC	prr_approval deads2k gave the production readiness approval for KEP-3140 at alpha on 2022-01-14.	@deads2k prr_approver	Document 3140.yaml(opens GitHub in a new tab)
2022-02-02 17:26 UTC	stage_graduation KEP-3140 set milestone.alpha to v1.24 in PR #3143, approved by janetkuo, ravisantoshgudimetla, deads2k; merged by automation (k8s-ci-robot) on 2022-02-02.	@atiratree lgtm @soltysh author @janetkuo approver @deads2k approve_command @ravisantoshgudimetla approver @ravisantoshgudimetla lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@b64b3bf3ce058ce710b9b41a04162d3b2fa11ea9(opens GitHub in a new tab) StatusChange milestone.alpha ∅ → v1.24 (2022-01-14)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#3143 KEP 3140: TimeZone support in CronJob(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/868608833(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/868115444(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/853267290(opens GitHub in a new tab) Comment kubernetes/enhancements/issues/comments/1028173592
2022-02-02 17:26 UTC	stage_graduation KEP-3140 set milestone.beta to v1.25 in PR #3143, approved by janetkuo, ravisantoshgudimetla, deads2k; merged by automation (k8s-ci-robot) on 2022-02-02.	@atiratree lgtm @soltysh author @janetkuo approver @deads2k approve_command @ravisantoshgudimetla approver @ravisantoshgudimetla lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@b64b3bf3ce058ce710b9b41a04162d3b2fa11ea9(opens GitHub in a new tab) StatusChange milestone.beta ∅ → v1.25 (2022-01-14)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#3143 KEP 3140: TimeZone support in CronJob
2022-02-02 17:26 UTC	stage_graduation KEP-3140 set milestone.stable to v1.27 in PR #3143, approved by janetkuo, ravisantoshgudimetla, deads2k; merged by automation (k8s-ci-robot) on 2022-02-02.	@atiratree lgtm @soltysh author @janetkuo approver @deads2k approve_command @ravisantoshgudimetla approver @ravisantoshgudimetla lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@b64b3bf3ce058ce710b9b41a04162d3b2fa11ea9(opens GitHub in a new tab) StatusChange milestone.stable ∅ → v1.27 (2022-01-14)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#3143 KEP 3140: TimeZone support in CronJob
2022-02-02 17:26 UTC	stage_graduation KEP-3140 graduated to alpha in PR #3143, approved by janetkuo, ravisantoshgudimetla, deads2k; merged by automation (k8s-ci-robot) on 2022-02-02.	@atiratree lgtm @soltysh author @janetkuo approver @deads2k approve_command @ravisantoshgudimetla approver @ravisantoshgudimetla lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@b64b3bf3ce058ce710b9b41a04162d3b2fa11ea9(opens GitHub in a new tab) StatusChange stage ∅ → alpha (2022-01-14)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#3143 KEP 3140: TimeZone support in CronJob
2022-02-02 17:26 UTC	status_transition KEP-3140 status set to implementable in PR #3143, approved by janetkuo, ravisantoshgudimetla, deads2k; merged by automation (k8s-ci-robot) on 2022-02-02.	@atiratree lgtm @soltysh author @janetkuo approver @deads2k approve_command @ravisantoshgudimetla approver @ravisantoshgudimetla lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@b64b3bf3ce058ce710b9b41a04162d3b2fa11ea9(opens GitHub in a new tab) StatusChange status ∅ → implementable (2022-01-14)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#3143 KEP 3140: TimeZone support in CronJob
2022-06-09 17:17 UTC	prr_approval deads2k gave the production readiness approval for KEP-3140 at beta on 2022-06-09.	@deads2k prr_approver	Document 3140.yaml(opens GitHub in a new tab)
2022-06-13 18:12 UTC	milestone_retarget KEP-3140 latest-milestone moved from v1.24 to v1.25 in PR #3375, approved by ravisantoshgudimetla, deads2k; merged by automation (k8s-ci-robot) on 2022-06-13.	@soltysh author @deads2k approve_command @ravisantoshgudimetla approver @ravisantoshgudimetla lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@ff9a1de9f6df6086762f02ee12e86740818838d6(opens GitHub in a new tab) StatusChange latest_milestone v1.24 → v1.25 (2022-06-09)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#3375 KEP-3140: TimeZone support in CronJob(opens GitHub in a new tab) Review
2022-06-13 18:12 UTC	stage_graduation KEP-3140 graduated to beta from alpha in PR #3375, approved by ravisantoshgudimetla, deads2k; merged by automation (k8s-ci-robot) on 2022-06-13.	@soltysh author @deads2k approve_command @ravisantoshgudimetla approver @ravisantoshgudimetla lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@ff9a1de9f6df6086762f02ee12e86740818838d6(opens GitHub in a new tab) StatusChange stage alpha → beta (2022-06-09)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#3375 KEP-3140: TimeZone support in CronJob(opens GitHub in a new tab) Review
2022-08-01 15:40 UTC	prr_approval deads2k gave the production readiness approval for KEP-3140 at stable on 2022-08-01.	@deads2k prr_approver	Document 3140.yaml(opens GitHub in a new tab)
2023-02-03 14:30 UTC	milestone_retarget KEP-3140 latest-milestone moved from v1.25 to v1.27 in PR #3449, approved by janetkuo, deads2k; merged by automation (k8s-ci-robot) on 2023-02-03.	@soltysh author @janetkuo approver @janetkuo lgtm @deads2k approve_command @k8s-ci-robot merger	Commit kubernetes/enhancements@9176a2f888f38544dfbc470e7a81b3e15ab491aa(opens GitHub in a new tab) StatusChange latest_milestone v1.25 → v1.27 (2022-08-01)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#3449 KEP 3140: Promote CronJob's TimeZone support to GA(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/1264938052
2023-02-03 14:30 UTC	stage_graduation KEP-3140 graduated to stable from beta in PR #3449, approved by janetkuo, deads2k; merged by automation (k8s-ci-robot) on 2023-02-03.	@soltysh author @janetkuo approver @janetkuo lgtm @deads2k approve_command @k8s-ci-robot merger	Commit kubernetes/enhancements@9176a2f888f38544dfbc470e7a81b3e15ab491aa(opens GitHub in a new tab) StatusChange stage beta → stable (2022-08-01)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#3449 KEP 3140: Promote CronJob's TimeZone support to GA(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/1264938052

Metadata, label and milestone changes, oldest first.Showing 1–10 of 43Rows

Status history
At	Kind	Field	Change	Actor	Evidence
2022-01-14 12:55 UTC	label	needs-sig added	none → needs-sig	@k8s-ci-robot	source(opens GitHub in a new tab)
2022-01-14 13:03 UTC	label	sig/apps added	none → sig/apps	@k8s-ci-robot	source

Relationships as stored, Person → KEP, from kep.yaml(opens GitHub in a new tab)
Person	Relationship
@soltysh GitHub(opens GitHub in a new tab)	—AUTHORED→
@atiratree GitHub(opens GitHub in a new tab)	—REVIEWS→
@iterion GitHub(opens GitHub in a new tab)	—REVIEWS→
@ravig GitHub

2 nodes · 1 relations

KEP 2

Relations and who declared them
Relation	KEP	Status	Declared by
see also	KEP-19 CronJobs (previously ScheduledJobs)	implemented	none

How they connect

Shortest paths in the graph between this KEP and its SIG or one of its people, up to four hops.

Impact of change

Rows returned by the tool
Kep	Depth	Reached	By hop	Open pull requests	Hop	Keps	Feature gates	Sigs	People
{ "label": "KEP", "key": "keps/sig-apps/3140-TimeZone-support-in-CronJob", "title": "TimeZone support in CronJob", "url": "https://github.com/kubernetes/enhancements/tree/6ebe0a94771723b3f27cb4a757f0cc22f29e38a2/keps/sig-apps/3140-TimeZone-support-in-CronJob", "evidence_id": "5r54isas4ths", "number": 3140, "owning_sig": "sig-apps", "status": "implementable", "stage": "stable", "latest_milestone": "v1.27", "milestone_alpha": "v1.24", "milestone_beta": "v1.25", "milestone_stable": "v1.27", "creation_date": "2022-01-14", "metadata_invalid": false }	2	10	{ "1": { "keps": 1, "feature_gates": 1, "sigs": 1, "people": 2 }, "2": { "feature_gates": 1, "people": 4 } }	not in graph (merged pull requests only)	none	none	none	none	none
none	none	none	none	none	1	[ { "label": "KEP", "key": "keps/sig-apps/19-Graduate-CronJob-to-Stable", "title": "CronJobs (previously ScheduledJobs)", "url": "https://github.com/kubernetes/enhancements/tree/6ebe0a94771723b3f27cb4a757f0cc22f29e38a2/keps/sig-apps/19-Graduate-CronJob-to-Stable", "evidence_id": "slunbb6gppck", "number": 19, "owning_sig": "sig-apps", "status": "implemented", "stage": "stable", "latest_milestone": "v1.22", "milestone_alpha": "v1.4", "milestone_beta": "v1.8", "milestone_stable": "v1.21", "creation_date": "2019-04-18", "metadata_invalid": false } ]	[ { "label": "FeatureGate", "key": "CronJobTimeZone", "title": "CronJobTimeZone", "url": "https://github.com/kubernetes/enhancements/blob/6ebe0a94771723b3f27cb4a757f0cc22f29e38a2/keps/sig-apps/3140-TimeZone-support-in-CronJob/kep.yaml", "evidence_id": "tnry536rgvtj", "name": "CronJobTimeZone" } ]	[ { "label": "SIG", "key": "sig-apps", "title": "Apps", "url": "https://github.com/kubernetes/community/tree/440e496d3a172234d81728df1bfe43849b589adf/sig-apps", "evidence_id": "3xevdpgexdfq", "display_name": "Apps", "sig_label": "apps", "in_scope": true } ]	[ { "label": "Person", "key": "soltysh", "title": "soltysh", "url": "https://github.com/soltysh", "evidence_id": "wmji7yq7e2r3", "login": "soltysh", "is_bot": false }, { "label": "Person", "key": "janetkuo", "title": "janetkuo", "url": "https://github.com/janetkuo", "evidence_id": "2neu4h3gp2bm", "login": "janetkuo", "is_bot": false } ]
none	none	none	none	none	2	none	[ { "label": "FeatureGate", "key": "CronJobControllerV2", "title": "CronJobControllerV2", "url": "https://github.com/kubernetes/enhancements/blob/6ebe0a94771723b3f27cb4a757f0cc22f29e38a2/keps/sig-apps/19-Graduate-CronJob-to-Stable/kep.yaml", "evidence_id": "yq4izlew3h7o", "name": "CronJobControllerV2" } ]	none	[ { "label": "Person", "key": "barney-s", "title": "barney-s", "url": "https://github.com/barney-s", "evidence_id": "mrc2fr3imlkl", "login": "barney-s", "is_bot": false }, { "label": "Person", "key": "wojtek-t", "title": "wojtek-t", "url": "https://github.com/wojtek-t", "evidence_id": "wvpmhj7c3dox", "login": "wojtek-t", "is_bot": false }, { "label": "Person", "key": "liggitt", "title": "liggitt", "url": "https://github.com/liggitt", "evidence_id": "mjccccaftaj3", "login": "liggitt", "is_bot": false }, { "label": "Person", "key": "kow3ns", "title": "kow3ns", "url": "https://github.com/kow3ns", "evidence_id": "z26v6kilqc4a", "login": "kow3ns", "is_bot": false } ]

Rows returned by the tool
Kep	Depth	Reached	By hop	Open pull requests	Hop	Keps	Feature gates	Sigs	People
{ "label": "KEP", "key": "keps/sig-apps/3140-TimeZone-support-in-CronJob", "title": "TimeZone support in CronJob", "url": "https://github.com/kubernetes/enhancements/tree/6ebe0a94771723b3f27cb4a757f0cc22f29e38a2/keps/sig-apps/3140-TimeZone-support-in-CronJob", "evidence_id": "5r54isas4ths", "number": 3140, "owning_sig": "sig-apps", "status": "implementable", "stage": "stable", "latest_milestone": "v1.27", "milestone_alpha": "v1.24", "milestone_beta": "v1.25", "milestone_stable": "v1.27", "creation_date": "2022-01-14", "metadata_invalid": false }	2	10	{ "1": { "keps": 1, "feature_gates": 1, "sigs": 1, "people": 2 }, "2": { "feature_gates": 1, "people": 4 } }	not in graph (merged pull requests only)	none	none	none	none	none
none	none	none	none	none	1	[ { "label": "KEP", "key": "keps/sig-apps/19-Graduate-CronJob-to-Stable", "title": "CronJobs (previously ScheduledJobs)", "url": "https://github.com/kubernetes/enhancements/tree/6ebe0a94771723b3f27cb4a757f0cc22f29e38a2/keps/sig-apps/19-Graduate-CronJob-to-Stable", "evidence_id": "slunbb6gppck", "number": 19, "owning_sig": "sig-apps", "status": "implemented", "stage": "stable", "latest_milestone": "v1.22", "milestone_alpha": "v1.4", "milestone_beta": "v1.8", "milestone_stable": "v1.21", "creation_date": "2019-04-18", "metadata_invalid": false } ]	[ { "label": "FeatureGate", "key": "CronJobTimeZone", "title": "CronJobTimeZone", "url": "https://github.com/kubernetes/enhancements/blob/6ebe0a94771723b3f27cb4a757f0cc22f29e38a2/keps/sig-apps/3140-TimeZone-support-in-CronJob/kep.yaml", "evidence_id": "tnry536rgvtj", "name": "CronJobTimeZone" } ]	[ { "label": "SIG", "key": "sig-apps", "title": "Apps", "url": "https://github.com/kubernetes/community/tree/440e496d3a172234d81728df1bfe43849b589adf/sig-apps", "evidence_id": "3xevdpgexdfq", "display_name": "Apps", "sig_label": "apps", "in_scope": true } ]	[ { "label": "Person", "key": "soltysh", "title": "soltysh", "url": "https://github.com/soltysh", "evidence_id": "wmji7yq7e2r3", "login": "soltysh", "is_bot": false }, { "label": "Person", "key": "janetkuo", "title": "janetkuo", "url": "https://github.com/janetkuo", "evidence_id": "2neu4h3gp2bm", "login": "janetkuo", "is_bot": false } ]
none	none	none	none	none	2	none	[ { "label": "FeatureGate", "key": "CronJobControllerV2", "title": "CronJobControllerV2", "url": "https://github.com/kubernetes/enhancements/blob/6ebe0a94771723b3f27cb4a757f0cc22f29e38a2/keps/sig-apps/19-Graduate-CronJob-to-Stable/kep.yaml", "evidence_id": "yq4izlew3h7o", "name": "CronJobControllerV2" } ]	none	[ { "label": "Person", "key": "barney-s", "title": "barney-s", "url": "https://github.com/barney-s", "evidence_id": "mrc2fr3imlkl", "login": "barney-s", "is_bot": false }, { "label": "Person", "key": "wojtek-t", "title": "wojtek-t", "url": "https://github.com/wojtek-t", "evidence_id": "wvpmhj7c3dox", "login": "wojtek-t", "is_bot": false }, { "label": "Person", "key": "liggitt", "title": "liggitt", "url": "https://github.com/liggitt", "evidence_id": "mjccccaftaj3", "login": "liggitt", "is_bot": false }, { "label": "Person", "key": "kow3ns", "title": "kow3ns", "url": "https://github.com/kow3ns", "evidence_id": "z26v6kilqc4a", "login": "kow3ns", "is_bot": false } ]

Kep

Depth

Reached

By hop

Open pull requests

Hop

Keps

Feature gates

Sigs

People

{
  "label": "KEP",
  "key": "keps/sig-apps/3140-TimeZone-support-in-CronJob",
  "title": "TimeZone support in CronJob",
  "url": "https://github.com/kubernetes/enhancements/tree/6ebe0a94771723b3f27cb4a757f0cc22f29e38a2/keps/sig-apps/3140-TimeZone-support-in-CronJob",
  "evidence_id": "5r54isas4ths",
  "number": 3140,
  "owning_sig": "sig-apps",
  "status": "implementable",
  "stage": "stable",
  "latest_milestone": "v1.27",
  "milestone_alpha": "v1.24",
  "milestone_beta": "v1.25",
  "milestone_stable": "v1.27",
  "creation_date": "2022-01-14",
  "metadata_invalid": false
}

{
  "1": {
    "keps": 1,
    "feature_gates": 1,
    "sigs": 1,
    "people": 2
  },
  "2": {
    "feature_gates": 1,
    "people": 4
  }
}

not in graph (merged pull requests only)

[
  {
    "label": "KEP",
    "key": "keps/sig-apps/19-Graduate-CronJob-to-Stable",
    "title": "CronJobs (previously ScheduledJobs)",
    "url": "https://github.com/kubernetes/enhancements/tree/6ebe0a94771723b3f27cb4a757f0cc22f29e38a2/keps/sig-apps/19-Graduate-CronJob-to-Stable",
    "evidence_id": "slunbb6gppck",
    "number": 19,
    "owning_sig": "sig-apps",
    "status": "implemented",
    "stage": "stable",
    "latest_milestone": "v1.22",
    "milestone_alpha": "v1.4",
    "milestone_beta": "v1.8",
    "milestone_stable": "v1.21",
    "creation_date": "2019-04-18",
    "metadata_invalid": false
  }
]

[
  {
    "label": "FeatureGate",
    "key": "CronJobTimeZone",
    "title": "CronJobTimeZone",
    "url": "https://github.com/kubernetes/enhancements/blob/6ebe0a94771723b3f27cb4a757f0cc22f29e38a2/keps/sig-apps/3140-TimeZone-support-in-CronJob/kep.yaml",
    "evidence_id": "tnry536rgvtj",
    "name": "CronJobTimeZone"
  }
]

[
  {
    "label": "SIG",
    "key": "sig-apps",
    "title": "Apps",
    "url": "https://github.com/kubernetes/community/tree/440e496d3a172234d81728df1bfe43849b589adf/sig-apps",
    "evidence_id": "3xevdpgexdfq",
    "display_name": "Apps",
    "sig_label": "apps",
    "in_scope": true
  }
]

[
  {
    "label": "Person",
    "key": "soltysh",
    "title": "soltysh",
    "url": "https://github.com/soltysh",
    "evidence_id": "wmji7yq7e2r3",
    "login": "soltysh",
    "is_bot": false
  },
  {
    "label": "Person",
    "key": "janetkuo",
    "title": "janetkuo",
    "url": "https://github.com/janetkuo",
    "evidence_id": "2neu4h3gp2bm",
    "login": "janetkuo",
    "is_bot": false
  }
]

[
  {
    "label": "FeatureGate",
    "key": "CronJobControllerV2",
    "title": "CronJobControllerV2",
    "url": "https://github.com/kubernetes/enhancements/blob/6ebe0a94771723b3f27cb4a757f0cc22f29e38a2/keps/sig-apps/19-Graduate-CronJob-to-Stable/kep.yaml",
    "evidence_id": "yq4izlew3h7o",
    "name": "CronJobControllerV2"
  }
]

[
  {
    "label": "Person",
    "key": "barney-s",
    "title": "barney-s",
    "url": "https://github.com/barney-s",
    "evidence_id": "mrc2fr3imlkl",
    "login": "barney-s",
    "is_bot": false
  },
  {
    "label": "Person",
    "key": "wojtek-t",
    "title": "wojtek-t",
    "url": "https://github.com/wojtek-t",
    "evidence_id": "wvpmhj7c3dox",
    "login": "wojtek-t",
    "is_bot": false
  },
  {
    "label": "Person",
    "key": "liggitt",
    "title": "liggitt",
    "url": "https://github.com/liggitt",
    "evidence_id": "mjccccaftaj3",
    "login": "liggitt",
    "is_bot": false
  },
  {
    "label": "Person",
    "key": "kow3ns",
    "title": "kow3ns",
    "url": "https://github.com/kow3ns",
    "evidence_id": "z26v6kilqc4a",
    "login": "kow3ns",
    "is_bot": false
  }
]

MATCH (k:KEP {key: $key}) RETURN k LIMIT 1 ; MATCH (k:KEP {key: $key}) MATCH path = (k)-[:REPLACES|SUPERSEDED_BY|SEE_ALSO|GATED_BY*1..2]-(n) WHERE n <> k AND (n:KEP OR n:FeatureGate) AND all(x IN nodes(path)[1..-1] WHERE x <> k AND (x:KEP OR (x:FeatureGate AND NOT x.key IN $placeholders))) WITH n, path ORDER BY length(path), [x IN nodes(path) | x.key] WITH n, collect(path)[0] AS path RETURN n AS node, length(path) AS hop, path ORDER BY hop, n.key LIMIT 150 ; UNWIND $keys AS kk MATCH (k:KEP {key: kk}) RETURN k.key AS kep, [(k)-[r_0:OWNED_BY]->(s_0:SIG) WHERE coalesce(r_0.valid_to, $open) = $open | s_0] AS sigs, [(p_1:Person)-[r_1:AUTHORED]->(k) WHERE coalesce(r_1.valid_to, $open) = $open AND coalesce(p_1.is_bot, false) = false | p_1] AS authors, [(p_2:Person)-[r_2:APPROVES]->(k) WHERE coalesce(r_2.valid_to, $open) = $open AND coalesce(p_2.is_bot, false) = false | p_2] AS approvers, [(k)-[r_3:TRACKED_BY]->(i_3:Issue) WHERE coalesce(r_3.valid_to, $open) = $open AND i_3.state = 'open' | i_3] AS open_issues LIMIT 200

TimeZone support in CronJob

Facts

How they connect

Impact of change

Keyboard shortcuts

Everywhere

Go to a page

Ask

Search lists

KEP page

Findings table

How they connect

Impact of change

Hop 1

Hop 2

Impact of change

Impact of change

Hop 1

Hop 2