KEP-5825keps/sig-node/5825-cri-pagination

CRI List Streaming

implementablebetasig-nodelatest v1.38

KEP on GitHub kep.yaml Ask about this KEP

This KEP proposes adding server-side streaming RPCs to CRI's List* operations. Currently, these APIs return all results in a single unary response, causing failures on nodes with 10k+ containers when responses exceed the 16 MB gRPC message limit. The proposed solution introduces new streaming RPCs (e.g., StreamContainers, StreamPodSandboxes) that stream resu… Full summary

Facts

Authors: @bitoku
Approvers: @dchen1107
Reviewers: @haircommander @samuelkarp
PRR approvers: @kannon92alpha@kannon92beta
Tracking issue: #5825(opens GitHub in a new tab) openmilestone v1.38sig/nodestage/betatracked/yeslead-opted-in
Milestones: alpha v1.36beta v1.38
Participating SIGs: none
Feature gates: CRIListStreaming
Created / last updated: 2026-01-21 / none

Who decided each state, with the evidence.
Decided	Decision	Deciders	Evidence
2026-01-21 11:07 UTC	prr_approval kannon92 gave the production readiness approval for KEP-5825 at alpha on 2026-01-21.	@kannon92 prr_approver	Document 5825.yaml(opens GitHub in a new tab)
2026-02-11 17:50 UTC	stage_graduation KEP-5825 set milestone.alpha to v1.36 in PR #5826, approved by samuelkarp, kannon92; merged by automation (k8s-ci-robot) on 2026-02-11.	@kannon92 approve_command @dchen1107 lgtm @haircommander lgtm @bitoku author @samuelkarp approver @samuelkarp lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@47fe927437167256444fdd7f48a40591b1ac5323(opens GitHub in a new tab) StatusChange milestone.alpha ∅ → v1.36 (2026-01-21)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#5826 KEP-5825: CRI List Streaming(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/3781830761(opens GitHub in a new tab) Review kubernetes/enhancements/pulls/reviews/3752701363(opens GitHub in a new tab) Comment kubernetes/enhancements/issues/comments/3885953362(opens GitHub in a new tab) Comment kubernetes/enhancements/issues/comments/3885751877(opens GitHub in a new tab)
2026-02-11 17:50 UTC	stage_graduation KEP-5825 graduated to alpha in PR #5826, approved by samuelkarp, kannon92; merged by automation (k8s-ci-robot) on 2026-02-11.	@kannon92 approve_command @dchen1107 lgtm @haircommander lgtm @bitoku author @samuelkarp approver @samuelkarp lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@47fe927437167256444fdd7f48a40591b1ac5323(opens GitHub in a new tab) StatusChange stage ∅ → alpha (2026-01-21)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#5826 KEP-5825: CRI List Streaming
2026-02-11 17:50 UTC	status_transition KEP-5825 status set to implementable in PR #5826, approved by samuelkarp, kannon92; merged by automation (k8s-ci-robot) on 2026-02-11.	@kannon92 approve_command @dchen1107 lgtm @haircommander lgtm @bitoku author @samuelkarp approver @samuelkarp lgtm @k8s-ci-robot merger	Commit kubernetes/enhancements@47fe927437167256444fdd7f48a40591b1ac5323(opens GitHub in a new tab) StatusChange status ∅ → implementable (2026-01-21)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#5826 KEP-5825: CRI List Streaming
2026-06-03 14:06 UTC	prr_approval kannon92 gave the production readiness approval for KEP-5825 at beta on 2026-06-03.	@kannon92 prr_approver	Document 5825.yaml(opens GitHub in a new tab)
2026-09-21 17:00 UTC	milestone_retarget KEP-5825 latest-milestone moved from v1.36 to v1.38 in PR #6146, approved by sergeykanzhelev, kannon92; merged by automation (kubernetes-prow) on 2026-09-21.	@kannon92 approve_command @sergeykanzhelev approver @sergeykanzhelev approve_command @sergeykanzhelev lgtm @bitoku author @kubernetes-prow merger	Commit kubernetes/enhancements@643d02ea5759e945ce7aee167cdd01ab695d053c(opens GitHub in a new tab) StatusChange latest_milestone v1.36 → v1.38 (2026-06-03)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#6146 KEP-5825: update CRI List Streaming for beta graduation in v1.38
2026-09-21 17:00 UTC	stage_graduation KEP-5825 set milestone.beta to v1.38 in PR #6146, approved by sergeykanzhelev, kannon92; merged by automation (kubernetes-prow) on 2026-09-21.	@kannon92 approve_command @sergeykanzhelev approver @sergeykanzhelev approve_command @sergeykanzhelev lgtm @bitoku author @kubernetes-prow merger	Commit kubernetes/enhancements@643d02ea5759e945ce7aee167cdd01ab695d053c(opens GitHub in a new tab) StatusChange milestone.beta ∅ → v1.38 (2026-06-03)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#6146 KEP-5825: update CRI List Streaming for beta graduation in v1.38
2026-09-21 17:00 UTC	stage_graduation KEP-5825 graduated to beta from alpha in PR #6146, approved by sergeykanzhelev, kannon92; merged by automation (kubernetes-prow) on 2026-09-21.	@kannon92 approve_command @sergeykanzhelev approver @sergeykanzhelev approve_command @sergeykanzhelev lgtm @bitoku author @kubernetes-prow merger	Commit kubernetes/enhancements@643d02ea5759e945ce7aee167cdd01ab695d053c(opens GitHub in a new tab) StatusChange stage alpha → beta (2026-06-03)(opens GitHub in a new tab) PullRequest kubernetes/enhancements#6146 KEP-5825: update CRI List Streaming for beta graduation in v1.38

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

