18장. 성능 프로필을 사용하여 낮은 대기 시간을 위한 호스팅 제어 평면 조정

프로세스

1. 다음 명령을 실행하여 관리 클러스터 kubeconfig 파일을 내보냅니다.

   $ export MGMT_KUBECONFIG=<path_to_mgmt_kubeconfig>

2. 다음 명령을 실행하여 모든 네임스페이스의 모든 노드 풀을 나열합니다.

   $ oc --kubeconfig="$MGMT_KUBECONFIG" get np -A

   출력 예

   NAMESPACE   NAME                     CLUSTER       DESIRED NODES   CURRENT NODES   AUTOSCALING   AUTOREPAIR   VERSION   UPDATINGVERSION   UPDATINGCONFIG   MESSAGE
   clusters    democluster-us-east-1a   democluster   1               1               False         False        4.17.0    False             True

   • 출력에서는 NodePool 리소스가 정의된 관리 클러스터의 네임스페이스 클러스터가 표시됩니다.
   • NodePool 리소스의 이름(예: demcluster-us-east-1a) 입니다.
   • 이 NodePool 이 속한 HostedCluster 입니다. 예를 들어, democluster .

3. 관리 클러스터에서 다음 명령을 실행하여 사용 가능한 비밀을 나열합니다.

   $ oc get secrets -n clusters

   출력 예

   NAME                              TYPE                      DATA   AGE
   builder-dockercfg-25qpp           kubernetes.io/dockercfg   1      128m
   default-dockercfg-mkvlz           kubernetes.io/dockercfg   1      128m
   democluster-admin-kubeconfig      Opaque                    1      127m
   democluster-etcd-encryption-key   Opaque                    1      128m
   democluster-kubeadmin-password    Opaque                    1      126m
   democluster-pull-secret           Opaque                    1      128m
   deployer-dockercfg-8lfpd          kubernetes.io/dockercfg   1      128m

4. 다음 명령을 실행하여 호스팅된 클러스터의 kubeconfig 파일을 추출합니다.

   $ oc get secret <secret_name> -n <cluster_namespace> -o jsonpath='{.data.kubeconfig}' | base64 -d > hosted-cluster-kubeconfig

   예

   $ oc get secret democluster-admin-kubeconfig -n clusters -o jsonpath='{.data.kubeconfig}' | base64 -d > hosted-cluster-kubeconfig

5. 호스팅된 클러스터에 대한 필수 수집 번들을 생성하려면 별도의 터미널 창을 열고 다음 명령을 실행하세요.

   1. 호스팅된 클러스터 kubeconfig 파일을 내보냅니다.

      $ export HC_KUBECONFIG=<path_to_hosted_cluster_kubeconfig>

      예

      $ export HC_KUBECONFIG=~/hostedcpkube/hosted-cluster-kubeconfig

   2. must-gather 데이터를 저장하려는 디렉터리로 이동합니다.

   3. 호스팅된 클러스터에 대한 문제 해결 데이터를 수집하세요.

      $ oc --kubeconfig="$HC_KUBECONFIG" adm must-gather

   4. 작업 디렉토리에서 생성된 must-gather 디렉토리에서 압축 파일을 만듭니다. 예를 들어 Linux 운영 체제를 사용하는 컴퓨터에서 다음 명령을 실행합니다.

      $ tar -czvf must-gather.tar.gz must-gather.local.1203869488012141147

프로세스

1. 호스팅된 클러스터에서 다음 명령을 실행하여 Podman을 사용하여 registry.redhat.io 에 인증합니다.

   $ podman login registry.redhat.io

   Username: <user_name>
   Password: <password>

