Skip to content

Commit 159afb1

Browse files
committed
Make API changes for CPU Startup boost
These changes are based on discussion in #8175 (comment) https://kubernetes.slack.com/archives/C0EG7JC6T/p1751910562504969
1 parent 017738e commit 159afb1

File tree

1 file changed

+13
-5
lines changed
  • vertical-pod-autoscaler/enhancements/7862-cpu-startup-boost

1 file changed

+13
-5
lines changed

vertical-pod-autoscaler/enhancements/7862-cpu-startup-boost/README.md

Lines changed: 13 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -84,13 +84,20 @@ VPA Admission Controller
8484

8585
1. The VPA Admission Controller modifies the pod's containers CPU request and
8686
limits to align with its `StartupBoost` policy, if specified, during the pod
87-
creation.
87+
creation. The boosted value is based on the VPA recommendation available at the
88+
time of admission. During the boost period, no resizing will take place.
8889

8990
1. The VPA Updater monitors pods targeted by the VPA object and when the pod
90-
condition is `Ready` and `StartupBoost.CPU.Duration` has elapsed, it scales
91-
down the CPU resources to the appropriate non-boosted value, which is determined by the VPA `updatePolicy`:
92-
* If `updatePolicy` is `Auto`, `Recreate` or `InPlaceOrRecreate`, the VPA Updater will apply the VPA recommendation, even if it's higher than the boosted value.
93-
* If `updatePolicy` is `Off`, the VPA Updater will revert the CPU resources to the values specified in the pod spec.
91+
condition is `Ready` and `StartupBoost.CPU.Duration` has elapsed, it scales
92+
down the CPU resources to the appropriate non-boosted value. This "unboosting"
93+
resizes the pod to whatever the recommendation is at that moment. The specific
94+
behavior is determined by the VPA `updatePolicy`:
95+
* If `updatePolicy` is `Auto`, `Recreate` or `InPlaceOrRecreate`, the VPA
96+
Updater will apply the current VPA recommendation, even if it's higher than
97+
the boosted value.
98+
* If `updatePolicy` is `Off` for the VPA object, or `mode` is `Off` in a
99+
container policy, the VPA Updater will revert the CPU resources to the
100+
values specified in the pod spec.
94101
* The scale down is applied [in-place](https://github.com/kubernetes/enhancements/tree/master/keps/sig-node/1287-in-place-update-pod-resources).
95102

96103
### API Changes
@@ -429,6 +436,7 @@ spec:
429436

430437
## Implementation History
431438

439+
* 2025-08-05: Make some API changes and clarify behavior during and after boost period in the workflow section.
432440
* 2025-06-23: Decouple Startup CPU Boost from InPlaceOrRecreate mode, allow
433441
users to specify a `startupBoost` config in `VerticalPodAutoscalerSpec` and in
434442
`ContainerPolicies` to make the API simpler and add more yaml examples.

0 commit comments

Comments
 (0)