resourcequota是kubernetes中限制命名空间级资源总量的机制,通过hard字段设置cpu、内存、存储及对象数量上限;需与limitrange配合使用以确保配额生效。

在 Kubernetes 中,ResourceQuota 是限制命名空间级别资源总量的核心机制,它不分配资源,而是设置“上限”,防止某个命名空间无节制地消耗集群资源。正确配置 ResourceQuota 能有效避免因单个命名空间抢占过多 CPU、内存或对象数量而影响其他业务。
ResourceQuota 的作用范围和关键字段
ResourceQuota 必须定义在具体命名空间内(不能跨命名空间生效),它通过 hard 字段声明该命名空间允许使用的资源总量上限,支持三类限制:
-
计算资源:如
requests.cpu、requests.memory、limits.cpu、limits.memory—— 控制 Pod 请求/限制的总和 -
存储资源:如
requests.storage、ephemeral-storage—— 限制 PVC 或临时存储总量 -
对象数量:如
pods、services、replicationcontrollers、configmaps、secrets等 —— 防止元数据爆炸
创建一个典型的 ResourceQuota 示例
以下 YAML 限制命名空间 dev-team 最多使用 4 核 CPU、8Gi 内存、20 个 Pod 和 10 个 Service:
apiVersion: v1
kind: ResourceQuota
metadata:
name: quota-dev
namespace: dev-team
spec:
hard:
requests.cpu: "4"
requests.memory: 8Gi
limits.cpu: "6"
limits.memory: 12Gi
pods: "20"
services: "10"
configmaps: "50"
secrets: "30"
注意:limits 和 requests 是独立统计的;若未设 limits,Pod 可不设 limit,但受 requests 约束;所有数值必须带单位(如 "4"、8Gi、"20")。
验证与排查配额是否生效
配额创建后不会自动拒绝超限请求,而是由 API Server 在创建/更新资源时实时校验。可通过以下方式确认状态:
- 运行
kubectl describe quota -n dev-team查看当前已用配额(Used)和剩余(Hard) - 尝试创建超出配额的 Pod,会收到类似错误:
error: failed to create resource: pods "test-pod" is forbidden: exceeded quota: quota-dev, requested: requests.memory=4Gi, used: requests.memory=6Gi, limited: requests.memory=8Gi - 检查事件:
kubectl get events -n dev-team --field-selector reason=FailedCreate
配合 LimitRange 实现更精细控制
ResourceQuota 管“总量”,LimitRange 管“单个容器默认值和上下限”。两者常搭配使用:
- 为命名空间设置 LimitRange,自动为未声明 resources 的 Pod 注入默认 request/limit
- 这样能确保 ResourceQuota 统计有据可依,避免用户故意不写 requests 导致 quota 形同虚设
- 例如:LimitRange 设定默认
requests.memory: 512Mi,那么 20 个 Pod 就天然占用至少 10Gi 内存,配合 ResourceQuota 的 8Gi 限制就会立刻触发拒绝











