4. LimitRange 详解：概念、默认值、约束与协同

在 Kubernetes 集群中，LimitRange 是一种作用于命名空间的资源策略对象，用于为 Pod 及其内部容器设置资源请求（requests）和限制（limits）的默认值、最小值与最大值。它与 ResourceQuota 配合，形成“软约束 + 硬边界”的双层资源治理体系。

4.1 LimitRange 概念与作用域

LimitRange 在命名空间级别生效，支持对以下资源类型进行约束：

4.2 默认值设置（default / defaultRequest）

当 Pod 中的容器未显式设置资源请求或限制时，LimitRange 会自动注入默认值。这是保证集群资源可预测性的关键机制。

apiVersion: v1
kind: LimitRange
metadata:
  name: default-resource-limits
  namespace: production
spec:
  limits:
  - type: Container
    default:
      cpu: "500m"
      memory: "512Mi"
    defaultRequest:
      cpu: "200m"
      memory: "256Mi"

注入规则：

• default：当容器未设置 resources.limits 时，自动填充。
• defaultRequest：当容器未设置 resources.requests 时，自动填充。
• 如果容器只设置了 requests 而未设置 limits，则 limits 继承 default 值；反之亦然。
• 如果容器同时设置了 requests 和 limits，LimitRange 不会覆盖。

4.3 最小/最大约束（min / max）

通过 min 和 max 字段，LimitRange 可以强制 Pod 中每个容器的资源规格落在合法区间内。

spec:
  limits:
  - type: Container
    min:
      cpu: "100m"
      memory: "128Mi"
    max:
      cpu: "2"
      memory: "4Gi"

校验逻辑：

• 容器设置的 requests 和 limits 必须 ≥ min 且 ≤ max。
• 如果容器只设置了 requests，则 limits 默认等于 requests，但仍需满足 max 约束。
• 如果容器只设置了 limits，则 requests 默认等于 limits，但仍需满足 min 约束。
• 当 min 和 max 同时存在时，default 和 defaultRequest 也必须落在 [min, max] 区间内。

4.4 LimitRange 与 ResourceQuota 协同

ResourceQuota 控制命名空间内所有 Pod 的资源总量上限，而 LimitRange 控制单个 Pod 的资源规格边界。两者协同形成“总量 + 单量”的双重防线。

4.5 协同工作流程

1. 准入校验顺序：Kubernetes 准入控制器先校验 LimitRange（单容器边界），再校验 ResourceQuota（总量边界）。
2. 默认值注入：如果 Pod 未设置资源规格，LimitRange 注入默认值；然后 ResourceQuota 检查注入后的总量是否超出配额。
3. 拒绝场景：
   • 单个容器资源超出 LimitRange 的 min/max → 拒绝。
   • 所有 Pod 资源总和超出 ResourceQuota → 拒绝。
   • 两者同时违反 → 先报 LimitRange 错误。

4.6 典型配置示例

apiVersion: v1
kind: LimitRange
metadata:
  name: production-limits
  namespace: production
spec:
  limits:
  - type: Container
    min:
      cpu: "50m"
      memory: "64Mi"
    max:
      cpu: "4"
      memory: "8Gi"
    default:
      cpu: "500m"
      memory: "512Mi"
    defaultRequest:
      cpu: "200m"
      memory: "256Mi"
  - type: Pod
    min:
      cpu: "100m"
      memory: "128Mi"
    max:
      cpu: "8"
      memory: "16Gi"
  - type: PersistentVolumeClaim
    min:
      storage: "1Gi"
    max:
      storage: "100Gi"

4.7 常见问题与排查