KEP-592keps/sig-apps/592-ttl-after-finish

TTL After Finished

implementedstablesig-appslatest v1.23

KEP on GitHub kep.yaml Ask about this KEP

We propose a TTL mechanism to limit the lifetime of finished resource objects, including Jobs and Pods, to make it easy for users to clean up old Jobs/Pods after they finish. The TTL timer starts when the Job/Pod finishes, and the finished Job/Pod will be cleaned up after the TTL expires.

Facts

Authors: @ahg-g @janetkuo @sahilvv
Approvers: @kow3ns
Reviewers: @tnozicka @enisoc
PRR approvers: @wojtek-tbeta@wojtek-tstable
Tracking issue: #592(opens GitHub in a new tab) closedcompletedclosed 2022-01-22 18:03 UTCsig/appsstage/stablekind/feature
Milestones: alpha v1.12beta v1.21stable v1.23
Participating SIGs: sig-api-machinery
Feature gates: TTLAfterFinished
Created / last updated: 2018-08-16 / none

Who decided each state, with the evidence.
Decided	Decision	Deciders	Evidence
2020-12-17 19:39 UTC	status_transition KEP-592 status set to provisional in PR #2196, approved by johnbelamaric; merged by automation (k8s-ci-robot) on 2020-12-17.	@wojtek-t author @johnbelamaric approve_command @johnbelamaric lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@5f128c7d78b27f56569f0e8a63178c746323497f(opens GitHub in a new tab) StatusChange status ∅ → provisional (2020-12-17)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#2196 Migrate some apps KEPs to new template(opens GitHub in a new tab) Comment kubernetes/enhancements/issues/comments/747653854(opens GitHub in a new tab)
2021-01-08 21:00 UTC	prr_approval wojtek-t gave the production readiness approval for KEP-592 at beta on 2021-01-08.	@wojtek-t prr_approver	Document 592.yaml(opens GitHub in a new tab)
2021-01-19 16:49 UTC	stage_graduation KEP-592 set milestone.alpha to v1.12 in PR #2246, approved by janetkuo, wojtek-t; merged by automation (k8s-ci-robot) on 2021-01-19.	@ahg-g author @wojtek-t approve_command @wojtek-t lgtm @janetkuo approver @k8s-ci-robot merger	Commit kubernetes/enhancements@281068e1bf4964c84fcfef272455c609932a1f90(opens GitHub in a new tab) StatusChange milestone.alpha ∅ → v1.12 (2021-01-08)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#2246 Updates the ttl-to-finished KEP to graduate the feature to Beta.(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/568648488
2021-01-19 16:49 UTC	stage_graduation KEP-592 set milestone.beta to v1.21 in PR #2246, approved by janetkuo, wojtek-t; merged by automation (k8s-ci-robot) on 2021-01-19.	@ahg-g author @wojtek-t approve_command @wojtek-t lgtm @janetkuo approver @k8s-ci-robot merger	Commit kubernetes/enhancements@281068e1bf4964c84fcfef272455c609932a1f90(opens GitHub in a new tab) StatusChange milestone.beta ∅ → v1.21 (2021-01-08)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#2246 Updates the ttl-to-finished KEP to graduate the feature to Beta.(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/568648488
2021-01-19 16:49 UTC	stage_graduation KEP-592 set milestone.stable to v1.23 in PR #2246, approved by janetkuo, wojtek-t; merged by automation (k8s-ci-robot) on 2021-01-19.	@ahg-g author @wojtek-t approve_command @wojtek-t lgtm @janetkuo approver @k8s-ci-robot merger	Commit kubernetes/enhancements@281068e1bf4964c84fcfef272455c609932a1f90(opens GitHub in a new tab) StatusChange milestone.stable ∅ → v1.23 (2021-01-08)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#2246 Updates the ttl-to-finished KEP to graduate the feature to Beta.(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/568648488
2021-01-19 16:49 UTC	stage_graduation KEP-592 graduated to beta in PR #2246, approved by janetkuo, wojtek-t; merged by automation (k8s-ci-robot) on 2021-01-19.	@ahg-g author @wojtek-t approve_command @wojtek-t lgtm @janetkuo approver @k8s-ci-robot merger	Commit kubernetes/enhancements@281068e1bf4964c84fcfef272455c609932a1f90(opens GitHub in a new tab) StatusChange stage ∅ → beta (2021-01-08)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#2246 Updates the ttl-to-finished KEP to graduate the feature to Beta.(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/568648488
2021-01-19 16:49 UTC	status_transition KEP-592 status changed from provisional to implementable in PR #2246, approved by janetkuo, wojtek-t; merged by automation (k8s-ci-robot) on 2021-01-19.	@ahg-g author @wojtek-t approve_command @wojtek-t lgtm @janetkuo approver @k8s-ci-robot merger	Commit kubernetes/enhancements@281068e1bf4964c84fcfef272455c609932a1f90(opens GitHub in a new tab) StatusChange status provisional → implementable (2021-01-08)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#2246 Updates the ttl-to-finished KEP to graduate the feature to Beta.(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/568648488
2021-07-27 17:37 UTC	prr_approval wojtek-t gave the production readiness approval for KEP-592 at stable on 2021-07-27.	@wojtek-t prr_approver	Document 592.yaml(opens GitHub in a new tab)
2021-08-30 18:18 UTC	milestone_retarget KEP-592 latest-milestone moved from v1.21 to v1.23 in PR #2841, approved by ravisantoshgudimetla, soltysh; merged by automation (k8s-ci-robot) on 2021-08-30.	@soltysh approver @soltysh approve_command @sahilvv author @ravisantoshgudimetla approver @ravisantoshgudimetla lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@ee3a716a89c3aa0a16891447a46123bf9bd564f4(opens GitHub in a new tab) StatusChange latest_milestone v1.21 → v1.23 (2021-07-27)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#2841 KEP-592: Graduate TTL after finish to stable
2021-08-30 18:18 UTC	stage_graduation KEP-592 graduated to stable from beta in PR #2841, approved by ravisantoshgudimetla, soltysh; merged by automation (k8s-ci-robot) on 2021-08-30.	@soltysh approver @soltysh approve_command @sahilvv author @ravisantoshgudimetla approver @ravisantoshgudimetla lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@ee3a716a89c3aa0a16891447a46123bf9bd564f4(opens GitHub in a new tab) StatusChange stage beta → stable (2021-07-27)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#2841 KEP-592: Graduate TTL after finish to stable
2022-01-21 19:25 UTC	status_transition KEP-592 status changed from implementable to implemented in PR #3147, approved by soltysh; merged by automation (k8s-ci-robot) on 2022-01-21.	@soltysh approver @soltysh approve_command @soltysh lgtm @sahilvv author @k8s-ci-robot merger	Commit kubernetes/enhancements@5c74217e33a46d6fbbcef06a4f12cae049d49c92(opens GitHub in a new tab) StatusChange status implementable → implemented (2022-01-15)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#3147 Mark TTL-after-finish KEP-592 to implemented(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/859942508

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

