Skip to content

[KEP-5941] DRASharedConsumableCapacity documentation - #56218

Open
SchSeba wants to merge 1 commit into
kubernetes:dev-1.37from
SchSeba:KEP_5941_dev_1.37
Open

[KEP-5941] DRASharedConsumableCapacity documentation#56218
SchSeba wants to merge 1 commit into
kubernetes:dev-1.37from
SchSeba:KEP_5941_dev_1.37

Conversation

@SchSeba

@SchSeba SchSeba commented Jun 23, 2026

Copy link
Copy Markdown

Description

Add documentation for the DRA Shared Consumable Capacity alpha feature:

  • Add DRASharedConsumableCapacity feature gate description
  • Add "Shared consumable capacity" section to the DRA concepts page
    with SR-IOV bandwidth example showing requestPolicy on shared
    counters and valueFrom mappings on device counter consumption

Add documentation for the DRA Shared Consumable Capacity alpha feature:
- Add DRASharedConsumableCapacity feature gate description
- Add "Shared consumable capacity" section to the DRA concepts page
  with SR-IOV bandwidth example showing requestPolicy on shared
  counters and valueFrom mappings on device counter consumption

Signed-off-by: Sebastian Sch <sebassch@gmail.com>
@kubernetes-prow kubernetes-prow Bot added this to the 1.37 milestone Jun 23, 2026
@netlify

netlify Bot commented Jun 23, 2026

Copy link
Copy Markdown

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

Name Link
🔨 Latest commit 8a6957d
🔍 Latest deploy log https://app.netlify.com/projects/kubernetes-io-vnext-staging/deploys/6a3a936e56a809000887befd

@kubernetes-prow kubernetes-prow Bot added the cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. label Jun 23, 2026
@kubernetes-prow
kubernetes-prow Bot requested a review from pohly June 23, 2026 14:08
@kubernetes-prow kubernetes-prow Bot added the language/en Issues or PRs related to English language label Jun 23, 2026
@kubernetes-prow

Copy link
Copy Markdown
Contributor

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign divya-mohan0209 for approval. For more information see the Code Review Process.

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

Details Needs approval from an approver in each of these files:

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

@kubernetes-prow
kubernetes-prow Bot requested a review from salaxander June 23, 2026 14:08
@kubernetes-prow kubernetes-prow Bot added the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label Jun 23, 2026
@netlify

netlify Bot commented Jun 23, 2026

Copy link
Copy Markdown

Pull request preview available for checking

Built without sensitive environment variables

Name Link
🔨 Latest commit 8a6957d
🔍 Latest deploy log https://app.netlify.com/projects/kubernetes-io-main-staging/deploys/6a3a936e35917d0008c6714f
😎 Deploy Preview https://deploy-preview-56218--kubernetes-io-main-staging.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

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

@victord-ef

Copy link
Copy Markdown
Contributor

/assign @kernel-kun

@singh1203

Copy link
Copy Markdown
Member

Hi @SchSeba, @LionelJouin 👋! v1.37 Docs team here

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

Note

Could you please confirm:

  1. Are all of the required changes done from your end?
  2. 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!

@nojnhuh

nojnhuh commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

/wg device-management

@kubernetes-prow kubernetes-prow Bot added the wg/device-management Categorizes an issue or PR as relevant to WG Device Management. label Jul 22, 2026
@kubernetes-prow kubernetes-prow Bot added the needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. label Jul 22, 2026
@kubernetes-prow

Copy link
Copy Markdown
Contributor

PR needs rebase.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

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

Copy link
Copy Markdown
Contributor

@SchSeba could you please rebase this? We need to review and have this merged today. :)

@nojnhuh nojnhuh left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM overall, just one suggestion about where to move this section and another for consistency with other recent changes.

`DRAListTypeAttributes` [feature gate](/docs/reference/command-line-tools-reference/feature-gates/)
is enabled in the kube-apiserver and kube-scheduler.

### Shared consumable capacity {#shared-consumable-capacity}

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

#56295 reorganized these docs into multiple pages. Right after the "Consumable Capacity" section seems like a reasonable place to move this section:

Comment on lines +1771 to +1773
Shared consumable capacity is an *alpha feature* and only enabled when the
[`DRASharedConsumableCapacity` feature gate](/docs/reference/command-line-tools-reference/feature-gates/#DRASharedConsumableCapacity)
is enabled in the kube-apiserver and kube-scheduler.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

#56295 also tweaked how the feature gates for each feature are described:

Suggested change
Shared consumable capacity is an *alpha feature* and only enabled when the
[`DRASharedConsumableCapacity` feature gate](/docs/reference/command-line-tools-reference/feature-gates/#DRASharedConsumableCapacity)
is enabled in the kube-apiserver and kube-scheduler.
Shared consumable capacity is controlled by the
[`DRASharedConsumableCapacity`](/docs/reference/command-line-tools-reference/feature-gates/#DRASharedConsumableCapacity) feature gate
in the `kube-apiserver` and `kube-scheduler`.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. language/en Issues or PRs related to English language needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. size/L Denotes a PR that changes 100-499 lines, ignoring generated files. wg/device-management Categorizes an issue or PR as relevant to WG Device Management.

Projects

Status: 🏗 In progress

Development

Successfully merging this pull request may close these issues.

7 participants