3. Kubernetes 资源配额基础：ResourceQuota 对象的概念、作用域与常用资源类型

在 Backstage 插件冷启动削峰场景中，Kubernetes 的 ResourceQuota 是防止单个命名空间（Namespace）资源滥用、保障集群稳定性的第一道防线。本节将深入解析 ResourceQuota 的核心概念、作用域机制以及 CPU、内存、存储等常用资源类型的配置方法。

3.1 ResourceQuota 对象的概念

ResourceQuota 是 Kubernetes 内置的准入控制机制，用于限制一个 Namespace 内所有 Pod 和容器的资源使用总量。当集群中运行多个团队或项目的 Backstage 插件实例时，ResourceQuota 可以确保每个 Namespace 的资源消耗不超过预设上限，避免某个插件的突发资源需求“挤占”其他插件的正常运行。

3.2 作用域：Namespace 级别

ResourceQuota 的作用域严格限定在 单个 Namespace 内。这意味着：

• 每个 Namespace 可以独立配置一个或多个 ResourceQuota 对象。
• 配额只对当前 Namespace 内的资源创建和更新生效，不影响其他 Namespace。
• 跨 Namespace 的资源消耗（如集群级别的 PersistentVolume）不受 ResourceQuota 直接限制。

下图展示了 ResourceQuota 在 Namespace 级别的作用范围：

3.3 常用资源类型

ResourceQuota 支持对三类核心资源进行配额限制：计算资源（CPU、内存）、存储资源（PVC 容量）和 对象数量（Pod、Service 等）。在 Backstage 插件冷启动场景中，最常配置的是前三类。

3.4 ResourceQuota 配置示例

以下是一个针对 Backstage 插件 Namespace 的 ResourceQuota 配置示例，限制了 CPU、内存和存储的总量：

apiVersion: v1
kind: ResourceQuota
metadata:
  name: backstage-plugin-quota
  namespace: backstage-plugins
spec:
  hard:
    requests.cpu: "8"
    requests.memory: "16Gi"
    limits.cpu: "12"
    limits.memory: "32Gi"
    requests.storage: "50Gi"
    persistentvolumeclaims: "10"
    pods: "20"

3.5 配额生效与监控

ResourceQuota 一旦创建，立即生效。可以通过以下命令查看当前配额使用情况：

# 查看配额定义
kubectl get resourcequota -n backstage-plugins

# 查看配额使用详情
kubectl describe resourcequota backstage-plugin-quota -n backstage-plugins

输出示例：

Name:            backstage-plugin-quota
Namespace:       backstage-plugins
Resource         Used  Hard
--------         ---   ---
limits.cpu       6     12
limits.memory    20Gi  32Gi
pods             8     20
requests.cpu     4     8
requests.memory  10Gi  16Gi
requests.storage 30Gi  50Gi

3.6 配额与冷启动削峰的关联

在 Backstage 插件冷启动削峰方案中，ResourceQuota 扮演以下角色：

• 资源隔离：为每个插件 Namespace 设置独立配额，防止单个插件的预热行为影响其他插件。
• 削峰上限：通过配额限制，控制插件预热期间的最大资源消耗，避免集群过载。
• 容量规划：基于配额使用数据，可以精确计算每个插件所需的资源量，为镜像预热和 HPA 配置提供依据。

下图展示了 ResourceQuota 在冷启动削峰流程中的位置：

3.7 常见问题与避坑指南