Container Service for Kubernetes：容器CPU QoS

使用限制

系統組件版本要求如下表所示。

費用說明

ack-koordinator組件本身的安裝和使用是免費的，不過需要注意的是，在以下情境中可能產生額外的費用：

• ack-koordinator是非託管組件，安裝後將佔用Worker節點資源。您可以在安裝組件時配置各模組的資源申請量。

• ack-koordinator預設會將資源畫像、精細化調度等功能的監控指標以Prometheus的格式對外透出。若您配置組件時開啟了ACK-Koordinator開啟Prometheus監控指標選項並使用了阿里雲Prometheus服務，這些指標將被視為自訂指標併產生相應費用。具體費用取決於您的叢集規模和應用數量等因素。建議您在啟用此功能前，仔細閱讀阿里雲Prometheus計費說明，瞭解自訂指標的免費額度和收費策略。您可以通過賬單和用量查詢，監控和管理您的資源使用方式。

操作步驟

1. 使用以下ConfigMap，建立configmap.yaml檔案。

   #ConfigMap ack-slo-config範例。
   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: ack-slo-config
     namespace: kube-system
   data:
     #開啟容器CPU QoS功能。
     resource-qos-config: |
       {
         "clusterStrategy": {
           "lsClass": {
             "cpuQOS": {
               "enable": true,
               "groupIdentity": 2
             }
           },
           "beClass": {
             "cpuQOS": {
               "enable": true,
               "groupIdentity": -1
             }
           }
         }
       }

   lsClass、beClass分別用於配置QoS等級為LS、BE的Pod，cpuQOS用於配置容器CPU QoS功能。關鍵參數說明如下：

   參數	類型	取值範圍	說明
   enable	Boolean	true false	true：叢集全域開啟容器CPU QoS功能。 false：叢集全域關閉容器CPU QoS功能。
   groupIdentity	Int	-1~2	表示CPU Group Identity的優先順序。預設值依據QoS，LS對應2，BE對應-1。0表示關閉。 groupIdentity值越大，表示容器在核心調度的優先順序越高。例如，按預設配置，QoS等級為LS的容器Group Identity介面配置為cpu.bvt_warp_ns=2，BE容器配置為cpu.bvt_warp_ns=-1。更多資訊，請參見Group Identity功能說明。

   說明

   對於未指定koordinator.sh/qosClass的Pod，ack-koordinator將參考Pod原生的QoSClass來設定參數，其中Besteffort使用ConfigMap中BE的配置，其他QoSClass使用ConfigMap中LS的配置。

2. 查看命名空間kube-system下是否存在ConfigMap ack-slo-config。

   • 若存在ConfigMap ack-slo-config，請使用PATCH方式進行更新，避免幹擾ConfigMap中其他配置項。

     kubectl patch cm -n kube-system ack-slo-config --patch "$(cat configmap.yaml)"

   • 若不存在ConfigMap ack-slo-config，請執行以下命令進行建立Configmap。

     kubectl apply -f configmap.yaml

3. 使用以下YAML內容，建立ls-pod-demo.yaml檔案。

   apiVersion: v1
   kind: Pod
   metadata:
     name: ls-pod-demo
     labels:
       koordinator.sh/qosClass: 'LS' #指定Pod的QoS層級為LS。
   spec:
     containers:
     - command:
       - httpd
       - -D
       - FOREGROUND
       image: registry.cn-zhangjiakou.aliyuncs.com/acs/apache-2-4-51-for-slo-test:v0.1
       imagePullPolicy: Always
       name: apache
       resources:
         limits:
           cpu: "4"
           memory: 10Gi
         requests:
           cpu: "4"
           memory: 10Gi
     restartPolicy: Never
     schedulerName: default-scheduler

4. 執行以下命令，將ls-pod-demo部署到叢集。

   kubectl apply -f ls-pod-demo.yaml

5. 執行以下命令，在單機端的Cgroup分組中查看LS Pod的核心Group Identity生效情況。

   cat /sys/fs/cgroup/cpu/kubepods.slice/kubepods-pod1c20f2ad****.slice/cpu.bvt_warp_ns

   預期輸出：

   #LS Pod的Group Identity優先順序為2（高優）。
   2

6. 使用以下YAML內容，建立be-pod-demo.yaml檔案。

   apiVersion: v1
   kind: Pod
   metadata:
     name: be-pod-demo
     labels:
       koordinator.sh/qosClass: 'BE' #指定Pod的QoS層級為BE。
   spec:
     containers:
       - args:
           - '-c'
           - '1'
           - '--vm'
           - '1'
         command:
           - stress
         image: polinux/stress
         imagePullPolicy: Always
         name: stress
     restartPolicy: Always
     schedulerName: default-scheduler

7. 執行以下命令，將be-pod-demo部署到叢集。

   kubectl apply -f be-pod-demo.yaml

8. 執行以下命令，在單機端的Cgroup分組中查看BE Pod的核心Group Identity生效情況。

   cat /sys/fs/cgroup/cpu/kubepods.slice/kubepods-besteffort.slice/kubepods-besteffort-pod4b6e96c8****.slice/cpu.bvt_warp_ns

   預期輸出：

   #BE Pod的Group Identity優先順序為-1（低優）。
   -1

   由預期輸出得到，LS容器為Group Identity高優先順序，BE容器為Group Identity低優先順序，表示LS容器的CPU服務品質將被優先保障。

FAQ

當前已經通過ack-slo-manager的舊版本協議使用了CPU QoS功能，升級為ack-koordinator後是否繼續支援CPU QoS功能？

舊版本（≤0.8.0）的Pod協議：在Pod的Annotation中填寫alibabacloud.com/qosClass。

ack-koordinator保持了對以上舊版本協議的相容，您可以將組件無縫升級至ack-koordinator。ack-koordinator將對以上舊版本協議相容至2023年7月30日，我們建議您將原協議資源欄位及時升級到新版本。