KEP-19keps/sig-apps/19-Graduate-CronJob-to-Stable

CronJobs (previously ScheduledJobs)

implementedstablesig-appslatest v1.22

KEP on GitHub kep.yaml Ask about this KEP

CronJob is a Kubernetes API that creates Job object on a schedule specified by a cron spec. It is in beta status since v1.8, and currently if it does not progress before v1.22, it will be marked deprecated with target release for removal being v1.25. This document lays out the plan to promote it to stable.

Facts

Authors: @soltysh @barney-s
Approvers: @wojtek-t @liggitt @kow3ns @janetkuo
Reviewers: @wojtek-t @liggitt @kow3ns @janetkuo
PRR approvers: @wojtek-tstable
Tracking issue: #19(opens GitHub in a new tab) closedcompletedclosed 2022-01-09 04:38 UTCsig/appsstage/stablekind/feature
Milestones: alpha v1.4beta v1.8stable v1.21
Participating SIGs: sig-scalability
Feature gates: CronJobControllerV2
Created / last updated: 2019-04-18 / none

Who decided each state, with the evidence.
Decided	Decision	Deciders	Evidence
2020-10-02 18:28 UTC	stage_graduation KEP-19 set milestone.alpha to v1.4 in PR #1996, approved by janetkuo; merged by automation (k8s-ci-robot) on 2020-10-02.	@wojtek-t lgtm @soltysh author @janetkuo approver @janetkuo approve_command @k8s-ci-robot merger	Commit kubernetes/enhancements@4921704140fabb9c616607df44e8c1fd6ea96541(opens GitHub in a new tab) StatusChange milestone.alpha ∅ → v1.4 (2019-04-20)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#1996 KEP for Graduating CronJob to GA(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/501272513(opens GitHub in a new tab) Comment kubernetes/enhancements/issues/comments/702889011(opens GitHub in a new tab) Comment kubernetes/enhancements/issues/comments/702826271(opens GitHub in a new tab) Comment kubernetes/enhancements/issues/comments/701364520(opens GitHub in a new tab)
2020-10-02 18:28 UTC	stage_graduation KEP-19 set milestone.beta to v1.8 in PR #1996, approved by janetkuo; merged by automation (k8s-ci-robot) on 2020-10-02.	@wojtek-t lgtm @soltysh author @janetkuo approver @janetkuo approve_command @k8s-ci-robot merger	Commit kubernetes/enhancements@4921704140fabb9c616607df44e8c1fd6ea96541(opens GitHub in a new tab) StatusChange milestone.beta ∅ → v1.8 (2019-04-20)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#1996 KEP for Graduating CronJob to GA(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/501272513
2020-10-02 18:28 UTC	stage_graduation KEP-19 set milestone.stable to v1.21 in PR #1996, approved by janetkuo; merged by automation (k8s-ci-robot) on 2020-10-02.	@wojtek-t lgtm @soltysh author @janetkuo approver @janetkuo approve_command @k8s-ci-robot merger	Commit kubernetes/enhancements@4921704140fabb9c616607df44e8c1fd6ea96541(opens GitHub in a new tab) StatusChange milestone.stable ∅ → v1.21 (2019-04-20)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#1996 KEP for Graduating CronJob to GA(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/501272513
2020-10-02 18:28 UTC	stage_graduation KEP-19 graduated to beta in PR #1996, approved by janetkuo; merged by automation (k8s-ci-robot) on 2020-10-02.	@wojtek-t lgtm @soltysh author @janetkuo approver @janetkuo approve_command @k8s-ci-robot merger	Commit kubernetes/enhancements@4921704140fabb9c616607df44e8c1fd6ea96541(opens GitHub in a new tab) StatusChange stage ∅ → beta (2019-04-20)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#1996 KEP for Graduating CronJob to GA(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/501272513
2020-10-02 18:28 UTC	status_transition KEP-19 status set to implementable in PR #1996, approved by janetkuo; merged by automation (k8s-ci-robot) on 2020-10-02.	@wojtek-t lgtm @soltysh author @janetkuo approver @janetkuo approve_command @k8s-ci-robot merger	Commit kubernetes/enhancements@4921704140fabb9c616607df44e8c1fd6ea96541(opens GitHub in a new tab) StatusChange status ∅ → implementable (2019-04-20)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#1996 KEP for Graduating CronJob to GA(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/501272513
2021-02-01 18:33 UTC	prr_approval wojtek-t gave the production readiness approval for KEP-19 at stable on 2021-02-01.	@wojtek-t prr_approver	Document 19.yaml(opens GitHub in a new tab)
2021-02-02 23:44 UTC	milestone_retarget KEP-19 latest-milestone moved from v1.20 to v1.21 in PR #2396, approved by janetkuo; merged by automation (k8s-ci-robot) on 2021-02-02.	@wojtek-t lgtm @soltysh author @janetkuo approver @k8s-ci-robot merger	Commit kubernetes/enhancements@29e77efa4a1fabfec737c835ac477e5db298ea18(opens GitHub in a new tab) StatusChange latest_milestone v1.20 → v1.21 (2021-02-01)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#2396 KEP-19: Graduate CronJob to stable: update stage and milestone(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/581867595
2021-02-02 23:44 UTC	stage_graduation KEP-19 graduated to stable from beta in PR #2396, approved by janetkuo; merged by automation (k8s-ci-robot) on 2021-02-02.	@wojtek-t lgtm @soltysh author @janetkuo approver @k8s-ci-robot merger	Commit kubernetes/enhancements@29e77efa4a1fabfec737c835ac477e5db298ea18(opens GitHub in a new tab) StatusChange stage beta → stable (2021-02-01)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#2396 KEP-19: Graduate CronJob to stable: update stage and milestone(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/581867595
2021-06-09 16:41 UTC	milestone_retarget KEP-19 latest-milestone moved from v1.21 to v1.22 in PR #2778, approved by jameslaverack; merged by automation (k8s-ci-robot) on 2021-06-09.	@dims author @jameslaverack approver @jameslaverack lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@974f189a25fa725560077da0adfbaf47118f7a47(opens GitHub in a new tab) StatusChange latest_milestone v1.21 → v1.22 (2021-06-09)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#2778 Fix kep.yaml for cronjob KEP for 1.22(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/679899332
2021-09-01 14:05 UTC	status_transition KEP-19 status changed from implementable to implemented in PR #2925; merged by automation (k8s-ci-robot) on 2021-09-01.	@wojtek-t lgtm @soltysh author @k8s-ci-robot merger	Commit kubernetes/enhancements@90b32eed746feca54baa977c276fc72c50406bbb(opens GitHub in a new tab) StatusChange status implementable → implemented (2021-09-01)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#2925 Mark KEP-19 (CronJobs) implemented(opens GitHub in a new tab) Comment kubernetes/enhancements/issues/comments/910317603(opens GitHub in a new tab)

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

