容器与云原生 / 系统课时
用 LimitRange 约束单 Pod 规格
用 LimitRange 约束单 Pod 规格
LimitRange 在 Pod 进入命名空间时补齐缺失的资源声明,并拒绝过小、过大或比例异常的容器规格。本课会配置默认 requests、limits 与上下界,并验证它们如何影响调度、HPA 利用率和配额消耗。
学习目标
- 配置容器级默认 requests、limits、最小值和最大值
- 验证 LimitRange 的默认注入与准入拒绝行为
- 解释默认 requests 对 Scheduler、HPA 与 ResourceQuota 的连锁影响
LimitRange 在准入阶段做什么
LimitRange 是命名空间级准入策略。对 type: Container 的规则,它既可以给未声明资源的容器填充 defaultRequest 和 default,也可以用 min、max 与 maxLimitRequestRatio 拒绝不符合约束的新 Pod。
它不会持续修改正在运行的 Pod。修改 LimitRange 后,已有 Pod 的资源声明保持不变;只有后续创建或重建的 Pod 会按新规则重新准入。

配置默认值和上下界
下面的规则把未声明资源的容器默认设置为 200m/128Mi requests 和 800m/512Mi limits,同时约束 CPU、内存的最小值、最大值以及 limit/request 最大比例。
apiVersion: v1
kind: Namespace
metadata:
name: pod-guardrails
---
apiVersion: v1
kind: LimitRange
metadata:
name: container-guardrails
namespace: pod-guardrails
spec:
limits:
- type: Container
defaultRequest:
cpu: "200m"
memory: "128Mi"
default:
cpu: "800m"
memory: "512Mi"
min:
cpu: "100m"
memory: "64Mi"
max:
cpu: "2"
memory: "1Gi"
maxLimitRequestRatio:
cpu: "4"
memory: "4"将内容保存为 limitrange.yaml 后应用。
kubectl apply -f limitrange.yaml预期输出
namespace/pod-guardrails created
limitrange/container-guardrails created这里的默认 limit 与默认 request 比例都是 4,不会与 maxLimitRequestRatio 自相冲突。设计默认值时必须先做这种一致性检查,否则“自动补齐”后的 Pod 也可能被同一条 LimitRange 拒绝。
验证默认注入与拒绝
先创建一个完全没有 resources 字段的 Pod。
kubectl -n pod-guardrails run defaulted --image=nginx:1.27 --restart=Never预期输出
pod/defaulted created读取准入后真正写入 PodSpec 的资源值。
kubectl -n pod-guardrails get pod defaulted -o jsonpath='req cpu={.spec.containers[0].resources.requests.cpu}, req memory={.spec.containers[0].resources.requests.memory}, limit cpu={.spec.containers[0].resources.limits.cpu}, limit memory={.spec.containers[0].resources.limits.memory}{"\n"}'预期输出
req cpu=200m, req memory=128Mi, limit cpu=800m, limit memory=512Mi再提交一个 CPU request 只有 50m 的 Pod,并显式给出 limits,使它只违反 min.cpu=100m 这一条规则。
kubectl -n pod-guardrails apply -f - <<'YAML'
apiVersion: v1
kind: Pod
metadata:
name: too-small
spec:
containers:
- name: web
image: nginx:1.27
resources:
requests:
cpu: "50m"
memory: "128Mi"
limits:
cpu: "200m"
memory: "512Mi"
YAML预期输出类似
Error from server (Forbidden): error when creating "STDIN": pods "too-small" is forbidden: minimum cpu usage per Container is 100m, but request is 50m不同 Kubernetes 版本的错误前缀可能略有差异,但拒绝原因应明确指向容器 CPU request 低于 100m。
与 HPA 和 ResourceQuota 协同
LimitRange 解决的是“单个 Pod 规格是否合理”,ResourceQuota 解决的是“整个命名空间能消耗多少声明预算”。两者组合时,LimitRange 注入的默认 requests 和 limits 会真实写入 PodSpec,因此也会计入 ResourceQuota。
对基于 CPU 利用率的 HPA,requests 还会成为利用率计算的分母。默认 request 过小,Pod 很容易表现为高利用率并触发更激进的扩容;默认 request 过大,则会让 Scheduler 预留过多容量,并可能让 HPA 看起来利用率偏低。因此默认值不应只是为了“让 Pod 能创建”,而应接近该类工作负载的正常资源基线。
实际治理时,先用 LimitRange 消除缺失声明和极端规格,再用 ResourceQuota 控制命名空间总预算,最后让 HPA 的 maxReplicas 与可用预算、滚动发布余量保持一致。这样单 Pod 规格、水平伸缩和总容量才不会互相打架。