Status history
At	Kind	Field	Change	Actor	Evidence
2026-01-21 10:24 UTC	label	needs-sig added	none → needs-sig	@k8s-ci-robot	source(opens GitHub in a new tab)
2026-01-21 10:24 UTC	label	sig/node added	none → sig/node	@k8s-ci-robot	source

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

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	Open issues
{ "label": "KEP", "key": "keps/sig-node/5825-cri-pagination", "title": "CRI List Streaming", "url": "https://github.com/kubernetes/enhancements/tree/5b503a75369bdfdd494a2c2c72107a41bf6dd1a8/keps/sig-node/5825-cri-pagination", "evidence_id": "h3fl4lgxxpf6", "number": 5825, "owning_sig": "sig-node", "status": "implementable", "stage": "beta", "latest_milestone": "v1.38", "milestone_alpha": "v1.36", "milestone_beta": "v1.38", "creation_date": "2026-01-21", "metadata_invalid": false }	2	6	{ "1": { "feature_gates": 2, "sigs": 1, "people": 2, "open_issues": 1 } }	not in graph (merged pull requests only)	none	none	none	none	none
none	none	none	none	none	1	[ { "label": "FeatureGate", "key": "CRIListPagination", "title": "CRIListPagination", "url": "https://github.com/kubernetes/enhancements/blob/47fe927437167256444fdd7f48a40591b1ac5323/keps/sig-node/5825-cri-pagination/kep.yaml", "evidence_id": "zvs4ahycrdav", "name": "CRIListPagination" }, { "label": "FeatureGate", "key": "CRIListStreaming", "title": "CRIListStreaming", "url": "https://github.com/kubernetes/enhancements/blob/5b503a75369bdfdd494a2c2c72107a41bf6dd1a8/keps/sig-node/5825-cri-pagination/kep.yaml", "evidence_id": "wnyoovkc4dah", "name": "CRIListStreaming" } ]	[ { "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": "bitoku", "title": "bitoku", "url": "https://github.com/bitoku", "evidence_id": "eynax76a753g", "login": "bitoku", "is_bot": false }, { "label": "Person", "key": "dchen1107", "title": "dchen1107", "url": "https://github.com/dchen1107", "evidence_id": "frhgjvzxlrsh", "login": "dchen1107", "is_bot": false } ]	[ { "label": "Issue", "key": "kubernetes/enhancements#5825", "title": "CRI List Streaming", "url": "https://github.com/kubernetes/enhancements/issues/5825", "evidence_id": "kaa6rll43es2", "number": 5825, "state": "open", "created_at_iso": "2026-01-21T10:24:31Z", "labels_current": [ "sig/node", "stage/beta", "tracked/yes", "lead-opted-in" ], "milestone_current": "v1.38", "is_tracking_issue": true } ]

