KEP-3998keps/sig-apps/3998-job-success-completion-policy

Job success/completion policy

implementedstablesig-appslatest v1.33

KEP on GitHub kep.yaml Ask about this KEP

This KEP extends the Job API to allow setting conditions under which an Indexed Job can be declared as succeeded.

Facts

Authors: @tenzen-y
Approvers: @wojtek-t @soltysh
Reviewers: @kannon92 @alculquicondor @mimowo @deads2k @vsoch
PRR approvers: @wojtek-talpha@wojtek-tbeta@wojtek-tstable
Tracking issue: #3998(opens GitHub in a new tab) closedcompletedclosed 2025-05-23 16:20 UTCmilestone v1.33sig/appsstage/stablewg/batch
Milestones: alpha v1.30beta v1.31stable v1.33
Participating SIGs: none
Feature gates: JobSuccessPolicy
Created / last updated: 2023-06-05 / none

Who decided each state, with the evidence.
Decided	Decision	Deciders	Evidence
2024-02-08 19:57 UTC	prr_approval wojtek-t gave the production readiness approval for KEP-3998 at alpha on 2024-02-08.	@wojtek-t prr_approver	Document 3998.yaml(opens GitHub in a new tab)
2024-02-08 19:57 UTC	stage_graduation KEP-3998 set milestone.alpha to v1.30 in PR #4062, approved by soltysh; merged by automation (k8s-ci-robot) on 2024-02-08.	@alculquicondor lgtm @tenzen-y author @wojtek-t lgtm @soltysh approver @soltysh approve_command @k8s-ci-robot merger	Commit kubernetes/enhancements@6d05986832e88de80193558cd97a08d3afbe3381(opens GitHub in a new tab) StatusChange milestone.alpha ∅ → v1.30 (2024-02-08)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#4062 KEP-3998: Job success/completion policy(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/1871136510(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/1868060542(opens GitHub in a new tab) Comment kubernetes/enhancements/issues/comments/1934827280(opens GitHub in a new tab)
2024-02-08 19:57 UTC	stage_graduation KEP-3998 graduated to alpha in PR #4062, approved by soltysh; merged by automation (k8s-ci-robot) on 2024-02-08.	@alculquicondor lgtm @tenzen-y author @wojtek-t lgtm @soltysh approver @soltysh approve_command @k8s-ci-robot merger	Commit kubernetes/enhancements@6d05986832e88de80193558cd97a08d3afbe3381(opens GitHub in a new tab) StatusChange stage ∅ → alpha (2024-02-08)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#4062 KEP-3998: Job success/completion policy(opens GitHub in a new tab)
2024-02-08 19:57 UTC	status_transition KEP-3998 status set to implementable in PR #4062, approved by soltysh; merged by automation (k8s-ci-robot) on 2024-02-08.	@alculquicondor lgtm @tenzen-y author @wojtek-t lgtm @soltysh approver @soltysh approve_command @k8s-ci-robot merger	Commit kubernetes/enhancements@6d05986832e88de80193558cd97a08d3afbe3381(opens GitHub in a new tab) StatusChange status ∅ → implementable (2024-02-08)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#4062 KEP-3998: Job success/completion policy(opens GitHub in a new tab)
2024-06-06 12:54 UTC	prr_approval wojtek-t gave the production readiness approval for KEP-3998 at beta on 2024-06-06.	@wojtek-t prr_approver	Document 3998.yaml(opens GitHub in a new tab)
2024-06-11 12:52 UTC	milestone_retarget KEP-3998 latest-milestone moved from v1.30 to v1.31 in PR #4702, approved by soltysh; merged by automation (k8s-ci-robot) on 2024-06-11.	@tenzen-y author @mimowo lgtm @soltysh approver @soltysh approve_command @k8s-ci-robot merger	Commit kubernetes/enhancements@6e2ddd3a838a566029f69e5427141a0b9c0c1286(opens GitHub in a new tab) StatusChange latest_milestone v1.30 → v1.31 (2024-06-06)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#4702 KEP-3998: Graduate Job SuccessPolicy to Beta(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/2110137697
2024-06-11 12:52 UTC	stage_graduation KEP-3998 set milestone.beta to v1.31 in PR #4702, approved by soltysh; merged by automation (k8s-ci-robot) on 2024-06-11.	@tenzen-y author @mimowo lgtm @soltysh approver @soltysh approve_command @k8s-ci-robot merger	Commit kubernetes/enhancements@6e2ddd3a838a566029f69e5427141a0b9c0c1286(opens GitHub in a new tab) StatusChange milestone.beta ∅ → v1.31 (2024-06-06)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#4702 KEP-3998: Graduate Job SuccessPolicy to Beta(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/2110137697
2024-06-11 12:52 UTC	stage_graduation KEP-3998 graduated to beta from alpha in PR #4702, approved by soltysh; merged by automation (k8s-ci-robot) on 2024-06-11.	@tenzen-y author @mimowo lgtm @soltysh approver @soltysh approve_command @k8s-ci-robot merger	Commit kubernetes/enhancements@6e2ddd3a838a566029f69e5427141a0b9c0c1286(opens GitHub in a new tab) StatusChange stage alpha → beta (2024-06-06)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#4702 KEP-3998: Graduate Job SuccessPolicy to Beta(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/2110137697
2025-02-10 09:33 UTC	milestone_retarget KEP-3998 latest-milestone moved from v1.31 to v1.33 in PR #5148, approved by soltysh; merged by automation (k8s-ci-robot) on 2025-02-10.	@tenzen-y author @soltysh approver @soltysh approve_command @soltysh lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@d9d64116aa1d7a46f16bddca5cd65f7ed9da1883(opens GitHub in a new tab) StatusChange latest_milestone v1.31 → v1.33 (2025-02-10)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#5148 KEP-3998: Graduate JobSuccessPolicy to GA(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/2602042605
2025-02-10 09:33 UTC	prr_approval wojtek-t gave the production readiness approval for KEP-3998 at stable on 2025-02-10.	@wojtek-t prr_approver	Document 3998.yaml(opens GitHub in a new tab)
2025-02-10 09:33 UTC	stage_graduation KEP-3998 set milestone.stable to v1.33 in PR #5148, approved by soltysh; merged by automation (k8s-ci-robot) on 2025-02-10.	@tenzen-y author @soltysh approver @soltysh approve_command @soltysh lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@d9d64116aa1d7a46f16bddca5cd65f7ed9da1883(opens GitHub in a new tab) StatusChange milestone.stable ∅ → v1.33 (2025-02-10)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#5148 KEP-3998: Graduate JobSuccessPolicy to GA(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/2602042605
2025-02-10 09:33 UTC	stage_graduation KEP-3998 graduated to stable from beta in PR #5148, approved by soltysh; merged by automation (k8s-ci-robot) on 2025-02-10.	@tenzen-y author @soltysh approver @soltysh approve_command @soltysh lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@d9d64116aa1d7a46f16bddca5cd65f7ed9da1883(opens GitHub in a new tab) StatusChange stage beta → stable (2025-02-10)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#5148 KEP-3998: Graduate JobSuccessPolicy to GA(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/2602042605
2025-05-23 16:00 UTC	status_transition KEP-3998 status changed from implementable to implemented in PR #5250, approved by soltysh; merged by automation (k8s-ci-robot) on 2025-05-23.	@kannon92 lgtm @tenzen-y author @soltysh approver @soltysh approve_command @soltysh lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@39b9707a6653ec9e1a04d06699158e41161ce912(opens GitHub in a new tab) StatusChange status implementable → implemented (2025-04-16)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#5250 KEP-3998: Update JobSuccessPolicy feature Status(opens GitHub in a new tab)

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

