[KEP-5004] DRA Extended resource documentation #51710

yliaog · 2025-07-26T23:16:36Z

Description

Documentation for the DRA Extended resource feature

Issue

Closes: #

netlify · 2025-07-26T23:24:13Z

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

Name	Link
🔨 Latest commit	`f453b00`
🔍 Latest deploy log	https://app.netlify.com/projects/kubernetes-io-vnext-staging/deploys/689302419b76c0000867ce7e

netlify · 2025-07-26T23:26:39Z

✅ Pull request preview available for checking

Built without sensitive environment variables

Name	Link
🔨 Latest commit	`dbbe065`
🔍 Latest deploy log	https://app.netlify.com/projects/kubernetes-io-main-staging/deploys/688561d77dc0510008271bc9
😎 Deploy Preview	https://deploy-preview-51710--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.

netlify · 2025-07-26T23:35:47Z

✅ Pull request preview available for checking

Built without sensitive environment variables

Name	Link
🔨 Latest commit	`ee7b4c1`
🔍 Latest deploy log	https://app.netlify.com/projects/kubernetes-io-main-staging/deploys/6885638f6f8bb90008da27b4
😎 Deploy Preview	https://deploy-preview-51710--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.

netlify · 2025-07-26T23:44:27Z

✅ Pull request preview available for checking

Built without sensitive environment variables

Name	Link
🔨 Latest commit	`f453b00`
🔍 Latest deploy log	https://app.netlify.com/projects/kubernetes-io-main-staging/deploys/68930241d12ddd0008d06330
😎 Deploy Preview	https://deploy-preview-51710--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.

dipesh-rawat · 2025-07-27T11:25:40Z

/remove-language ja ko pt uk zh
/remove-area localization

lmktfy · 2025-07-29T07:24:56Z

content/en/docs/reference/command-line-tools-reference/feature-gates/DRAExtendedResource.md

