Skip to content

Commit b5484ad

Browse files
committed
Update QoS definitions to include Pod-level resources
Signed-off-by: Chris Henzie <[email protected]>
1 parent 13d9b63 commit b5484ad

File tree

1 file changed

+10
-2
lines changed

1 file changed

+10
-2
lines changed

content/en/docs/concepts/workloads/pods/pod-qos.md

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -50,6 +50,13 @@ For a Pod to be given a QoS class of `Guaranteed`:
5050
* Every Container in the Pod must have a CPU limit and a CPU request.
5151
* For every Container in the Pod, the CPU limit must equal the CPU request.
5252

53+
If instead the Pod uses [Pod-level resources](/docs/concepts/configuration/manage-resources-containers/#pod-level-resource-specification):
54+
55+
{{< feature-state feature_gate_name="PodLevelResources" >}}
56+
57+
* The Pod must have a Pod-level memory limit and memory request, and their values must be equal.
58+
* The Pod must have a Pod-level CPU limit and CPU request, and their values must be equal.
59+
5360
### Burstable
5461

5562
Pods that are `Burstable` have some lower-bound resource guarantees based on the request, but
@@ -65,7 +72,8 @@ that is `Burstable` can try to use any amount of node resources.
6572
A Pod is given a QoS class of `Burstable` if:
6673

6774
* The Pod does not meet the criteria for QoS class `Guaranteed`.
68-
* At least one Container in the Pod has a memory or CPU request or limit.
75+
* At least one Container in the Pod has a memory or CPU request or limit,
76+
or the Pod has a Pod-level memory or CPU request or limit.
6977

7078
### BestEffort
7179

@@ -81,7 +89,7 @@ The kubelet prefers to evict `BestEffort` Pods if the node comes under resource
8189
A Pod has a QoS class of `BestEffort` if it doesn't meet the criteria for either `Guaranteed`
8290
or `Burstable`. In other words, a Pod is `BestEffort` only if none of the Containers in the Pod have a
8391
memory limit or a memory request, and none of the Containers in the Pod have a
84-
CPU limit or a CPU request.
92+
CPU limit or a CPU request, and the Pod does not have any Pod-level memory or CPU limits or requests.
8593
Containers in a Pod can request other resources (not CPU or memory) and still be classified as
8694
`BestEffort`.
8795

0 commit comments

Comments
 (0)