2、资源配额（ResourceQuota）基础：概念、作用域与资源类型

ResourceQuota 是 Kubernetes 集群管理员用来限制命名空间（Namespace）级别资源消耗的核心策略对象。它通过声明式配置，为每个命名空间设定资源上限，防止单个租户或应用团队过度占用集群资源，保障多租户环境下的资源公平性与集群稳定性。

2.1 ResourceQuota 核心概念

ResourceQuota 本质上是一个准入控制机制。当用户尝试在命名空间中创建或更新 Pod、Service、PersistentVolumeClaim 等对象时，Kubernetes API Server 会调用配额插件，检查当前命名空间已消耗的资源量加上新请求的资源量是否超过配额上限。如果超出，请求将被拒绝并返回错误信息。

2.2 作用域（Scope）

ResourceQuota 支持通过作用域（Scope）对配额的应用范围进行精细化控制。作用域决定了配额规则适用于哪些类型的 Pod 或对象。Kubernetes 定义了以下标准作用域：

2.3 资源类型详解

ResourceQuota 支持对四类资源进行配额限制：计算资源（CPU/内存）、存储资源、对象数量以及扩展资源。每种资源类型都有对应的配额键（Key）和计数方式。

2.3.1 计算资源（CPU / 内存）

计算资源配额通过 requests 和 limits 两个维度进行控制。Kubernetes 会分别累加命名空间内所有 Pod 容器的 requests 和 limits 值。

2.3.2 存储资源

存储资源配额包括持久卷声明（PVC）的存储请求总量以及特定存储类的存储上限。

2.3.3 对象数量

对象数量配额限制命名空间内可创建的 Kubernetes 资源对象个数。这有助于防止资源对象泛滥导致 etcd 压力过大或控制器性能下降。

2.3.4 扩展资源

扩展资源（Extended Resources）是用户自定义的非 Kubernetes 原生资源，例如 GPU、FPGA、NVMe 磁盘等。ResourceQuota 同样支持对扩展资源进行配额限制。

apiVersion: v1
kind: ResourceQuota
metadata:
  name: gpu-quota
  namespace: ai-team
spec:
  hard:
    requests.nvidia.com/gpu: 8
    limits.nvidia.com/gpu: 16
    pods: 50
    requests.memory: 100Gi
    limits.memory: 200Gi

2.4 完整 ResourceQuota 示例

以下是一个生产环境推荐的 ResourceQuota 配置，同时覆盖计算资源、存储资源和对象数量：

apiVersion: v1
kind: ResourceQuota
metadata:
  name: production-quota
  namespace: production
spec:
  hard:
    # 计算资源
    requests.cpu: 20
    requests.memory: 80Gi
    limits.cpu: 40
    limits.memory: 160Gi
    # 存储资源
    requests.storage: 500Gi
    persistentvolumeclaims: 30
    requests.storage/fast-ssd: 200Gi
    persistentvolumeclaims/fast-ssd: 10
    # 对象数量
    pods: 100
    services: 20
    configmaps: 100
    secrets: 100
    # 扩展资源
    requests.nvidia.com/gpu: 4

2.5 配额与 LimitRange 的协同关系

ResourceQuota 和 LimitRange 是 Kubernetes 资源治理的两大支柱，但职责不同：

2.6 配额监控与调试

管理员可以通过以下命令查看命名空间的当前配额使用情况：

# 查看命名空间的配额定义
kubectl get resourcequota -n production

# 查看配额使用详情（Used 列显示当前消耗）
kubectl describe resourcequota production-quota -n production

# 输出示例：
# Name:            production-quota
# Namespace:       production
# Resource         Used  Hard
# --------         ---   ---
# requests.cpu     12    20
# requests.memory  48Gi  80Gi
# limits.cpu       24    40
# limits.memory    96Gi  160Gi
# pods             45    100
# persistentvolumeclaims  12  30