kubernetes / kubernetes/website

Add HPA / VPA scenario to PDB examples

Open Beginner friendly
#55,178 2 comments 0 reactions 0 assignees View on GitHub
kind/feature language/en priority/backlog triage/accepted
Dominant language
HTML
Stars
5.4k
Forks
15.7k
Avg merge
4d 18h
Merged PRs (30d)
204

Description

**This is a Feature Request**

The [Think about how your application reacts to disruptions](https://kubernetes.io/docs/tasks/run-application/configure-pdb/#think-about-how-your-application-reacts-to-disruptions) section in [configure-pdb](https://kubernetes.io/docs/tasks/run-application/configure-pdb) covers some scenarios. I'd like to add an entry for workloads autoscaled by HPA or VPA, recommending `maxUnavailable` over `minAvailable`.
When `minAvailable` is set as an absolute number and HPA scales the replicas below that value, allowed Disruptions stays at 0, which blocks drain. `maxUnavailable` (>=1) avoids this because it always allows at least one eviction as long as the value is 1 or greater, regardless of the current replica count.

**Why is this needed**

HPA is widely used, and PDB is recommended for production workloads. The interaction of these two is not documented anywhere.

**Comments**

I encountered this issue in a prod environment and think this guidance can belong to the official docs.
I'd like to hear whether this documentation has enough value or not.

Contributor guide

Open the contributing guide

Research direction

Start with the “Think about how your application reacts to disruptions” section in the configure-pdb documentation linked in the issue, and review its existing scenarios. Add an HPA/VPA scenario explaining why maxUnavailable is preferable to an absolute minAvailable value, then verify the guidance is clear and consistent with the surrounding PDB examples.

Written by the indexing model from the issue text.

Assessment

Tech stack
kubernetes
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
68/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.