+    defaultValue: false
+    fromVersion: "1.34"
+---
+Enables support for the [Extended Resource allocation by DRA](/docs/concepts/scheduling-eviction/dynamic-resource-allocation/#extended-resource) feature. It makes it possible to specify an extended resource name in a DeviceClass.


(nit)
I would link to a subsection of https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/ (which would then hyperlink to the DRA docs).

This framing is OK for alpha; at beta, we raise the quality expectation for feature docs.

do you suggest to link to https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/#extended-resources ? this section does not have DRA related information, not a good link to point to, IMO.

I do, and you will need to make va small edit to that page.

ok, added a subsection to that page, and added link to that page's subsection. PTAL

johnbelamaric · 2025-07-29T14:55:16Z

When we document this improvement, we should also update (at least briefly):

Should we do that for alpha or just when we reach beta?

lmktfy · 2025-07-29T18:37:19Z

When we document this improvement, we should also update (at least briefly):

Should we do that for alpha or just when we reach beta?

The basic mention-and-hyperlink should be there even at alpha. For beta, if it's enabled by default, the docs should be close to GA quality.

yliaog · 2025-07-29T22:54:00Z

added basic mention-and-hyperlink to the list of docs, PTAL

johnbelamaric · 2025-08-01T17:49:08Z

/lgtm

k8s-ci-robot · 2025-08-01T17:49:15Z

LGTM label has been added.

Git tree hash: c0dcc4e3774245b01dc4f5db9580c8cf30d5e5c4

michellengnx · 2025-08-02T19:33:50Z

Hello @yliaog 👋! I'm reaching out from the Docs team. Just checking in as we approach Docs Freeze on Wednesday August 6, 2025 18:00 PDT. This documentation appears to still be under review. To meet the Docs Freeze, this PR must have a technical review as well as lgtm and approve labels applied, without any unaddressed comments or concerns from SIG Docs. Thank you!

yliaog · 2025-08-04T19:20:21Z

@lmktfy PTAL

lmktfy · 2025-08-04T19:41:35Z

content/en/docs/reference/command-line-tools-reference/feature-gates/DRAExtendedResource.md

+Enables support for the [Extended Resource allocation by DRA](/docs/concepts/configuration/manage-resources-containers/#extended-resources-allocation-by-dra) feature.
+It makes it possible to specify an extended resource name in a DeviceClass.
+
+This feature gate has no effect unless you also enable the `DynamicResourceAllocation` feature gate.


In v1.34 that gate is on by default, so we should reword. However you can disable it (and your cluster then won't pass conformance…)

hmmm, we used the same wording in other DRA alpha features, e.g. PrioritizedList (content/en/docs/reference/command-line-tools-reference/feature-gates/DRAPrioritizedList.md), do you suggest to change this in all other DRA alpha features? any suggestion on the wording?

@lmktfy please let me know your opinion on the above question, trying to resolve this before the doc freeze.

johnbelamaric · 2025-08-05T17:39:23Z

/approve

for DRA

content/en/docs/reference/command-line-tools-reference/feature-gates/DRAExtendedResource.md

Co-authored-by: John Belamaric <[email protected]>

lmktfy

/lgtm
/approve

lmktfy · 2025-08-06T07:21:06Z

content/en/docs/concepts/configuration/manage-resources-containers.md


+#### Extended resources allocation by DRA
+Extended resources allocation by DRA allows cluster administrators to specify an `extendedResourceName`
+in `DeviceClass`, then the devices matching the `DeviceClass` can be requested from a pod's extended


(nit) we prefer not to put backticks around API kinds, such as DeviceClass

#51815 PTAL

lmktfy · 2025-08-06T07:23:06Z

content/en/docs/reference/command-line-tools-reference/feature-gates/DRAExtendedResource.md

+Enables support for the [Extended Resource allocation by DRA](/docs/concepts/configuration/manage-resources-containers/#extended-resources-allocation-by-dra) feature.
+It makes it possible to specify an extended resource name in a DeviceClass.
+
+This feature gate has no effect unless the `DynamicResourceAllocation` feature gate is enabled.


We should revise the DynamicResourceAllocation file so that people know to update this one when they lock DynamicResourceAllocation to enabled.

DynamicResourceAllocation file already has the following, what else do you like to add?

Extended resource allocation by DRA is an alpha feature and only enabled when the
DRAExtendedResource feature gate
is enabled in the kube-apiserver, kube-scheduler, and kubelet.

k8s-ci-robot · 2025-08-06T07:23:35Z

LGTM label has been added.

Git tree hash: a06e3da6117c584439773bca425c3830d4902034

k8s-ci-robot · 2025-08-06T07:23:42Z

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: johnbelamaric, lmktfy

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

The pull request process is described here

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

k8s-ci-robot added the cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. label Jul 26, 2025

k8s-ci-robot requested a review from dipesh-rawat July 26, 2025 23:16

k8s-ci-robot added the language/en Issues or PRs related to English language label Jul 26, 2025

k8s-ci-robot requested a review from pohly July 26, 2025 23:16

k8s-ci-robot added the size/M Denotes a PR that changes 30-99 lines, ignoring generated files. label Jul 26, 2025

yliaog changed the base branch from main to dev-1.34 July 26, 2025 23:22

k8s-ci-robot added size/L Denotes a PR that changes 100-499 lines, ignoring generated files. and removed size/M Denotes a PR that changes 30-99 lines, ignoring generated files. labels Jul 26, 2025

yliaog force-pushed the main branch from dbbe065 to ee7b4c1 Compare July 26, 2025 23:23

yliaog force-pushed the main branch from ee7b4c1 to 233566a Compare July 26, 2025 23:27

k8s-ci-robot added size/M Denotes a PR that changes 30-99 lines, ignoring generated files. and removed size/L Denotes a PR that changes 100-499 lines, ignoring generated files. labels Jul 26, 2025

lmktfy reviewed Jul 29, 2025

View reviewed changes

yliaog force-pushed the main branch 2 times, most recently from 7410045 to 650121e Compare July 29, 2025 22:53

[KEP-5004] DRA Extended resource documentation

e694d6e

yliaog force-pushed the main branch from 650121e to e694d6e Compare July 31, 2025 21:16

k8s-ci-robot assigned johnbelamaric Aug 1, 2025

k8s-ci-robot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Aug 1, 2025

lmktfy reviewed Aug 4, 2025

View reviewed changes

johnbelamaric reviewed Aug 5, 2025

View reviewed changes

content/en/docs/reference/command-line-tools-reference/feature-gates/DRAExtendedResource.md Outdated Show resolved Hide resolved

Tweak wording

f453b00

Co-authored-by: John Belamaric <[email protected]>

k8s-ci-robot removed the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Aug 6, 2025

k8s-ci-robot requested a review from johnbelamaric August 6, 2025 07:20

lmktfy reviewed Aug 6, 2025

View reviewed changes

k8s-ci-robot assigned lmktfy Aug 6, 2025

k8s-ci-robot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Aug 6, 2025

k8s-ci-robot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Aug 6, 2025

k8s-ci-robot merged commit f6c3312 into kubernetes:dev-1.34 Aug 6, 2025
6 checks passed

k8s-ci-robot added this to the 1.34 milestone Aug 6, 2025

github-project-automation bot moved this from Needs Triage to Done in SIG Scheduling Aug 6, 2025

pohly moved this from 🆕 New to ✅ Done in Dynamic Resource Allocation Aug 19, 2025

[KEP-5004] DRA Extended resource documentation #51710

[KEP-5004] DRA Extended resource documentation #51710

Uh oh!

Conversation

yliaog commented Jul 26, 2025

Description

Issue

Uh oh!

netlify bot commented Jul 26, 2025 • 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 26, 2025

✅ Pull request preview available for checking

Uh oh!

netlify bot commented Jul 26, 2025

✅ Pull request preview available for checking

Uh oh!

netlify bot commented Jul 26, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Pull request preview available for checking

Uh oh!

dipesh-rawat commented Jul 27, 2025

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!

johnbelamaric commented Jul 29, 2025

Uh oh!

lmktfy commented Jul 29, 2025

Uh oh!

yliaog commented Jul 29, 2025

Uh oh!

johnbelamaric commented Aug 1, 2025

Uh oh!

k8s-ci-robot commented Aug 1, 2025

Uh oh!

michellengnx commented Aug 2, 2025

Uh oh!

yliaog commented Aug 4, 2025

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!

johnbelamaric commented Aug 5, 2025

Uh oh!

Uh oh!

lmktfy left a comment

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!

k8s-ci-robot commented Aug 6, 2025

Uh oh!

k8s-ci-robot commented Aug 6, 2025

Uh oh!

Uh oh!

Uh oh!

netlify bot commented Jul 26, 2025 •

edited

Loading

netlify bot commented Jul 26, 2025 •

edited

Loading