KEP-688keps/sig-node/688-pod-overhead

Pod Overhead

implementedstablesig-nodelatest v1.24

KEP on GitHub kep.yaml Ask about this KEP

Sandbox runtimes introduce a non-negligible overhead at the pod level which must be accounted for effective scheduling, resource quota management, and constraining.

Facts

Authors: @egernst
Approvers: @dchen1107 @derekwaynecarr
Reviewers: @dchen1107 @tallclair @derekwaynecarr
PRR approvers: @ehashmanstable
Tracking issue: #688(opens GitHub in a new tab) closedcompletedclosed 2022-09-19 19:31 UTCmilestone v1.24sig/nodestage/stablepriority/important-longtermlifecycle/frozen
Milestones: alpha v1.16beta v1.18stable v1.24
Participating SIGs: sig-windows sig-scheduling sig-autoscaling
Feature gates: PodOverhead
Created / last updated: 2019-02-26 / 2022-09-19

Who decided each state, with the evidence.
Decided	Decision	Deciders	Evidence
2020-12-17 17:41 UTC	status_transition KEP-688 status set to implemented in PR #2193, 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@7eef794bb549a50c6b08c457556ff0eac98a4c6b(opens GitHub in a new tab) StatusChange status ∅ → implemented (2020-12-17)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#2193 Migrate some node KEPs to new template(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/554835705(opens GitHub in a new tab)
2022-02-02 18:56 UTC	prr_approval ehashman gave the production readiness approval for KEP-688 at stable on 2022-02-02.	@ehashman prr_approver	Document 688.yaml(opens GitHub in a new tab)
2022-02-02 18:56 UTC	stage_graduation KEP-688 set milestone.alpha to v1.16 in PR #3146, approved by ehashman; merged by automation (k8s-ci-robot) on 2022-02-02.	@sergeykanzhelev author @ehashman approver @ehashman approve_command @ehashman lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@bcda68c4dd410e4352dbd1037892a36db7e3d277(opens GitHub in a new tab) StatusChange milestone.alpha ∅ → v1.16 (2022-02-02)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#3146 PodOverhead to GA(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/870980952
2022-02-02 18:56 UTC	stage_graduation KEP-688 set milestone.beta to v1.18 in PR #3146, approved by ehashman; merged by automation (k8s-ci-robot) on 2022-02-02.	@sergeykanzhelev author @ehashman approver @ehashman approve_command @ehashman lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@bcda68c4dd410e4352dbd1037892a36db7e3d277(opens GitHub in a new tab) StatusChange milestone.beta ∅ → v1.18 (2022-02-02)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#3146 PodOverhead to GA(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/870980952
2022-02-02 18:56 UTC	stage_graduation KEP-688 set milestone.stable to v1.24 in PR #3146, approved by ehashman; merged by automation (k8s-ci-robot) on 2022-02-02.	@sergeykanzhelev author @ehashman approver @ehashman approve_command @ehashman lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@bcda68c4dd410e4352dbd1037892a36db7e3d277(opens GitHub in a new tab) StatusChange milestone.stable ∅ → v1.24 (2022-02-02)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#3146 PodOverhead to GA(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/870980952
2022-02-02 18:56 UTC	stage_graduation KEP-688 graduated to stable in PR #3146, approved by ehashman; merged by automation (k8s-ci-robot) on 2022-02-02.	@sergeykanzhelev author @ehashman approver @ehashman approve_command @ehashman lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@bcda68c4dd410e4352dbd1037892a36db7e3d277(opens GitHub in a new tab) StatusChange stage ∅ → stable (2022-02-02)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#3146 PodOverhead to GA(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/870980952
2022-02-02 18:56 UTC	status_transition KEP-688 status set to implementable in PR #3146, approved by ehashman; merged by automation (k8s-ci-robot) on 2022-02-02.	@sergeykanzhelev author @ehashman approver @ehashman approve_command @ehashman lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@bcda68c4dd410e4352dbd1037892a36db7e3d277(opens GitHub in a new tab) StatusChange status ∅ → implementable (2022-02-02)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#3146 PodOverhead to GA(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/870980952
2022-09-20 14:15 UTC	status_transition KEP-688 status changed from implementable to implemented in PR #3526, approved by dchen1107; merged by automation (k8s-ci-robot) on 2022-09-20.	@dchen1107 approve_command @dchen1107 lgtm @sergeykanzhelev author @k8s-ci-robot merger	Commit kubernetes/enhancements@fa2e73892fbb248fa5560abe4d1298cb138c0e4a(opens GitHub in a new tab) StatusChange status implementable → implemented (2022-09-19)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#3526 pod overhead is GA'd(opens GitHub in a new tab) Comment kubernetes/enhancements/issues/comments/1252412104

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

