diff --git a/content/zh/docs/tasks/administer-cluster/quota-api-object.md b/content/zh/docs/tasks/administer-cluster/quota-api-object.md new file mode 100644 index 0000000000..67249bd075 --- /dev/null +++ b/content/zh/docs/tasks/administer-cluster/quota-api-object.md @@ -0,0 +1,274 @@ +--- +title: 配置 API 对象配额 +content_template: templates/task +--- + + + +{{% capture overview %}} + + + +本文讨论如何为 API 对象配置配额,包括 PersistentVolumeClaims 和 Services。 +配额限制了可以在命名空间中创建的特定类型对象的数量。 +您可以在 [ResourceQuota](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#resourcequota-v1-core) 对象中指定配额。 + +{{% /capture %}} + + +{{% capture prerequisites %}} + +{{< include "task-tutorial-prereqs.md" >}} {{< version-check >}} + +{{% /capture %}} + + +{{% capture steps %}} + + + +## 创建命名空间 + +创建一个命名空间以便本例中创建的资源和集群中的其余部分相隔离。 + +```shell +kubectl create namespace quota-object-example +``` + + + +## 创建 ResourceQuota + +下面是一个 ResourceQuota 对象的配置文件: + +{{< codenew file="admin/resource/quota-objects.yaml" >}} + + + +创建 ResourceQuota + +```shell +kubectl create -f https://k8s.io/examples/admin/resource/quota-objects.yaml --namespace=quota-object-example +``` + + + +查看 ResourceQuota 的详细信息: + +```shell +kubectl get resourcequota object-quota-demo --namespace=quota-object-example --output=yaml +``` + + + +输出结果表明在 quota-object-example 命名空间中,至多只能有一个 PersistentVolumeClaim,最多两个 LoadBalancer 类型的服务,不能有 NodePort 类型的服务。 + + +```yaml +status: + hard: + persistentvolumeclaims: "1" + services.loadbalancers: "2" + services.nodeports: "0" + used: + persistentvolumeclaims: "0" + services.loadbalancers: "0" + services.nodeports: "0" +``` + + + +## 创建 PersistentVolumeClaim + +下面是一个 PersistentVolumeClaim 对象的配置文件: + +{{< codenew file="admin/resource/quota-objects-pvc.yaml" >}} + + + +创建 PersistentVolumeClaim: + +```shell +kubectl create -f https://k8s.io/examples/admin/resource/quota-objects-pvc.yaml --namespace=quota-object-example +``` + + + +确认已创建完 PersistentVolumeClaim: + +```shell +kubectl get persistentvolumeclaims --namespace=quota-object-example +``` + + + +输出信息表明 PersistentVolumeClaim 存在并且处于 Pending 状态: + +```shell +NAME STATUS +pvc-quota-demo Pending +``` + + + +## 尝试创建第二个 PersistentVolumeClaim + +下面是第二个 PersistentVolumeClaim 的配置文件: + +{{< codenew file="admin/resource/quota-objects-pvc-2.yaml" >}} + + + +尝试创建第二个 PersistentVolumeClaim: + +```shell +kubectl create -f https://k8s.io/examples/admin/resource/quota-objects-pvc-2.yaml --namespace=quota-object-example +``` + + +输出信息表明第二个 PersistentVolumeClaim 没有创建成功,因为这会超出命名空间的配额。 + + +``` +persistentvolumeclaims "pvc-quota-demo-2" is forbidden: +exceeded quota: object-quota-demo, requested: persistentvolumeclaims=1, +used: persistentvolumeclaims=1, limited: persistentvolumeclaims=1 +``` + + +## 注意事项 + +下面这些字符串可被用来标识那些能被配额限制的 API 资源: + +
| String | API Object |
|---|---|
| "pods" | Pod |
| "services | Service |
| "replicationcontrollers" | ReplicationController |
| "resourcequotas" | ResourceQuota |
| "secrets" | Secret |
| "configmaps" | ConfigMap |
| "persistentvolumeclaims" | PersistentVolumeClaim |
| "services.nodeports" | Service of type NodePort |
| "services.loadbalancers" | Service of type LoadBalancer |