第 9 章 配额

流程

1. 在一个文件中定义配额。

2. 使用该文件创建配额，并将其应用到项目：

   $ oc create -f <file> [-n <project_name>]

   例如：

   $ oc create -f core-object-counts.yaml -n demoproject

流程

1. 获取项目中定义的配额列表。例如，对于名为 demoproject 的项目：

   $ oc get quota -n demoproject

   输出示例

   NAME                           AGE    REQUEST                                                                                                      LIMIT
   besteffort                     4s     pods: 1/2
   compute-resources-time-bound   10m    pods: 0/2                                                                                                    limits.cpu: 0/1, limits.memory: 0/1Gi
   core-object-counts             109s   configmaps: 2/10, persistentvolumeclaims: 1/4, replicationcontrollers: 1/20, secrets: 9/10, services: 2/10

2. 描述您关注的配额，如 core-object-counts 配额：

   $ oc describe quota core-object-counts -n demoproject

   输出示例

   Name:			core-object-counts
   Namespace:		demoproject
   Resource		Used	Hard
   --------		----	----
   configmaps		3	10
   persistentvolumeclaims	0	4
   replicationcontrollers	3	20
   secrets			9	10
   services		2	10

流程

1. 在项目请求模板中添加资源配额定义：

   • 如果集群中不存在项目请求模板：

     1. 创建 bootstrap 项目模板并将其输出到名为 template.yaml 的文件：

        $ oc adm create-bootstrap-project-template -o yaml > template.yaml

     2. 在 template.yaml 中添加资源配额定义。以下示例定义了名为 'storage-consumption' 的资源配额。定义必须在模板的 parameter: 部分前添加：

        - apiVersion: v1
          kind: ResourceQuota
          metadata:
            name: storage-consumption
            namespace: ${PROJECT_NAME}
          spec:
            hard:
              persistentvolumeclaims: "10" 1
              requests.storage: "50Gi" 2
              gold.storageclass.storage.k8s.io/requests.storage: "10Gi" 3
              silver.storageclass.storage.k8s.io/requests.storage: "20Gi" 4
              silver.storageclass.storage.k8s.io/persistentvolumeclaims: "5" 5
              bronze.storageclass.storage.k8s.io/requests.storage: "0" 6
              bronze.storageclass.storage.k8s.io/persistentvolumeclaims: "0" 7

        1

        项目中的持久性卷声明总数。

        2

        在一个项目中的所有持久性卷声明中，请求的存储总和不能超过这个值。

        3

        在一个项目中的所有持久性卷声明中，金级存储类中请求的存储总和不能超过这个值。

        4

        在一个项目中的所有持久性卷声明中，银级存储类中请求的存储总和不能超过这个值。

        5

        在一个项目中的所有持久性卷声明中，银级存储类中声明总数不能超过这个值。

        6

        在一个项目中的所有持久性卷声明中，铜级存储类中请求的存储总和不能超过这个值。如果此值设为 0，则 bronze 存储类无法请求存储。

        7

        在一个项目中的所有持久性卷声明中，铜级存储类中请求的存储总和不能超过这个值。如果此值设为 0，则 bronze 存储类无法创建声明。

     3. 通过 openshift-config 命名空间中修改的 template.yaml 文件创建项目请求模板：

        $ oc create -f template.yaml -n openshift-config

        注意

        要将配置作为 kubectl.kubernetes.io/last-applied-configuration注解包括，将 --save-config 选项添加到 oc create 命令中。

        默认情况下，模板称为 project-request。

   • 如果项目请求模板已在集群中存在：

     注意

     如果您使用配置文件以声明性或必要方式管理集群中的对象，请使用这些文件编辑现有项目请求模板。

     1. 列出 openshift-config 命名空间中的模板：

        $ oc get templates -n openshift-config

     2. 编辑现有项目请求模板：

        $ oc edit template <project_request_template> -n openshift-config

     3. 将资源配额定义（如前面的 storage-consumption 示例）添加到现有模板中。定义必须在模板的 parameter: 部分前添加。

2. 如果您创建了项目请求模板，在集群的项目配置资源中引用它：

   1. 访问项目配置资源进行编辑：

      • 使用 web 控制台：

        1. 导航至 Administration Cluster Settings 页面。
        2. 单击 Configuration 以查看所有配置资源。
        3. 找到 Project 的条目，并点击 Edit YAML。

      • 使用 CLI：

        1. 编辑 project.config.openshift.io/cluster 资源：

           $ oc edit project.config.openshift.io/cluster

   2. 更新项目配置资源的 spec 部分，使其包含 projectRequestTemplate 和 name 参数。以下示例引用了默认项目请求模板（名称为 project-request）:

      apiVersion: config.openshift.io/v1
      kind: Project
      metadata:
      #  ...
      spec:
        projectRequestTemplate:
          name: project-request

3. 验证在创建项目时是否应用了资源配额：

   1. 创建一个项目：

      $ oc new-project <project_name>

   2. 列出项目的资源配额：

      $ oc get resourcequotas

   3. 详细描述资源配额：

      $ oc describe resourcequotas <resource_quota_name>