Rows returned by the tool
Kep	Depth	Reached	By hop	Open pull requests	Hop	Feature gates	Sigs	People	Open issues
{ "label": "KEP", "key": "keps/sig-node/5825-cri-pagination", "title": "CRI List Streaming", "url": "https://github.com/kubernetes/enhancements/tree/5b503a75369bdfdd494a2c2c72107a41bf6dd1a8/keps/sig-node/5825-cri-pagination", "evidence_id": "h3fl4lgxxpf6", "number": 5825, "owning_sig": "sig-node", "status": "implementable", "stage": "beta", "latest_milestone": "v1.38", "milestone_alpha": "v1.36", "milestone_beta": "v1.38", "creation_date": "2026-01-21", "metadata_invalid": false }	2	6	{ "1": { "feature_gates": 2, "sigs": 1, "people": 2, "open_issues": 1 } }	not in graph (merged pull requests only)	none	none	none	none	none
none	none	none	none	none	1	[ { "label": "FeatureGate", "key": "CRIListPagination", "title": "CRIListPagination", "url": "https://github.com/kubernetes/enhancements/blob/47fe927437167256444fdd7f48a40591b1ac5323/keps/sig-node/5825-cri-pagination/kep.yaml", "evidence_id": "zvs4ahycrdav", "name": "CRIListPagination" }, { "label": "FeatureGate", "key": "CRIListStreaming", "title": "CRIListStreaming", "url": "https://github.com/kubernetes/enhancements/blob/5b503a75369bdfdd494a2c2c72107a41bf6dd1a8/keps/sig-node/5825-cri-pagination/kep.yaml", "evidence_id": "wnyoovkc4dah", "name": "CRIListStreaming" } ]	[ { "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": "bitoku", "title": "bitoku", "url": "https://github.com/bitoku", "evidence_id": "eynax76a753g", "login": "bitoku", "is_bot": false }, { "label": "Person", "key": "dchen1107", "title": "dchen1107", "url": "https://github.com/dchen1107", "evidence_id": "frhgjvzxlrsh", "login": "dchen1107", "is_bot": false } ]	[ { "label": "Issue", "key": "kubernetes/enhancements#5825", "title": "CRI List Streaming", "url": "https://github.com/kubernetes/enhancements/issues/5825", "evidence_id": "kaa6rll43es2", "number": 5825, "state": "open", "created_at_iso": "2026-01-21T10:24:31Z", "labels_current": [ "sig/node", "stage/beta", "tracked/yes", "lead-opted-in" ], "milestone_current": "v1.38", "is_tracking_issue": true } ]

Kep

Depth

Reached

By hop

Open pull requests

Hop

Feature gates

Sigs

People

Open issues

{
  "label": "KEP",
  "key": "keps/sig-node/5825-cri-pagination",
  "title": "CRI List Streaming",
  "url": "https://github.com/kubernetes/enhancements/tree/5b503a75369bdfdd494a2c2c72107a41bf6dd1a8/keps/sig-node/5825-cri-pagination",
  "evidence_id": "h3fl4lgxxpf6",
  "number": 5825,
  "owning_sig": "sig-node",
  "status": "implementable",
  "stage": "beta",
  "latest_milestone": "v1.38",
  "milestone_alpha": "v1.36",
  "milestone_beta": "v1.38",
  "creation_date": "2026-01-21",
  "metadata_invalid": false
}

{
  "1": {
    "feature_gates": 2,
    "sigs": 1,
    "people": 2,
    "open_issues": 1
  }
}

not in graph (merged pull requests only)

[
  {
    "label": "FeatureGate",
    "key": "CRIListPagination",
    "title": "CRIListPagination",
    "url": "https://github.com/kubernetes/enhancements/blob/47fe927437167256444fdd7f48a40591b1ac5323/keps/sig-node/5825-cri-pagination/kep.yaml",
    "evidence_id": "zvs4ahycrdav",
    "name": "CRIListPagination"
  },
  {
    "label": "FeatureGate",
    "key": "CRIListStreaming",
    "title": "CRIListStreaming",
    "url": "https://github.com/kubernetes/enhancements/blob/5b503a75369bdfdd494a2c2c72107a41bf6dd1a8/keps/sig-node/5825-cri-pagination/kep.yaml",
    "evidence_id": "wnyoovkc4dah",
    "name": "CRIListStreaming"
  }
]

[
  {
    "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": "bitoku",
    "title": "bitoku",
    "url": "https://github.com/bitoku",
    "evidence_id": "eynax76a753g",
    "login": "bitoku",
    "is_bot": false
  },
  {
    "label": "Person",
    "key": "dchen1107",
    "title": "dchen1107",
    "url": "https://github.com/dchen1107",
    "evidence_id": "frhgjvzxlrsh",
    "login": "dchen1107",
    "is_bot": false
  }
]

[
  {
    "label": "Issue",
    "key": "kubernetes/enhancements#5825",
    "title": "CRI List Streaming",
    "url": "https://github.com/kubernetes/enhancements/issues/5825",
    "evidence_id": "kaa6rll43es2",
    "number": 5825,
    "state": "open",
    "created_at_iso": "2026-01-21T10:24:31Z",
    "labels_current": [
      "sig/node",
      "stage/beta",
      "tracked/yes",
      "lead-opted-in"
    ],
    "milestone_current": "v1.38",
    "is_tracking_issue": true
  }
]

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

CRI List Streaming

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