Status history
At	Kind	Field	Change	Actor	Evidence
2016-07-18 20:21 UTC	milestone	milestone milestoned	none → v1.4	@idvoretskyi	source(opens GitHub in a new tab)
2016-07-18 20:21 UTC	milestone	milestone milestoned	v1.4 → v1.4	@idvoretskyi	source(opens GitHub in a new tab)

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→
@barney-s GitHub(opens GitHub in a new tab)	—AUTHORED→
@wojtek-t GitHub(opens GitHub in a new tab)	—REVIEWS→
@liggitt GitHub

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/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 }	2	10	{ "1": { "keps": 1, "feature_gates": 1, "sigs": 1, "people": 6 }, "2": { "feature_gates": 1 } }	not in graph (merged pull requests only)	none	none	none	none	none
none	none	none	none	none	1	[ { "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 } ]	[ { "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": "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": "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 }, { "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": "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" } ]	none	none

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/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 }	2	10	{ "1": { "keps": 1, "feature_gates": 1, "sigs": 1, "people": 6 }, "2": { "feature_gates": 1 } }	not in graph (merged pull requests only)	none	none	none	none	none
none	none	none	none	none	1	[ { "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 } ]	[ { "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": "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": "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 }, { "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": "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" } ]	none	none

Kep

Depth

Reached

By hop

Open pull requests

Hop

Keps

Feature gates

Sigs

People

{
  "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
}

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

not in graph (merged pull requests only)

[
  {
    "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
  }
]

[
  {
    "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": "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": "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
  },
  {
    "label": "Person",
    "key": "janetkuo",
    "title": "janetkuo",
    "url": "https://github.com/janetkuo",
    "evidence_id": "2neu4h3gp2bm",
    "login": "janetkuo",
    "is_bot": 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"
  }
]

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

CronJobs (previously ScheduledJobs)

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