Skip to content

Conversation

@ndixita
Copy link
Contributor

@ndixita ndixita commented Oct 24, 2025

Description

Adding documentation for InPlacePodLevelResourcesVerticalScaling feature alpha stage.

Issue: kubernetes/enhancements#5419

@k8s-ci-robot k8s-ci-robot added cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. labels Oct 24, 2025
@netlify
Copy link

netlify bot commented Oct 24, 2025

Pull request preview available for checking

Built without sensitive environment variables

Name Link
🔨 Latest commit 7bedc9b
🔍 Latest deploy log https://app.netlify.com/projects/kubernetes-io-main-staging/deploys/691bd2c07db98d000894e6c3
😎 Deploy Preview https://deploy-preview-52928--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.

@divya-mohan0209
Copy link
Contributor

Hi @ndixita , since this is for the 1.35 release, please could you open it against the 1.35-dev branch?

cc: @kubernetes/release-team-docs

@lmktfy
Copy link
Member

lmktfy commented Oct 24, 2025

/sig node
/language en

@k8s-ci-robot k8s-ci-robot added sig/node Categorizes an issue or PR as relevant to SIG Node. language/en Issues or PRs related to English language labels Oct 24, 2025
@ndixita ndixita marked this pull request as draft October 24, 2025 18:16
@k8s-ci-robot k8s-ci-robot added the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Oct 24, 2025
@ndixita ndixita changed the base branch from main to dev-1.35 October 24, 2025 18:17
@ndixita ndixita marked this pull request as ready for review October 24, 2025 18:17
@k8s-ci-robot k8s-ci-robot added size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. and removed do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. labels Oct 24, 2025
@lmktfy
Copy link
Member

lmktfy commented Oct 25, 2025

189 commits? We shouldn't merge but as is.
/hold

until the number is much lower

@k8s-ci-robot k8s-ci-robot added the do-not-merge/hold Indicates that a PR should not merge because someone has issued a /hold command. label Oct 25, 2025
@Jimmykhangnguyen
Copy link

Hello @ndixita 👋, v1.35 Docs Team here again!

We are closing in on the deadline to get your PR ready for review before Tuesday 18th November 2025, so I'm sending a second reminder. Please take a look at the Documenting for a release - PR Ready for Review document to get your PR ready for review before the deadline.

Please also let us know once your PR is fully Ready for Review -- meaning all documentation updates are complete and it's awaiting reviewer feedback -- so we can update our tracking.

Thank you!

@netlify
Copy link

netlify bot commented Nov 18, 2025

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

Name Link
🔨 Latest commit 7bedc9b
🔍 Latest deploy log https://app.netlify.com/projects/kubernetes-io-vnext-staging/deploys/691bd2c0d9499e0008882831

@k8s-ci-robot
Copy link
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 lmktfy for approval. For more information see the Code Review Process.

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

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

@k8s-ci-robot k8s-ci-robot added size/L Denotes a PR that changes 100-499 lines, ignoring generated files. and removed size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. labels Nov 18, 2025
@ndixita ndixita changed the title Placeholder for documentation updates for Pod Level In Place resize Documentation updates for Pod Level In Place resize alpha Nov 18, 2025
@ndixita
Copy link
Contributor Author

ndixita commented Nov 18, 2025

@Jimmykhangnguyen PR is ready for review

@ndixita
Copy link
Contributor Author

ndixita commented Nov 18, 2025

/cc @tallclair

…ple for alpha stage of InPlacePodLevelResourcesVerticalScaling feature

Signed-off-by: ndixita <ndixita@google.com>

The In-place Pod Resize feature allows modifying resource allocations for a running Pod, avoiding application disruption. The process for resizing individual container resources is covered in the documentation [Resize CPU and Memory Resources assigned to Containers](/docs/tasks/configure-pod-container/resize-container-resources.md).

This document focuses on the new capability introduced in Kubernetes v1.35: In-place
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
This document focuses on the new capability introduced in Kubernetes v1.35: In-place
This document focuses on the In-place

do not mention versions. It will be easier to promote the documentation later. Version is already auto-generated by FG tag above


{{< include "task-tutorial-prereqs.md" >}} {{< version-check >}}

Your Kubernetes server must be at or later than version 1.35.
Copy link
Member

Choose a reason for hiding this comment

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

you already have a version check above. This is how it looks rendered:

image

@@ -0,0 +1,160 @@
---
title: Resize CPU and Memory Resources assigned to Containers
Copy link
Member

Choose a reason for hiding this comment

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

I am not sure why it doesn't show up in left pane, maybe some index needs to be updated as well:

image

https://deploy-preview-52928--kubernetes-io-main-staging.netlify.app/docs/tasks/configure-pod-container/resize-pod-resources/


The following [feature
gates](/docs/reference/command-line-tools-reference/feature-gates/) must be enabled
for your control plane and for all nodes in your cluster:
Copy link
Member

Choose a reason for hiding this comment

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

do we need declared features as well?


* Retry Priority: Deferred resizes are retried based on PriorityClass, then QoS class (Guaranteed over Burstable), and finally by the duration they have been deferred.

* Tracking: You can use the observedGeneration fields to track which Pod specification (metadata.generation) corresponds to the status of the latest processed resize request.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
* Tracking: You can use the observedGeneration fields to track which Pod specification (metadata.generation) corresponds to the status of the latest processed resize request.
* Tracking: You can use the `observedGeneration` fields to track which Pod specification (metadata.generation) corresponds to the status of the latest processed resize request.

the sum of container limits is permitted to exceed the Pod-level limit, enabling
resource sharing across containers within the Pod.

## Example: Resizing Pod-Level Resources
Copy link
Member

Choose a reason for hiding this comment

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

it will be nice to give example of failed resize as part of this task page

defaultValue: false
fromVersion: "1.35"
---
Enables in-place pod-level resources vertical scaling.
Copy link
Member

Choose a reason for hiding this comment

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

Maybe link to the task page. The sentence by itself is hard to parse to somebody who is not super expert in k8s

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. do-not-merge/hold Indicates that a PR should not merge because someone has issued a /hold command. language/en Issues or PRs related to English language sig/node Categorizes an issue or PR as relevant to SIG Node. size/L Denotes a PR that changes 100-499 lines, ignoring generated files.

Development

Successfully merging this pull request may close these issues.

6 participants