Skip to content

Commit 9e74089

Browse files
authored
Merge pull request #37379 from Kartik494/besteffortpods
Document special case of ResourceQuota for cpu and memory
2 parents a3c1261 + 6abdc25 commit 9e74089

File tree

1 file changed

+12
-0
lines changed

1 file changed

+12
-0
lines changed

content/en/docs/concepts/policy/resource-quotas.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -39,6 +39,18 @@ Resource quotas work like this:
3939
See the [walkthrough](/docs/tasks/administer-cluster/manage-resources/quota-memory-cpu-namespace/)
4040
for an example of how to avoid this problem.
4141

42+
{{< note >}}
43+
- For `cpu` and `memory` resources, ResourceQuotas enforce that **every**
44+
(new) pod in that namespace sets a limit for that resource.
45+
If you enforce a resource quota in a namespace for either `cpu` or `memory`,
46+
you, and other clients, **must** specify either `requests` or `limits` for that resource,
47+
for every new Pod you submit. If you don't, the control plane may reject admission
48+
for that Pod.
49+
- For other resources: ResourceQuota works and will ignore pods in the namespace without setting a limit or request for that resource. It means that you can create a new pod without limit/request ephemeral storage if the resource quota limits the ephemeral storage of this namespace.
50+
You can use a [LimitRange](/docs/concepts/policy/limit-range/) to automatically set
51+
a default request for these resources.
52+
{{< /note >}}
53+
4254
The name of a ResourceQuota object must be a valid
4355
[DNS subdomain name](/docs/concepts/overview/working-with-objects/names#dns-subdomain-names).
4456

0 commit comments

Comments
 (0)