Split Dynamic Resource Allocation into a Resource Management section by Caesarsage · Pull Request #56295 · kubernetes/website

Caesarsage · 2026-06-28T18:05:09Z

Adds a Concepts > Resource Management section and splits the Dynamic Resource Allocation page into purpose-built pages:

dynamic-resource-allocation/_index.md : overview, benefits, limitations
dra-api.md : API objects & attributes
how-dra-works.md : allocation workflow
dra-observability.md : metrics, ResourceClaim status, device health, device metadata
dra-features.md : optional capabilities
device-taints.md : device taints & tolerations

Approach: verbatim content move, then dropped the alpha features / beta features headings, each capability now sits on its topical page with its
{{< feature-state >}} badge carrying the stage, so graduating features get a
home instead of a maturity bucket to reshuffle each release.

Redirects: aliases on the DRA landing preserve the old
/concepts/scheduling-eviction/dynamic-resource-allocation/ URL.

Scope: structure only. Inbound-link repointing and the v1.37 graduation content follow in separate PRs.

Issue

Related to #49899

discussion on slack here https://kubernetes.slack.com/archives/C1J0BPD2M/p1782232560810309

netlify · 2026-06-28T18:05:15Z

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

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

netlify · 2026-06-28T18:07:43Z

✅ Pull request preview available for checking

Built without sensitive environment variables

Name	Link
🔨 Latest commit	`660c071`
🔍 Latest deploy log	https://app.netlify.com/projects/kubernetes-io-main-staging/deploys/6a5b5bacc79fba000806273d
😎 Deploy Preview	https://deploy-preview-56295--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.

lmktfy · 2026-06-28T18:35:08Z

/label refactor

…allocation/_index.md Co-authored-by: Tim Bannister <193443691+lmktfy@users.noreply.github.com>

Caesarsage · 2026-07-04T11:33:34Z

Given ++ from the wg-device-management WG https://kubernetes.slack.com/archives/C0409NGC1TK/p1782721132858409

This is a good first step and ready to merge. next will be to repoint broken links

…nagement-section

johnbelamaric

some tweaks - though I am also OK merging this as-is and then applying these changes in a follow up PR

johnbelamaric · 2026-07-17T16:24:52Z

+api_metadata:
+- apiVersion: "resource.k8s.io/v1alpha3"
+  kind: "DeviceTaintRule"
+- apiVersion: "resource.k8s.io/v1beta2"


this is going GA in 1.37

johnbelamaric · 2026-07-17T16:35:06Z

+is not exempt either. An admin using that mode must explicitly tolerate all taints
+to access tainted devices.
+
+Device taints and tolerations is controlled by the


We can remove this paragraph as it is going GA

johnbelamaric · 2026-07-17T16:46:17Z