Status history
At	Kind	Field	Change	Actor	Evidence
2019-01-14 23:56 UTC	label	sig/node added	none → sig/node	@k8s-ci-robot	source(opens GitHub in a new tab)
2019-01-14 23:59 UTC	label	help wanted added	none → help wanted	@k8s-ci-robot	source

Relationships as stored, Person → KEP, from kep.yaml(opens GitHub in a new tab)
Person	Relationship
@egernst GitHub(opens GitHub in a new tab)	—AUTHORED→
@dchen1107 GitHub(opens GitHub in a new tab)	—REVIEWS→
@tallclair GitHub(opens GitHub in a new tab)	—REVIEWS→
@derekwaynecarr

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-node/688-pod-overhead", "title": "Pod Overhead", "url": "https://github.com/kubernetes/enhancements/tree/6ebe0a94771723b3f27cb4a757f0cc22f29e38a2/keps/sig-node/688-pod-overhead", "evidence_id": "tkz2abgor6a3", "number": 688, "owning_sig": "sig-node", "status": "implemented", "stage": "stable", "latest_milestone": "v1.24", "milestone_alpha": "v1.16", "milestone_beta": "v1.18", "milestone_stable": "v1.24", "creation_date": "2019-02-26", "last_updated": "2022-09-19", "metadata_invalid": false }	2	5	{ "1": { "feature_gates": 1, "sigs": 1, "people": 3 } }	not in graph (merged pull requests only)	none	none	none	none
none	none	none	none	none	1	[ { "label": "FeatureGate", "key": "PodOverhead", "title": "PodOverhead", "url": "https://github.com/kubernetes/enhancements/blob/6ebe0a94771723b3f27cb4a757f0cc22f29e38a2/keps/sig-node/688-pod-overhead/kep.yaml", "evidence_id": "yf35drqzmm73", "name": "PodOverhead" } ]	[ { "label": "SIG", "key": "sig-node", "title": "Node", "url": "https://github.com/kubernetes/community/tree/440e496d3a172234d81728df1bfe43849b589adf/sig-node", "evidence_id": "nrsuxu2xcxa7", "display_name": "Node", "sig_label": "node", "in_scope": true } ]	[ { "label": "Person", "key": "egernst", "title": "egernst", "url": "https://github.com/egernst", "evidence_id": "2rsj7jvlp2ay", "login": "egernst", "is_bot": false }, { "label": "Person", "key": "dchen1107", "title": "dchen1107", "url": "https://github.com/dchen1107", "evidence_id": "frhgjvzxlrsh", "login": "dchen1107", "is_bot": false }, { "label": "Person", "key": "derekwaynecarr", "title": "derekwaynecarr", "url": "https://github.com/derekwaynecarr", "evidence_id": "wpnbg5qnq5fl", "login": "derekwaynecarr", "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-node/688-pod-overhead", "title": "Pod Overhead", "url": "https://github.com/kubernetes/enhancements/tree/6ebe0a94771723b3f27cb4a757f0cc22f29e38a2/keps/sig-node/688-pod-overhead", "evidence_id": "tkz2abgor6a3", "number": 688, "owning_sig": "sig-node", "status": "implemented", "stage": "stable", "latest_milestone": "v1.24", "milestone_alpha": "v1.16", "milestone_beta": "v1.18", "milestone_stable": "v1.24", "creation_date": "2019-02-26", "last_updated": "2022-09-19", "metadata_invalid": false }	2	5	{ "1": { "feature_gates": 1, "sigs": 1, "people": 3 } }	not in graph (merged pull requests only)	none	none	none	none
none	none	none	none	none	1	[ { "label": "FeatureGate", "key": "PodOverhead", "title": "PodOverhead", "url": "https://github.com/kubernetes/enhancements/blob/6ebe0a94771723b3f27cb4a757f0cc22f29e38a2/keps/sig-node/688-pod-overhead/kep.yaml", "evidence_id": "yf35drqzmm73", "name": "PodOverhead" } ]	[ { "label": "SIG", "key": "sig-node", "title": "Node", "url": "https://github.com/kubernetes/community/tree/440e496d3a172234d81728df1bfe43849b589adf/sig-node", "evidence_id": "nrsuxu2xcxa7", "display_name": "Node", "sig_label": "node", "in_scope": true } ]	[ { "label": "Person", "key": "egernst", "title": "egernst", "url": "https://github.com/egernst", "evidence_id": "2rsj7jvlp2ay", "login": "egernst", "is_bot": false }, { "label": "Person", "key": "dchen1107", "title": "dchen1107", "url": "https://github.com/dchen1107", "evidence_id": "frhgjvzxlrsh", "login": "dchen1107", "is_bot": false }, { "label": "Person", "key": "derekwaynecarr", "title": "derekwaynecarr", "url": "https://github.com/derekwaynecarr", "evidence_id": "wpnbg5qnq5fl", "login": "derekwaynecarr", "is_bot": false } ]

Kep

Depth

Reached

By hop

Open pull requests

Hop

Feature gates

Sigs

People

{
  "label": "KEP",
  "key": "keps/sig-node/688-pod-overhead",
  "title": "Pod Overhead",
  "url": "https://github.com/kubernetes/enhancements/tree/6ebe0a94771723b3f27cb4a757f0cc22f29e38a2/keps/sig-node/688-pod-overhead",
  "evidence_id": "tkz2abgor6a3",
  "number": 688,
  "owning_sig": "sig-node",
  "status": "implemented",
  "stage": "stable",
  "latest_milestone": "v1.24",
  "milestone_alpha": "v1.16",
  "milestone_beta": "v1.18",
  "milestone_stable": "v1.24",
  "creation_date": "2019-02-26",
  "last_updated": "2022-09-19",
  "metadata_invalid": false
}

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

not in graph (merged pull requests only)

[
  {
    "label": "FeatureGate",
    "key": "PodOverhead",
    "title": "PodOverhead",
    "url": "https://github.com/kubernetes/enhancements/blob/6ebe0a94771723b3f27cb4a757f0cc22f29e38a2/keps/sig-node/688-pod-overhead/kep.yaml",
    "evidence_id": "yf35drqzmm73",
    "name": "PodOverhead"
  }
]

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

[
  {
    "label": "Person",
    "key": "egernst",
    "title": "egernst",
    "url": "https://github.com/egernst",
    "evidence_id": "2rsj7jvlp2ay",
    "login": "egernst",
    "is_bot": false
  },
  {
    "label": "Person",
    "key": "dchen1107",
    "title": "dchen1107",
    "url": "https://github.com/dchen1107",
    "evidence_id": "frhgjvzxlrsh",
    "login": "dchen1107",
    "is_bot": false
  },
  {
    "label": "Person",
    "key": "derekwaynecarr",
    "title": "derekwaynecarr",
    "url": "https://github.com/derekwaynecarr",
    "evidence_id": "wpnbg5qnq5fl",
    "login": "derekwaynecarr",
    "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

Pod Overhead

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