2. 다음 명령을 실행하여 호스팅된 클러스터에서 성능 프로필을 만듭니다. 이 예제에서는 샘플 PPC 인수와 값을 사용합니다.

   $ podman run --entrypoint performance-profile-creator \
       -v /path/to/must-gather:/must-gather:z \

   1

   
       registry.redhat.io/openshift4/ose-cluster-node-tuning-rhel9-operator:v4.19 \
       --must-gather-dir-path /must-gather \
       --reserved-cpu-count=2 \

   2

   
       --rt-kernel=false \

   3

   
       --split-reserved-cpus-across-numa=false \ 

   4

   
       --topology-manager-policy=single-numa-node \

   5

   
       --node-pool-name=democluster-us-east-1a \
       --power-consumption-mode=ultra-low-latency \

   6

   
       --offlined-cpu-count=1 \

   7

   
       > my-hosted-cp-performance-profile.yaml

   1

   oc adm must-gather 의 출력이 생성된 로컬 디렉토리를 컨테이너에 마운트합니다.

   2

   두 개의 예약된 CPU를 지정합니다.

   3

   실시간 커널을 비활성화합니다.

   4

   NUMA 노드에 걸쳐 예약된 CPU 분할을 비활성화합니다.

   5

   NUMA 토폴로지 정책을 지정합니다. NUMA Resources Operator를 설치하는 경우 이를 single-numa-node 로 설정해야 합니다.

   6

   전력 소비가 증가하는 대신 대기 시간을 최소화합니다.

   7

   오프라인 CPU 하나를 지정합니다.

   출력 예

   level=info msg="Nodes names targeted by democluster-us-east-1a pool are: ip-10-0-129-110.ec2.internal "
   level=info msg="NUMA cell(s): 1"
   level=info msg="NUMA cell 0 : [0 2 1 3]"
   level=info msg="CPU(s): 4"
   level=info msg="2 reserved CPUs allocated: 0,2 "
   level=info msg="1 isolated CPUs allocated: 1"
   level=info msg="Additional Kernel Args based on configuration: []

3. 다음 명령을 실행하여 생성된 YAML 파일을 검토하세요.

   $ cat my-hosted-cp-performance-profile

   출력 예

   ---
   apiVersion: v1
   data:
     tuning: |
       apiVersion: performance.openshift.io/v2
       kind: PerformanceProfile
       metadata:
         creationTimestamp: null
         name: performance
       spec:
         cpu:
           isolated: "1"
           offlined: "3"
           reserved: 0,2
         net:
           userLevelNetworking: false
         nodeSelector:
           node-role.kubernetes.io/worker: ""
         numa:
           topologyPolicy: single-numa-node
         realTimeKernel:
           enabled: false
         workloadHints:
           highPowerConsumption: true
           perPodPowerManagement: false
           realTime: true
       status: {}
   kind: ConfigMap
   metadata:
     name: performance
     namespace: clusters

프로세스

1. 다음 명령을 실행하여 관리 클러스터 kubeconfig 파일을 내보냅니다.

   $ export MGMT_KUBECONFIG=<path_to_mgmt_kubeconfig>

2. 다음 명령을 실행하여 관리 클러스터에 ConfigMap 객체를 만듭니다.

   $ oc --kubeconfig="$MGMT_KUBECONFIG" apply -f my-hosted-cp-performance-profile.yaml

3. 다음 명령을 실행하여 클러스터 네임스페이스의 NodePool 객체를 편집하여 spec.tuningConfig 필드와 해당 필드에 생성된 성능 프로필의 이름을 추가합니다.

   $ oc edit np -n clusters

   apiVersion: hypershift.openshift.io/v1beta1
   kind: NodePool
   metadata:
     annotations:
       hypershift.openshift.io/nodePoolCurrentConfig: 2f752a2c
       hypershift.openshift.io/nodePoolCurrentConfigVersion: 998aa3ce
       hypershift.openshift.io/nodePoolPlatformMachineTemplate: democluster-us-east-1a-3dff55ec
     creationTimestamp: "2025-04-09T09:41:55Z"
     finalizers:
     - hypershift.openshift.io/finalizer
     generation: 1
     labels:
       hypershift.openshift.io/auto-created-for-infra: democluster
     name: democluster-us-east-1a
     namespace: clusters
     ownerReferences:
     - apiVersion: hypershift.openshift.io/v1beta1
       kind: HostedCluster
       name: democluster
       uid: af77e390-c289-433c-9d29-3aee8e5dc76f
     resourceVersion: "53056"
     uid: 11efa47c-5a7b-476c-85cf-a274f748a868
   spec:
     tuningConfig:
     - name: performance
     arch: amd64
     clusterName: democluster
     management:

   참고

   여러 노드 풀에서 동일한 프로필을 참조할 수 있습니다. 호스팅된 컨트롤 플레인에서 Node Tuning Operator는 노드 풀 이름과 네임스페이스의 해시를 Tuned CR 이름에 추가하여 구별합니다. 변경 사항을 적용한 후 시스템은 구성 변경이 필요하다는 것을 감지하고 해당 풀의 노드에 대한 롤링 업데이트를 시작하여 새 구성을 적용합니다.

