2. K8s资源配额基础：ResourceQuota对象详解、LimitRange对象详解、命名空间级别的资源管控机制

在Kubernetes集群中，资源配额（Resource Quota）与限制范围（Limit Range）是命名空间级别资源管控的两大核心原语。它们共同构成了多租户环境下资源公平分配与稳定性保障的基础。本章将深入剖析这两个对象的定义、字段语义、工作原理及典型配置，为后续策略即代码模型在集群升级中的测试验证奠定坚实的知识基础。

2.1 ResourceQuota对象详解

ResourceQuota（资源配额）是一个命名空间级别的API对象，用于限制该命名空间内所有Pod、Service、PersistentVolumeClaim等对象可使用的计算资源（CPU、内存）与对象数量的上限。其核心作用是防止单个命名空间（或租户）过度消耗集群资源，确保资源分配的公平性与可预测性。

2.1.1 核心字段与语义

2.1.2 支持的资源类型

ResourceQuota可管控的资源分为三类：计算资源、存储资源和对象数量。以下为常用资源类型清单：

• 计算资源：
  • requests.cpu / limits.cpu
  • requests.memory / limits.memory
  • requests.ephemeral-storage / limits.ephemeral-storage
• 存储资源：
  • requests.storage（所有PVC的总存储请求）
  • persistentvolumeclaims（PVC数量上限）
  • storageclass.storage.k8s.io/requests.storage（按StorageClass细分的存储配额）
• 对象数量：
  • pods、services、configmaps、secrets、replicationcontrollers、resourcequotas等

2.1.3 典型配置示例

apiVersion: v1
kind: ResourceQuota
metadata:
  name: compute-quota
  namespace: team-alpha
spec:
  hard:
    requests.cpu: "4"
    requests.memory: "8Gi"
    limits.cpu: "8"
    limits.memory: "16Gi"
    pods: "10"
    services: "5"
    persistentvolumeclaims: "3"
    requests.storage: "50Gi"

2.2 LimitRange对象详解

LimitRange（限制范围）是另一个命名空间级别的资源管控对象，其作用与ResourceQuota互补。ResourceQuota限制的是总量，而LimitRange限制的是单个Pod或容器的资源上下界，并可为未显式设置资源请求/限制的Pod提供默认值。

2.2.1 核心字段与语义

2.2.2 典型配置示例

apiVersion: v1
kind: LimitRange
metadata:
  name: container-limits
  namespace: team-alpha
spec:
  limits:
  - type: Container
    min:
      cpu: "50m"
      memory: "64Mi"
    max:
      cpu: "2"
      memory: "2Gi"
    default:
      cpu: "500m"
      memory: "512Mi"
    defaultRequest:
      cpu: "200m"
      memory: "256Mi"
    maxLimitRequestRatio:
      cpu: "4"
  - type: PersistentVolumeClaim
    min:
      storage: "1Gi"
    max:
      storage: "100Gi"

2.3 命名空间级别的资源管控机制

ResourceQuota与LimitRange协同工作，形成命名空间级别的资源管控体系。其整体工作流程如下图所示：

2.3.1 管控机制对比

2.3.2 最佳实践与避坑指南

• 先创建LimitRange，再创建ResourceQuota：如果先创建ResourceQuota而未设置LimitRange，可能导致部分Pod因缺少资源请求而被拒绝（因为ResourceQuota要求所有Pod必须设置requests）。
• 合理设置maxLimitRequestRatio：防止用户将requests设置得极低而limits设置得极高，导致调度器低估实际资源需求，造成节点过载。
• 使用scopes精细化配额：通过spec.scopes字段，可以为不同QoS类别的Pod设置不同的配额。例如，对BestEffort Pod设置较低的内存配额，对Guaranteed Pod设置较高的CPU配额。
• 监控配额使用率：定期检查kubectl get resourcequota -n <namespace> -o yaml中的status.used字段，及时发现配额瓶颈。