使用限制

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

費用說明

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日，我們建議您將原協議資源字段及時升級到新版本。