第8章 クォータ

手順

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. ブートストラッププロジェクトテンプレートを作成し、これを template.yaml というファイルに出力します。

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

     2. リソースクォータの定義を template.yaml に追加します。以下の例では、'storage-consumption' という名前のリソースクォータを定義します。テンプレートの parameters: セクションの前に定義を追加する必要があります。

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

        各項目の説明:

        spec.hard.persistentvolumeclaims

        プロジェクト内の永続ボリューム要求の合計数です。

        spec.hard.requests.storage

        プロジェクトのすべての永続ボリューム要求において、要求されるストレージの合計はこの値を超えることができません。

        spec.hard.gold.storageclass.storage.k8s.io/requests.storage

        プロジェクトのすべての永続ボリューム要求において、gold ストレージクラスで要求されるストレージの合計はこの値を超えることができません。

        spec.hard.silver.storageclass.storage.k8s.io/requests.storage

        プロジェクトのすべての永続ボリューム要求において、silver ストレージクラスで要求されるストレージの合計はこの値を超えることができません。

        spec.hard.silver.storageclass.storage.k8s.io/persistentvolumeclaims

        プロジェクトのすべての永続ボリューム要求において、silver ストレージクラスの要求の合計数はこの値を超えることができません。

        spec.hard.bronze.storageclass.storage.k8s.io/requests.storage

        プロジェクトのすべての永続ボリューム要求において、bronze ストレージクラスで要求されるストレージの合計はこの値を超えることができません。この値が 0 に設定される場合、bronze ストレージクラスはストレージを要求できません。

        spec.hard.bronze.storageclass.storage.k8s.io/persistentvolumeclaims

        プロジェクトのすべての永続ボリューム要求において、bronze ストレージクラスで要求されるストレージの合計はこの値を超えることができません。この値が 0 に設定される場合、bronze ストレージクラスは要求を作成できません。

     3. openshift-config namespace の変更された 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 namespace のテンプレートをリスト表示します。

        $ oc get templates -n openshift-config

     2. 既存のプロジェクト要求テンプレートを編集します。

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

     3. 前述の storage-consumption の例などのリソースクォータ定義を既存のテンプレートに追加します。テンプレートの parameters: セクションの前に定義を追加する必要があります。

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>