검증

1. 다음 명령을 실행하여 모든 네임스페이스의 모든 노드 풀을 나열합니다.

   $ oc --kubeconfig="$MGMT_KUBECONFIG" get np -A

   출력 예

   NAMESPACE   NAME                     CLUSTER       DESIRED NODES   CURRENT NODES   AUTOSCALING   AUTOREPAIR   VERSION   UPDATINGVERSION   UPDATINGCONFIG   MESSAGE
   clusters    democluster-us-east-1a   democluster   1               1               False         False        4.17.0    False             True

   참고

   UPDATINGCONFIG 필드는 노드 풀이 구성을 업데이트하는 중인지 여부를 나타냅니다. 이 업데이트 중에 노드 풀 상태의 UPDATINGCONFIG 필드가 True가 됩니다. 새로운 구성은 UPDATINGCONFIG 필드가 False 로 반환될 때만 완전히 적용된 것으로 간주됩니다.

2. 다음 명령을 실행하여 clusters-democluster 네임스페이스의 모든 구성 맵을 나열합니다.

   $ oc --kubeconfig="$MGMT_KUBECONFIG" get cm -n clusters-democluster

   출력 예

   NAME                                                 DATA   AGE
   aggregator-client-ca                                 1      69m
   auth-config                                          1      68m
   aws-cloud-config                                     1      68m
   aws-ebs-csi-driver-trusted-ca-bundle                 1      66m
   ...                                                  1      67m
   kubelet-client-ca                                    1      69m
   kubeletconfig-performance-democluster-us-east-1a     1      22m
   ...
   ovnkube-identity-cm                                  2      66m
   performance-democluster-us-east-1a                   1      22m
   ...
   tuned-performance-democluster-us-east-1a             1      22m

   출력에서는 kubeletconfig kubeletconfig-performance-democluster-us-east-1a 와 성능 프로필 performance-democluster-us-east-1a가 생성되었음을 보여줍니다. 노드 튜닝 운영자는 튜닝된 객체를 호스팅된 클러스터에 동기화합니다. 정의된 Tuned 오브젝트와 각 노드에 적용되는 TuneD 프로필을 확인할 수 있습니다.

3. 다음 명령을 실행하여 관리 클러스터에서 사용 가능한 비밀을 나열합니다.

   $ oc get secrets -n clusters

   출력 예

   NAME                              TYPE                      DATA   AGE
   builder-dockercfg-25qpp           kubernetes.io/dockercfg   1      128m
   default-dockercfg-mkvlz           kubernetes.io/dockercfg   1      128m
   democluster-admin-kubeconfig      Opaque                    1      127m
   democluster-etcd-encryption-key   Opaque                    1      128m
   democluster-kubeadmin-password    Opaque                    1      126m
   democluster-pull-secret           Opaque                    1      128m
   deployer-dockercfg-8lfpd          kubernetes.io/dockercfg   1      128m

4. 다음 명령을 실행하여 호스팅된 클러스터의 kubeconfig 파일을 추출합니다.

   $ oc get secret <secret_name> -n clusters -o jsonpath='{.data.kubeconfig}' | base64 -d > hosted-cluster-kubeconfig

   예

   $ oc get secret democluster-admin-kubeconfig -n clusters -o jsonpath='{.data.kubeconfig}' | base64 -d > hosted-cluster-kubeconfig

5. 다음 명령을 실행하여 호스팅된 클러스터 kubeconfig를 내보냅니다.

   $ export HC_KUBECONFIG=<path_to_hosted-cluster-kubeconfig>

6. 다음 명령을 실행하여 kubeletconfig가 호스팅된 클러스터에 미러링되었는지 확인하세요.

   $ oc --kubeconfig="$HC_KUBECONFIG" get cm -n openshift-config-managed | grep kubelet

   출력 예

   kubelet-serving-ca                            			1   79m
   kubeletconfig-performance-democluster-us-east-1a		1   15m

7. 다음 명령을 실행하여 호스팅된 클러스터에 단일 numa 노드 정책이 설정되었는지 확인하세요.

   $ oc --kubeconfig="$HC_KUBECONFIG" get cm kubeletconfig-performance-democluster-us-east-1a -o yaml -n openshift-config-managed | grep single

   출력 예

       topologyManagerPolicy: single-numa-node