DRA resourcepoolstatusrequest by nmn3m · Pull Request #56352 · kubernetes/website

nmn3m · 2026-07-01T18:12:42Z

Description

DRA Resource Availability Visibility

Issue

netlify · 2026-07-01T18:12:47Z

👷 Deploy Preview for kubernetes-io-vnext-staging processing.

Name	Link
🔨 Latest commit	`47a5bc8`
🔍 Latest deploy log	https://app.netlify.com/projects/kubernetes-io-vnext-staging/deploys/6a6be599947cf40008f1b40f

netlify · 2026-07-01T18:15:18Z

✅ Pull request preview available for checking

Built without sensitive environment variables

Name	Link
🔨 Latest commit	`47a5bc8`
🔍 Latest deploy log	https://app.netlify.com/projects/kubernetes-io-main-staging/deploys/6a6be5991a0f270008d75728
😎 Deploy Preview	https://deploy-preview-56352--kubernetes-io-main-staging.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

kernel-kun · 2026-07-21T17:24:46Z

Hi @nmn3m 👋! v1.37 Docs team here

We noticed that this Pull Request is currently in the Open state.

Note

Could you please confirm:

Are all of the required changes done from your end?
Is this PR now awaiting a technical review from your required SIGs/WGs?

Important

Upcoming Docs Deadlines:

PR Ready for Review: Tuesday 28th July 2026
Docs Freeze: Wednesday 5th August 2026 (AoE) / Thursday 6th August 2026, 12:00 UTC

Please let us know so we can track this accurately on our end.

Thanks!

nmn3m · 2026-07-22T16:04:32Z

@kernel-kun
Hi, 👋
PR will be ready in few days.
It is related to this issue. kubernetes/enhancements#5677

nojnhuh · 2026-07-22T19:09:17Z

/wg device-management

…le summaries

…ol-status-request # Conflicts: # content/en/docs/concepts/scheduling-eviction/dynamic-resource-allocation.md

…structure

nmn3m · 2026-07-26T16:48:48Z

/cc @johnbelamaric

johnbelamaric

/approve

for DRA content

nmn3m · 2026-07-28T12:33:09Z

/cc @natalisucks

singh1203 · 2026-07-29T16:47:10Z

/sig docs

nojnhuh · 2026-07-29T19:21:29Z

