容器与云原生 / 系统课时

用 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 会按新规则重新准入。

LimitRange 对 Pod 规格的准入路径

配置默认值和上下界

下面的规则把未声明资源的容器默认设置为 200m/128Mi requests 和 800m/512Mi limits,同时约束 CPU、内存的最小值、最大值以及 limit/request 最大比例。

yaml
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 后应用。

bash
kubectl apply -f limitrange.yaml

预期输出

text
namespace/pod-guardrails created
limitrange/container-guardrails created

这里的默认 limit 与默认 request 比例都是 4,不会与 maxLimitRequestRatio 自相冲突。设计默认值时必须先做这种一致性检查,否则“自动补齐”后的 Pod 也可能被同一条 LimitRange 拒绝。

验证默认注入与拒绝

先创建一个完全没有 resources 字段的 Pod。

bash
kubectl -n pod-guardrails run defaulted --image=nginx:1.27 --restart=Never

预期输出

text
pod/defaulted created

读取准入后真正写入 PodSpec 的资源值。

bash
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"}'

预期输出

text
req cpu=200m, req memory=128Mi, limit cpu=800m, limit memory=512Mi

再提交一个 CPU request 只有 50m 的 Pod,并显式给出 limits,使它只违反 min.cpu=100m 这一条规则。

bash
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

预期输出类似

text
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 规格、水平伸缩和总容量才不会互相打架。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 LimitRange 约束单 Pod 规格

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通