Status history
At	Kind	Field	Change	Actor	Evidence
2023-05-12 06:25 UTC	label	sig/apps added	none → sig/apps	@k8s-ci-robot	source(opens GitHub in a new tab)
2023-05-12 06:25 UTC	label	wg/batch added	none → wg/batch	@k8s-ci-robot	source

Relationships as stored, Person → KEP, from kep.yaml(opens GitHub in a new tab)
Person	Relationship
@tenzen-y GitHub(opens GitHub in a new tab)	—AUTHORED→
@kannon92 GitHub(opens GitHub in a new tab)	—REVIEWS→
@alculquicondor GitHub(opens GitHub in a new tab)	—REVIEWS→
@mimowo

2 nodes · 1 relations

KEP 2

Relations and who declared them
Relation	KEP	Status	Declared by
see also	KEP-4368 Job API managed-by label	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/3998-job-success-completion-policy", "title": "Job success/completion policy", "url": "https://github.com/kubernetes/enhancements/tree/5b503a75369bdfdd494a2c2c72107a41bf6dd1a8/keps/sig-apps/3998-job-success-completion-policy", "evidence_id": "slryvvyezkb6", "number": 3998, "owning_sig": "sig-apps", "status": "implemented", "stage": "stable", "latest_milestone": "v1.33", "milestone_alpha": "v1.30", "milestone_beta": "v1.31", "milestone_stable": "v1.33", "creation_date": "2023-06-05", "metadata_invalid": false }	2	9	{ "1": { "keps": 1, "feature_gates": 1, "sigs": 1, "people": 3 }, "2": { "feature_gates": 2, "people": 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/4368-support-managed-by-for-batch-jobs", "title": "Job API managed-by label", "url": "https://github.com/kubernetes/enhancements/tree/5b503a75369bdfdd494a2c2c72107a41bf6dd1a8/keps/sig-apps/4368-support-managed-by-for-batch-jobs", "evidence_id": "mywkjxijgyif", "number": 4368, "owning_sig": "sig-apps", "status": "implemented", "stage": "stable", "latest_milestone": "v1.35", "milestone_alpha": "v1.30", "milestone_beta": "v1.32", "milestone_stable": "v1.35", "creation_date": "2023-12-20", "metadata_invalid": false } ]	[ { "label": "FeatureGate", "key": "JobSuccessPolicy", "title": "JobSuccessPolicy", "url": "https://github.com/kubernetes/enhancements/blob/5b503a75369bdfdd494a2c2c72107a41bf6dd1a8/keps/sig-apps/3998-job-success-completion-policy/kep.yaml", "evidence_id": "5n6j733gnckv", "name": "JobSuccessPolicy" } ]	[ { "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": "tenzen-y", "title": "tenzen-y", "url": "https://github.com/tenzen-y", "evidence_id": "644aaxs3e3ub", "login": "tenzen-y", "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": "soltysh", "title": "soltysh", "url": "https://github.com/soltysh", "evidence_id": "wmji7yq7e2r3", "login": "soltysh", "is_bot": false } ]
none	none	none	none	none	2	none	[ { "label": "FeatureGate", "key": "JobManagedBy", "title": "JobManagedBy", "url": "https://github.com/kubernetes/enhancements/blob/5b503a75369bdfdd494a2c2c72107a41bf6dd1a8/keps/sig-apps/4368-support-managed-by-for-batch-jobs/kep.yaml", "evidence_id": "mtg76efem3cl", "name": "JobManagedBy" }, { "label": "FeatureGate", "key": "JobManagedByLabel", "title": "JobManagedByLabel", "url": "https://github.com/kubernetes/enhancements/blob/95b875b9db703fdf6e0a8e78879f07c5684a5424/keps/sig-apps/4368-support-managed-by-label-for-batch-jobs/kep.yaml", "evidence_id": "qeezqgjltrjp", "name": "JobManagedByLabel" } ]	none	[ { "label": "Person", "key": "mimowo", "title": "mimowo", "url": "https://github.com/mimowo", "evidence_id": "qchqbsknnhjf", "login": "mimowo", "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/3998-job-success-completion-policy", "title": "Job success/completion policy", "url": "https://github.com/kubernetes/enhancements/tree/5b503a75369bdfdd494a2c2c72107a41bf6dd1a8/keps/sig-apps/3998-job-success-completion-policy", "evidence_id": "slryvvyezkb6", "number": 3998, "owning_sig": "sig-apps", "status": "implemented", "stage": "stable", "latest_milestone": "v1.33", "milestone_alpha": "v1.30", "milestone_beta": "v1.31", "milestone_stable": "v1.33", "creation_date": "2023-06-05", "metadata_invalid": false }	2	9	{ "1": { "keps": 1, "feature_gates": 1, "sigs": 1, "people": 3 }, "2": { "feature_gates": 2, "people": 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/4368-support-managed-by-for-batch-jobs", "title": "Job API managed-by label", "url": "https://github.com/kubernetes/enhancements/tree/5b503a75369bdfdd494a2c2c72107a41bf6dd1a8/keps/sig-apps/4368-support-managed-by-for-batch-jobs", "evidence_id": "mywkjxijgyif", "number": 4368, "owning_sig": "sig-apps", "status": "implemented", "stage": "stable", "latest_milestone": "v1.35", "milestone_alpha": "v1.30", "milestone_beta": "v1.32", "milestone_stable": "v1.35", "creation_date": "2023-12-20", "metadata_invalid": false } ]	[ { "label": "FeatureGate", "key": "JobSuccessPolicy", "title": "JobSuccessPolicy", "url": "https://github.com/kubernetes/enhancements/blob/5b503a75369bdfdd494a2c2c72107a41bf6dd1a8/keps/sig-apps/3998-job-success-completion-policy/kep.yaml", "evidence_id": "5n6j733gnckv", "name": "JobSuccessPolicy" } ]	[ { "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": "tenzen-y", "title": "tenzen-y", "url": "https://github.com/tenzen-y", "evidence_id": "644aaxs3e3ub", "login": "tenzen-y", "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": "soltysh", "title": "soltysh", "url": "https://github.com/soltysh", "evidence_id": "wmji7yq7e2r3", "login": "soltysh", "is_bot": false } ]
none	none	none	none	none	2	none	[ { "label": "FeatureGate", "key": "JobManagedBy", "title": "JobManagedBy", "url": "https://github.com/kubernetes/enhancements/blob/5b503a75369bdfdd494a2c2c72107a41bf6dd1a8/keps/sig-apps/4368-support-managed-by-for-batch-jobs/kep.yaml", "evidence_id": "mtg76efem3cl", "name": "JobManagedBy" }, { "label": "FeatureGate", "key": "JobManagedByLabel", "title": "JobManagedByLabel", "url": "https://github.com/kubernetes/enhancements/blob/95b875b9db703fdf6e0a8e78879f07c5684a5424/keps/sig-apps/4368-support-managed-by-label-for-batch-jobs/kep.yaml", "evidence_id": "qeezqgjltrjp", "name": "JobManagedByLabel" } ]	none	[ { "label": "Person", "key": "mimowo", "title": "mimowo", "url": "https://github.com/mimowo", "evidence_id": "qchqbsknnhjf", "login": "mimowo", "is_bot": false } ]

Kep

Depth

Reached

By hop

Open pull requests

Hop

Keps

Feature gates

Sigs

People

{
  "label": "KEP",
  "key": "keps/sig-apps/3998-job-success-completion-policy",
  "title": "Job success/completion policy",
  "url": "https://github.com/kubernetes/enhancements/tree/5b503a75369bdfdd494a2c2c72107a41bf6dd1a8/keps/sig-apps/3998-job-success-completion-policy",
  "evidence_id": "slryvvyezkb6",
  "number": 3998,
  "owning_sig": "sig-apps",
  "status": "implemented",
  "stage": "stable",
  "latest_milestone": "v1.33",
  "milestone_alpha": "v1.30",
  "milestone_beta": "v1.31",
  "milestone_stable": "v1.33",
  "creation_date": "2023-06-05",
  "metadata_invalid": false
}

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

not in graph (merged pull requests only)

[
  {
    "label": "KEP",
    "key": "keps/sig-apps/4368-support-managed-by-for-batch-jobs",
    "title": "Job API managed-by label",
    "url": "https://github.com/kubernetes/enhancements/tree/5b503a75369bdfdd494a2c2c72107a41bf6dd1a8/keps/sig-apps/4368-support-managed-by-for-batch-jobs",
    "evidence_id": "mywkjxijgyif",
    "number": 4368,
    "owning_sig": "sig-apps",
    "status": "implemented",
    "stage": "stable",
    "latest_milestone": "v1.35",
    "milestone_alpha": "v1.30",
    "milestone_beta": "v1.32",
    "milestone_stable": "v1.35",
    "creation_date": "2023-12-20",
    "metadata_invalid": false
  }
]

[
  {
    "label": "FeatureGate",
    "key": "JobSuccessPolicy",
    "title": "JobSuccessPolicy",
    "url": "https://github.com/kubernetes/enhancements/blob/5b503a75369bdfdd494a2c2c72107a41bf6dd1a8/keps/sig-apps/3998-job-success-completion-policy/kep.yaml",
    "evidence_id": "5n6j733gnckv",
    "name": "JobSuccessPolicy"
  }
]

[
  {
    "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": "tenzen-y",
    "title": "tenzen-y",
    "url": "https://github.com/tenzen-y",
    "evidence_id": "644aaxs3e3ub",
    "login": "tenzen-y",
    "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": "soltysh",
    "title": "soltysh",
    "url": "https://github.com/soltysh",
    "evidence_id": "wmji7yq7e2r3",
    "login": "soltysh",
    "is_bot": false
  }
]

[
  {
    "label": "FeatureGate",
    "key": "JobManagedBy",
    "title": "JobManagedBy",
    "url": "https://github.com/kubernetes/enhancements/blob/5b503a75369bdfdd494a2c2c72107a41bf6dd1a8/keps/sig-apps/4368-support-managed-by-for-batch-jobs/kep.yaml",
    "evidence_id": "mtg76efem3cl",
    "name": "JobManagedBy"
  },
  {
    "label": "FeatureGate",
    "key": "JobManagedByLabel",
    "title": "JobManagedByLabel",
    "url": "https://github.com/kubernetes/enhancements/blob/95b875b9db703fdf6e0a8e78879f07c5684a5424/keps/sig-apps/4368-support-managed-by-label-for-batch-jobs/kep.yaml",
    "evidence_id": "qeezqgjltrjp",
    "name": "JobManagedByLabel"
  }
]

[
  {
    "label": "Person",
    "key": "mimowo",
    "title": "mimowo",
    "url": "https://github.com/mimowo",
    "evidence_id": "qchqbsknnhjf",
    "login": "mimowo",
    "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

Job success/completion policy

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