为命名空间配置内存和 CPU 配额

为命名空间定义总体的内存和 CPU 资源限制。

本页展示了如何为 命名空间（Namespace） 中运行的所有 Pod 所能使用的内存和 CPU 总量设置配额。你可以在 ResourceQuota 对象中指定配额。

开始之前

你需要有一个 Kubernetes 集群，并且必须配置 kubectl 命令行工具以与你的集群通信。建议在至少有两个节点的集群上运行本教程，且这些节点不能作为控制平面主机。如果你还没有集群，可以通过 minikube 创建一个，或者使用以下 Kubernetes 演练场之一。

您必须有权在集群中创建命名空间。

集群中的每个节点必须至少有 1 GiB 的内存。

创建命名空间

创建一个命名空间，以便您在此练习中创建的资源与集群的其余部分隔离。

kubectl create namespace quota-mem-cpu-example

创建 ResourceQuota

以下是示例 ResourceQuota 的清单

admin/resource/quota-mem-cpu.yaml 
apiVersion: v1
kind: ResourceQuota
metadata:
  name: mem-cpu-demo
spec:
  hard:
    requests.cpu: "1"
    requests.memory: 1Gi
    limits.cpu: "2"
    limits.memory: 2Gi

创建 ResourceQuota

kubectl apply -f https://k8s.io/examples/admin/resource/quota-mem-cpu.yaml --namespace=quota-mem-cpu-example

查看 ResourceQuota 的详细信息

kubectl get resourcequota mem-cpu-demo --namespace=quota-mem-cpu-example --output=yaml

ResourceQuota 对 quota-mem-cpu-example 命名空间设置了以下要求

  • 对于命名空间中的每个 Pod，其每个容器都必须有内存请求、内存限制、CPU 请求和 CPU 限制。
  • 该命名空间中所有 Pod 的内存请求总和不得超过 1 GiB。
  • 该命名空间中所有 Pod 的内存限制总和不得超过 2 GiB。
  • 该命名空间中所有 Pod 的 CPU 请求总和不得超过 1 个 CPU。
  • 该命名空间中所有 Pod 的 CPU 限制总和不得超过 2 个 CPU。

请参阅 CPU 的含义 以了解 Kubernetes 中“1 CPU”的定义。

创建 Pod

以下是示例 Pod 的清单

admin/resource/quota-mem-cpu-pod.yaml 
apiVersion: v1
kind: Pod
metadata:
  name: quota-mem-cpu-demo
spec:
  containers:
  - name: quota-mem-cpu-demo-ctr
    image: nginx
    resources:
      limits:
        memory: "800Mi"
        cpu: "800m"
      requests:
        memory: "600Mi"
        cpu: "400m"

创建 Pod

kubectl apply -f https://k8s.io/examples/admin/resource/quota-mem-cpu-pod.yaml --namespace=quota-mem-cpu-example

验证 Pod 是否正在运行且其（唯一的）容器是否健康

kubectl get pod quota-mem-cpu-demo --namespace=quota-mem-cpu-example

再次查看有关 ResourceQuota 的详细信息

kubectl get resourcequota mem-cpu-demo --namespace=quota-mem-cpu-example --output=yaml

输出显示了配额以及已使用多少配额。你可以看到 Pod 的内存和 CPU 请求与限制没有超过配额。

status:
  hard:
    limits.cpu: "2"
    limits.memory: 2Gi
    requests.cpu: "1"
    requests.memory: 1Gi
  used:
    limits.cpu: 800m
    limits.memory: 800Mi
    requests.cpu: 400m
    requests.memory: 600Mi

如果你有 jq 工具，也可以仅查询（使用 JSONPath）used 值，**并**对输出结果进行美化打印。例如

kubectl get resourcequota mem-cpu-demo --namespace=quota-mem-cpu-example -o jsonpath='{ .status.used }' | jq .

尝试创建第二个 Pod

以下是第二个 Pod 的清单

admin/resource/quota-mem-cpu-pod-2.yaml 
apiVersion: v1
kind: Pod
metadata:
  name: quota-mem-cpu-demo-2
spec:
  containers:
  - name: quota-mem-cpu-demo-2-ctr
    image: redis
    resources:
      limits:
        memory: "1Gi"
        cpu: "800m"
      requests:
        memory: "700Mi"
        cpu: "400m"

在清单中，你可以看到该 Pod 的内存请求为 700 MiB。注意，已使用的内存请求与本次新内存请求之和超过了内存请求配额：600 MiB + 700 MiB > 1 GiB。

尝试创建 Pod

kubectl apply -f https://k8s.io/examples/admin/resource/quota-mem-cpu-pod-2.yaml --namespace=quota-mem-cpu-example

第二个 Pod 没有被创建。输出显示，创建第二个 Pod 会导致内存请求总额超过内存请求配额。

Error from server (Forbidden): error when creating "examples/admin/resource/quota-mem-cpu-pod-2.yaml":
pods "quota-mem-cpu-demo-2" is forbidden: exceeded quota: mem-cpu-demo,
requested: requests.memory=700Mi,used: requests.memory=600Mi, limited: requests.memory=1Gi

讨论

正如你在本练习中所见，可以使用 ResourceQuota 限制在命名空间中运行的所有 Pod 的内存请求总额。你还可以限制内存限制、CPU 请求和 CPU 限制的总额。

如果你不想管理命名空间内的总资源使用量，而是希望限制单个 Pod 或这些 Pod 中的容器，则可以使用 LimitRange 来实现此类限制。

说明

当使用 原地 Pod 扩缩容（In-place Pod resize） 时，ResourceQuota 强制执行将应用于调整后的值。如果调整资源会导致命名空间超过其配额限制，则调整会被拒绝，且 Pod 的资源保持不变。

清理

删除您的命名空间

kubectl delete namespace quota-mem-cpu-example

接下来

针对集群管理员

针对应用开发者


最后修改于 2026 年 1 月 9 日太平洋标准时间下午 7:49：向概念和任务页面添加 Pod 调整大小文档 (cf1ef9e145)