Status history
At	Kind	Field	Change	Actor	Evidence
2018-07-23 21:23 UTC	milestone	milestone milestoned	none → v1.12	@janetkuo	source(opens GitHub in a new tab)
2018-07-23 21:23 UTC	label	sig/apps added	none → sig/apps	@janetkuo	source

Relationships as stored, Person → KEP, from kep.yaml(opens GitHub in a new tab)
Person	Relationship
@ahg-g GitHub(opens GitHub in a new tab)	—AUTHORED→
@janetkuo GitHub(opens GitHub in a new tab)	—AUTHORED→
@sahilvv GitHub(opens GitHub in a new tab)	—AUTHORED→
@tnozicka 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	Feature gates	Sigs	People
{ "label": "KEP", "key": "keps/sig-apps/592-ttl-after-finish", "title": "TTL After Finished", "url": "https://github.com/kubernetes/enhancements/tree/6ebe0a94771723b3f27cb4a757f0cc22f29e38a2/keps/sig-apps/592-ttl-after-finish", "evidence_id": "ozmb6ppi2i4j", "number": 592, "owning_sig": "sig-apps", "status": "implemented", "stage": "stable", "latest_milestone": "v1.23", "milestone_alpha": "v1.12", "milestone_beta": "v1.21", "milestone_stable": "v1.23", "creation_date": "2018-08-16", "metadata_invalid": false }	2	6	{ "1": { "feature_gates": 1, "sigs": 1, "people": 4 } }	not in graph (merged pull requests only)	none	none	none	none
none	none	none	none	none	1	[ { "label": "FeatureGate", "key": "TTLAfterFinished", "title": "TTLAfterFinished", "url": "https://github.com/kubernetes/enhancements/blob/6ebe0a94771723b3f27cb4a757f0cc22f29e38a2/keps/sig-apps/592-ttl-after-finish/kep.yaml", "evidence_id": "spzlcw5jtrbi", "name": "TTLAfterFinished" } ]	[ { "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": "ahg-g", "title": "ahg-g", "url": "https://github.com/ahg-g", "evidence_id": "dkcsjhxbas7w", "login": "ahg-g", "is_bot": false }, { "label": "Person", "key": "janetkuo", "title": "janetkuo", "url": "https://github.com/janetkuo", "evidence_id": "2neu4h3gp2bm", "login": "janetkuo", "is_bot": false }, { "label": "Person", "key": "sahilvv", "title": "sahilvv", "url": "https://github.com/sahilvv", "evidence_id": "xqdb4l4swfsl", "login": "sahilvv", "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	Feature gates	Sigs	People
{ "label": "KEP", "key": "keps/sig-apps/592-ttl-after-finish", "title": "TTL After Finished", "url": "https://github.com/kubernetes/enhancements/tree/6ebe0a94771723b3f27cb4a757f0cc22f29e38a2/keps/sig-apps/592-ttl-after-finish", "evidence_id": "ozmb6ppi2i4j", "number": 592, "owning_sig": "sig-apps", "status": "implemented", "stage": "stable", "latest_milestone": "v1.23", "milestone_alpha": "v1.12", "milestone_beta": "v1.21", "milestone_stable": "v1.23", "creation_date": "2018-08-16", "metadata_invalid": false }	2	6	{ "1": { "feature_gates": 1, "sigs": 1, "people": 4 } }	not in graph (merged pull requests only)	none	none	none	none
none	none	none	none	none	1	[ { "label": "FeatureGate", "key": "TTLAfterFinished", "title": "TTLAfterFinished", "url": "https://github.com/kubernetes/enhancements/blob/6ebe0a94771723b3f27cb4a757f0cc22f29e38a2/keps/sig-apps/592-ttl-after-finish/kep.yaml", "evidence_id": "spzlcw5jtrbi", "name": "TTLAfterFinished" } ]	[ { "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": "ahg-g", "title": "ahg-g", "url": "https://github.com/ahg-g", "evidence_id": "dkcsjhxbas7w", "login": "ahg-g", "is_bot": false }, { "label": "Person", "key": "janetkuo", "title": "janetkuo", "url": "https://github.com/janetkuo", "evidence_id": "2neu4h3gp2bm", "login": "janetkuo", "is_bot": false }, { "label": "Person", "key": "sahilvv", "title": "sahilvv", "url": "https://github.com/sahilvv", "evidence_id": "xqdb4l4swfsl", "login": "sahilvv", "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

Feature gates

Sigs

People

{
  "label": "KEP",
  "key": "keps/sig-apps/592-ttl-after-finish",
  "title": "TTL After Finished",
  "url": "https://github.com/kubernetes/enhancements/tree/6ebe0a94771723b3f27cb4a757f0cc22f29e38a2/keps/sig-apps/592-ttl-after-finish",
  "evidence_id": "ozmb6ppi2i4j",
  "number": 592,
  "owning_sig": "sig-apps",
  "status": "implemented",
  "stage": "stable",
  "latest_milestone": "v1.23",
  "milestone_alpha": "v1.12",
  "milestone_beta": "v1.21",
  "milestone_stable": "v1.23",
  "creation_date": "2018-08-16",
  "metadata_invalid": false
}

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

not in graph (merged pull requests only)

[
  {
    "label": "FeatureGate",
    "key": "TTLAfterFinished",
    "title": "TTLAfterFinished",
    "url": "https://github.com/kubernetes/enhancements/blob/6ebe0a94771723b3f27cb4a757f0cc22f29e38a2/keps/sig-apps/592-ttl-after-finish/kep.yaml",
    "evidence_id": "spzlcw5jtrbi",
    "name": "TTLAfterFinished"
  }
]

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

TTL After Finished

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

Impact of change

Impact of change

Hop 1