+     - `partitionSummary`: for [partitionable](/docs/concepts/resource-management/dynamic-resource-allocation/dra-features/#partitionable-devices)
+       pools, per-partition-type allocatability (see
+       [Partition and shareable summaries](#resource-pool-partition-shareable-summaries)).
+     - `shareableSummary`: for pools with shareable devices, aggregate capacity


Does this map to the DRAConsumableCapacity feature? If so, could we link to those docs at /docs/concepts/resource-management/dynamic-resource-allocation/dra-features/#consumable-capacity like you have for partitionable devices?

nojnhuh · 2026-07-29T19:27:35Z

+slice) that draw from the same shared counters. Because these partitions compete
+for the same underlying capacity, a plain device count does not tell you how many
+of each type can still be allocated. The `partitionSummary` view answers that
+question: for each partition type it reports:


nit: The double colon feels a bit clunky. A new sentence might flow better.

Suggested change

question: for each partition type it reports:

question. For each partition type it reports:

nojnhuh · 2026-07-29T19:32:04Z

+- `attribute`: the fully qualified device attribute name whose value groups this
+  entry.
+- `type`: the partition type value (for example, `Full` or `Half`).


Could the docs mention where these values come from? i.e. that attribute matches the ResourceSlice's spec.partitionTypeAttribute or ResourcePoolStatusRequest's spec. defaultPartitionTypeAttribute and type is the value of that attribute. I think that would help tie in the examples below.

nojnhuh · 2026-07-29T19:36:54Z

+### Partition and shareable summaries {#resource-pool-partition-shareable-summaries}
+
+{{< feature-state feature_gate_name="DRAPartitionableDevicesType" >}}


Would it make sense to split this into separate sections for partitionable devices and shareable devices? Especially if the shareable summaries aren't tied to the DRAPartitionableDevicesType feature gate.

nojnhuh · 2026-07-29T19:43:08Z

+- `attribute`: the fully qualified device attribute name whose value groups this
+  entry.


Can this attribute only be of type string or are other types converted before being represented in the type field? It might also be worth calling out how this interacts with the DRAListTypeAttributes feature, or if those aren't handled.

These would also be good to mention in the API docs.

String only. It reads only attr.StringValue; if that's nil (int, bool, version or absent), it returns no partition type. Nothing is converted/stringified. Such a device then produces a PartitionTypeMissing validation error for the pool instead of a partition summary.

No DRAListTypeAttributes interaction. No shared code path a list-type attribute has StringValue == nil, so it's treated like any other non-string attribute. Not special-cased.

…ng and string-type requirement

nojnhuh

Just one more small comment. Otherwise looking good, thanks!

nojnhuh · 2026-07-30T19:23:29Z


-**Shareable summary.** For pools that contain devices allowing multiple
-allocations, `shareableSummary` reports aggregate capacity usage across the pool:
+The `partitionSummary` view is an *alpha feature*. In addition to the


#56295 dropped the inline alpha/beta qualifier in text like this in favor of the rendered feature-state components. Features tend to be described like this now:

website/content/en/docs/concepts/resource-management/dynamic-resource-allocation/dra-features.md

Lines 53 to 55 in 18db438

Extended resource allocation by DRA is controlled by the

[`DRAExtendedResource` feature gate](/docs/reference/command-line-tools-reference/feature-gates/#DRAExtendedResource)

in the `kube-apiserver`, `kube-scheduler`, `kube-controller-manager`, and `kubelet`.

…te badge

nmn3m · 2026-07-31T00:02:41Z

Just one more small comment. Otherwise looking good, thanks!

cc @nojnhuh Thanks for the feedback.
If it seems good, can you please add lgtm so we can ask the doc team for final approval.

nojnhuh

/lgtm

Thanks!

kubernetes-prow · 2026-07-31T02:15:30Z

LGTM label has been added.

Details

Git tree hash: 6fcb443a62e971e621ae7300e2d1163c564d0641

katcosgrove · 2026-08-04T18:27:35Z

/approve

Thank you!

kubernetes-prow · 2026-08-04T18:27:58Z

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: johnbelamaric, katcosgrove, nojnhuh

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details

Needs approval from an approver in each of these files:

~~content/en/docs/OWNERS~~ [katcosgrove]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

WIP: Placeholder for DRA ResourcePoolStatusRequest docs

61f0a70

kubernetes-prow Bot added the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Jul 1, 2026

kubernetes-prow Bot added this to the 1.37 milestone Jul 1, 2026

kubernetes-prow Bot added size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. labels Jul 1, 2026

nmn3m mentioned this pull request Jul 1, 2026

DRA: Resource Availability Visibility kubernetes/enhancements#5677

Open

10 tasks

kubernetes-prow Bot added the wg/device-management Categorizes an issue or PR as relevant to WG Device Management. label Jul 22, 2026

github-project-automation Bot added this to Dynamic Resource Allocation Jul 22, 2026

github-project-automation Bot moved this to 🆕 New in Dynamic Resource Allocation Jul 22, 2026

pohly moved this from 🆕 New to 🏗 In progress in Dynamic Resource Allocation Jul 23, 2026

Document DRAPartitionableDevicesType alpha and RPSR partition/shareab…

c4c38f6

…le summaries

nmn3m changed the title ~~WIP: Placeholder for DRA resourcepoolstatusrequest"~~ DRA resourcepoolstatusrequest Jul 26, 2026

kubernetes-prow Bot removed the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Jul 26, 2026

nmn3m added 2 commits July 26, 2026 19:44

Merge remote-tracking branch 'upstream/dev-1.37' into dra-resource-po…

8a1d323

…ol-status-request # Conflicts: # content/en/docs/concepts/scheduling-eviction/dynamic-resource-allocation.md

Port DRAPartitionableDevicesType docs to new resource-management DRA …

ca5171f

…structure

kubernetes-prow Bot removed the needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. label Jul 26, 2026

kubernetes-prow Bot requested a review from johnbelamaric July 26, 2026 16:48

johnbelamaric reviewed Jul 27, 2026

View reviewed changes

johnbelamaric mentioned this pull request Jul 27, 2026

Document KEP-5963: DRADeviceCompatibilityGroups for K8s 1.37 #56288

Merged

kubernetes-prow Bot requested a review from natalisucks July 28, 2026 12:33

kubernetes-prow Bot added the sig/docs Categorizes an issue or PR as relevant to SIG Docs. label Jul 29, 2026

nojnhuh reviewed Jul 29, 2026

View reviewed changes

Split partition and shareable summary docs; document attribute sourci…

18db438

…ng and string-type requirement

nmn3m requested review from johnbelamaric and nojnhuh July 30, 2026 11:01

nojnhuh reviewed Jul 30, 2026

View reviewed changes

Drop inline alpha qualifier from summary docs in favor of feature-sta…

47a5bc8

…te badge

nmn3m requested a review from nojnhuh July 31, 2026 00:02

nojnhuh approved these changes Jul 31, 2026

View reviewed changes

kubernetes-prow Bot assigned nojnhuh Jul 31, 2026

kubernetes-prow Bot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Jul 31, 2026

kubernetes-prow Bot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Aug 4, 2026

kubernetes-prow Bot merged commit f29c941 into kubernetes:dev-1.37 Aug 4, 2026
6 checks passed

nojnhuh moved this from 🏗 In progress to ✅ Done in Dynamic Resource Allocation Aug 6, 2026

	question: for each partition type it reports:
	question. For each partition type it reports:

		### Partition and shareable summaries {#resource-pool-partition-shareable-summaries}

		{{< feature-state feature_gate_name="DRAPartitionableDevicesType" >}}

		- `attribute`: the fully qualified device attribute name whose value groups this
		entry.

	Extended resource allocation by DRA is controlled by the
	[`DRAExtendedResource` feature gate](/docs/reference/command-line-tools-reference/feature-gates/#DRAExtendedResource)
	in the `kube-apiserver`, `kube-scheduler`, `kube-controller-manager`, and `kubelet`.

Uh oh!

Conversation

nmn3m commented Jul 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Issue

Uh oh!

netlify Bot commented Jul 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

👷 Deploy Preview for kubernetes-io-vnext-staging processing.

Uh oh!

netlify Bot commented Jul 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Pull request preview available for checking

Uh oh!

kernel-kun commented Jul 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

nmn3m commented Jul 22, 2026

Uh oh!

nojnhuh commented Jul 22, 2026

Uh oh!

nmn3m commented Jul 26, 2026

Uh oh!

johnbelamaric left a comment

Choose a reason for hiding this comment

Uh oh!

nmn3m commented Jul 28, 2026

Uh oh!

singh1203 commented Jul 29, 2026

Uh oh!

nojnhuh Jul 29, 2026

Choose a reason for hiding this comment

Uh oh!

nojnhuh Jul 29, 2026

Choose a reason for hiding this comment

Uh oh!

nojnhuh Jul 29, 2026

Choose a reason for hiding this comment

Uh oh!

nojnhuh Jul 29, 2026

Choose a reason for hiding this comment

Uh oh!

nojnhuh Jul 29, 2026

Choose a reason for hiding this comment

Uh oh!

nmn3m Jul 30, 2026

Choose a reason for hiding this comment

Uh oh!

nojnhuh left a comment

Choose a reason for hiding this comment

Uh oh!

nojnhuh Jul 30, 2026

Choose a reason for hiding this comment

Uh oh!

nmn3m commented Jul 31, 2026

Uh oh!

nojnhuh left a comment

Choose a reason for hiding this comment

Uh oh!

kubernetes-prow Bot commented Jul 31, 2026

Uh oh!

katcosgrove commented Aug 4, 2026

Uh oh!

kubernetes-prow Bot commented Aug 4, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

7 participants

nmn3m commented Jul 1, 2026 •

edited

Loading

netlify Bot commented Jul 1, 2026 •

edited

Loading

netlify Bot commented Jul 1, 2026 •

edited

Loading

kernel-kun commented Jul 21, 2026 •

edited

Loading