+Consider the following example:
+
+```yaml
+apiVersion: scheduling.k8s.io/v1alpha2


This is moving to beta, we probably should update the version here

Some part of the site still uses scheduling.k8s.io/v1alpha2 (podgroup-api and gang-scheduling docs), so bumping just this example would be inconsistent, is there a tracking change for the PodGroup beta graduation I should follow?

johnbelamaric · 2026-07-17T16:52:01Z

+
+<!-- body -->
+
+## Extended resource allocation by DRA {#extended-resource}


this feature doesn't really require any special driver support, maybe it should move up to dra-api.md, or we should remove the comment that these features require driver support

johnbelamaric · 2026-07-17T16:52:37Z

+The resulting ResourceClaim will contain a request for an `ExactCount` of the
+specified number of devices of that DeviceClass.
+
+Extended resource allocation by DRA is controlled by the


this is going GA in 1.37

johnbelamaric · 2026-07-17T16:54:44Z

+If a non-multiply-allocatable device were chosen, the allocation would have resulted in the entire device.
+To force the use of a only multiply-allocatable devices, you can use the CEL criteria `device.allowMultipleAllocations == true`.
+
+### DistinctAttribute constraint


this also does not need driver support

I will update the overview from them requiring driver

johnbelamaric · 2026-07-17T16:57:43Z

+in the `kube-apiserver` and `kube-controller-manager`.
+
+
+## DRA device metadata in containers {#device-metadata}


this belongs in dra-features.md not here

…allocation/_index.md Co-authored-by: John Belamaric <jbelamaric@google.com>

…nagement-section # Conflicts: # content/en/docs/concepts/scheduling-eviction/dynamic-resource-allocation.md

… into dra-resource-management-section

…allocation/device-taints.md Co-authored-by: John Belamaric <jbelamaric@google.com>

lmktfy · 2026-07-18T11:27:00Z

This is not a change to the live site, so I can
/lgtm
/approve

Lazy consensus because it is a big reorganization.

Anyone is welcome to unhold this after 48 hours, or an approver for the English localizations can unhold at any time.
/hold

kubernetes-prow · 2026-07-18T11:27:07Z

LGTM label has been added.

Details

Git tree hash: fffd5ff0396d960c6ffa88e41092f80a2f90c4e6

kubernetes-prow · 2026-07-18T11:27:08Z

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: lmktfy

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~~ [lmktfy]

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

Caesarsage · 2026-07-18T11:40:53Z

Thanks @johnbelamaric

I will make these fixes as a follow-up rather than here, to keep the Lazy consensus. Once this merges, I suggest #56265 (device taints GA) goes in first, then the follow-up on top.

reylejano · 2026-07-21T13:31:14Z

@pohly , what do you think of the reorg of the DRA docs?

lmktfy · 2026-07-21T13:35:52Z

Lazy consensus expired with no actual objection.
We can revert this change if needed.

/unhold

Split Dynamic Resource Allocation into a Resource Management section

bdf97d7

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 Jun 28, 2026

kubernetes-prow Bot added this to the 1.37 milestone Jun 28, 2026

kubernetes-prow Bot requested review from klueska and reylejano June 28, 2026 18:05

kubernetes-prow Bot added language/en Issues or PRs related to English language cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. labels Jun 28, 2026

kubernetes-prow Bot added the refactor Indicates a PR with large refactoring changes e.g. removes files or moves content label Jun 28, 2026

lmktfy reviewed Jun 28, 2026

View reviewed changes

Comment thread content/en/docs/concepts/resource-management/dynamic-resource-allocation/_index.md

Caesarsage and others added 2 commits July 4, 2026 12:15

Update content/en/docs/concepts/resource-management/dynamic-resource-…

d0cde1c

…allocation/_index.md Co-authored-by: Tim Bannister <193443691+lmktfy@users.noreply.github.com>

Document DRA-backed extended resources in the extended-resource task

8f968c7

Caesarsage marked this pull request as ready for review July 4, 2026 11:29

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 4, 2026

kubernetes-prow Bot requested review from pohly and salaxander July 4, 2026 11:29

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

6e8af30

…nagement-section

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

johnbelamaric reviewed Jul 17, 2026

View reviewed changes

Caesarsage and others added 4 commits July 18, 2026 11:39

Update content/en/docs/concepts/resource-management/dynamic-resource-…

0d1f964

…allocation/_index.md Co-authored-by: John Belamaric <jbelamaric@google.com>

Update content/en/docs/concepts/resource-management/dynamic-resource-…

bb0d0d5

…allocation/_index.md Co-authored-by: John Belamaric <jbelamaric@google.com>

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

f38fad5

…nagement-section # Conflicts: # content/en/docs/concepts/scheduling-eviction/dynamic-resource-allocation.md

Merge remote-tracking branch 'origin/dra-resource-management-section'…

6b6ad63

… into dra-resource-management-section

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

Caesarsage and others added 2 commits July 18, 2026 11:55

Update content/en/docs/concepts/resource-management/dynamic-resource-…

63a04c0

…allocation/device-taints.md Co-authored-by: John Belamaric <jbelamaric@google.com>

Update content/en/docs/concepts/resource-management/dynamic-resource-…

660c071

…allocation/device-taints.md Co-authored-by: John Belamaric <jbelamaric@google.com>

kubernetes-prow Bot added the do-not-merge/hold Indicates that a PR should not merge because someone has issued a /hold command. label Jul 18, 2026

kubernetes-prow Bot assigned lmktfy Jul 18, 2026

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

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

kubernetes-prow Bot removed the do-not-merge/hold Indicates that a PR should not merge because someone has issued a /hold command. label Jul 21, 2026

kubernetes-prow Bot merged commit c583627 into kubernetes:dev-1.37 Jul 21, 2026
6 checks passed

This was referenced Jul 26, 2026

DRA: GA graduation of DRA device taints #56265

Merged

Repoint DRA links after docs reorganization #56639

Open

DRA: relocate extended-resource and device-metadata sections #56642

Merged

nojnhuh mentioned this pull request Jul 30, 2026

DRA resourcepoolstatusrequest #56352

Merged

LionelJouin mentioned this pull request Aug 3, 2026

[KEP-4817] Update to GA, add an example #56363

Merged

nojnhuh mentioned this pull request Aug 4, 2026

[KEP-5941] DRASharedConsumableCapacity documentation #56218

Open


		<!-- body -->

		## Extended resource allocation by DRA {#extended-resource}

		in the `kube-apiserver` and `kube-controller-manager`.


		## DRA device metadata in containers {#device-metadata}

Uh oh!

Conversation

Caesarsage commented Jun 28, 2026

Issue

Uh oh!

netlify Bot commented Jun 28, 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 Jun 28, 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!

lmktfy commented Jun 28, 2026

Uh oh!

Uh oh!

Caesarsage commented Jul 4, 2026

Uh oh!

johnbelamaric left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

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

Uh oh!

Uh oh!

kubernetes-prow Bot commented Jul 18, 2026

Uh oh!

kubernetes-prow Bot commented Jul 18, 2026

Uh oh!

Caesarsage commented Jul 18, 2026

Uh oh!

reylejano commented Jul 21, 2026

Uh oh!

lmktfy commented Jul 21, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

netlify Bot commented Jun 28, 2026 •

edited

Loading

netlify Bot commented Jun 28, 2026 •

edited

Loading

lmktfy commented Jul 18, 2026 •

edited

Loading