10.2. PolicyGenTemplate 리소스를 사용한 고급 관리형 클러스터 구성

프로세스

1. 성능 모드를 설정하려면 out/argocd/example/policygentemplates// 에 있는 group-du-sno-ranGen.yaml 참조 파일의 PerformanceProfile 에 대한 PolicyGenTemplate 항목을 다음과 같이 업데이트합니다.

   - fileName: PerformanceProfile.yaml
     policyName: "config-policy"
     metadata:
     # ...
     spec:
       # ...
       workloadHints:
            realTime: true
            highPowerConsumption: false
            perPodPowerManagement: false

   Copy to Clipboard Toggle word wrap
2. Git에서 PolicyGenTemplate 변경 사항을 커밋한 다음, GitOps ZTP Argo CD 애플리케이션에서 모니터링하는 Git 저장소에 푸시합니다.

프로세스

1. out/argocd/example/policygentemplates/ 에 있는 group-du-sno-ranGen.yaml 참조 파일의 PerformanceProfile 에 대한 PolicyGenTemplate 항목을 다음과 같이 업데이트하여 고성능 모드를 설정합니다.

   - fileName: PerformanceProfile.yaml
     policyName: "config-policy"
     metadata:
     #  ...
     spec:
     #  ...
       workloadHints:
            realTime: true
            highPowerConsumption: true
            perPodPowerManagement: false

   Copy to Clipboard Toggle word wrap
2. Git에서 PolicyGenTemplate 변경 사항을 커밋한 다음, GitOps ZTP Argo CD 애플리케이션에서 모니터링하는 Git 저장소에 푸시합니다.

프로세스

1. 다음과 같이 out/argocd/example/policygentemplates/ 에 있는 group-du-sno-ranGen.yaml 참조 파일의 PerformanceProfile 에 대한 PolicyGenTemplate 항목을 업데이트하여 전원 절약 모드를 구성합니다. 추가 커널 인수 객체를 통해 CPU 관리자를 절전 모드로 구성하는 것이 좋습니다.

   - fileName: PerformanceProfile.yaml
     policyName: "config-policy"
     metadata:
     # ...
     spec:
       # ...
       workloadHints:
         realTime: true
         highPowerConsumption: false
         perPodPowerManagement: true
       # ...
       additionalKernelArgs:
         - # ...
         - "cpufreq.default_governor=schedutil" 

   1

   Copy to Clipboard Toggle word wrap

   1

   schedutil 가버너가 권장되지만, ondemand 및 powersave 등 다른 가버너도 사용할 수 있습니다.

2. Git에서 PolicyGenTemplate 변경 사항을 커밋한 다음, GitOps ZTP Argo CD 애플리케이션에서 모니터링하는 Git 저장소에 푸시합니다.

검증

1. 다음 명령을 사용하여 식별된 노드 목록에서 배포된 클러스터의 작업자 노드를 선택합니다.

   $ oc get nodes

   Copy to Clipboard Toggle word wrap

2. 다음 명령을 사용하여 노드에 로그인합니다.

   $ oc debug node/<node-name>

   Copy to Clipboard Toggle word wrap

   <노드 이름>을 전원 상태를 확인하려는 노드의 이름으로 바꾸세요.

3. 디버그 쉘 내에서 /host를 root 디렉터리로 설정합니다. 디버그 Pod는 Pod 내의 /host에 호스트의 루트 파일 시스템을 마운트합니다. 루트 디렉토리를 /host 로 변경하면 다음 예와 같이 호스트의 실행 파일 경로에 포함된 바이너리를 실행할 수 있습니다.

   # chroot /host

   Copy to Clipboard Toggle word wrap

4. 다음 명령을 실행하여 적용된 전원 상태를 확인하세요.

   # cat /proc/cmdline

   Copy to Clipboard Toggle word wrap

프로세스

1. out/argocd/example/policygentemplates/ 에 있는 group-du-sno-ranGen.yaml 참조 파일에서 TunedPerformancePatch 에 대한 PolicyGenTemplate 항목을 업데이트합니다. 전력 절감을 극대화하려면 다음 예와 같이 max_perf_pct를 추가하세요.

   - fileName: TunedPerformancePatch.yaml
     policyName: "config-policy"
     spec:
       profile:
         - name: performance-patch
           data: |
             # ...
             [sysfs]
             /sys/devices/system/cpu/intel_pstate/max_perf_pct=<x> 

   1

   Copy to Clipboard Toggle word wrap

   1

   max_perf_pct 는 cpufreq 드라이버가 설정할 수 있는 최대 주파수를 최대 지원 CPU 주파수의 백분율로 제어합니다. 이 값은 모든 CPU에 적용됩니다. 지원되는 최대 주파수는 /sys/devices/system/cpu/cpu0/cpufreq/cpuinfo_max_freq 에서 확인할 수 있습니다. 시작점으로, 모든 CPU를 All Cores Turbo 주파수로 제한하는 백분율을 사용할 수 있습니다. 모든 코어 터보 주파수는 모든 코어가 완전히 사용되었을 때 실행되는 주파수입니다.

   참고

   전력 절감을 극대화하려면 더 낮은 값을 설정하세요. max_perf_pct 값을 낮게 설정하면 최대 CPU 주파수가 제한되어 전력 소비는 줄어들지만 성능에 영향을 미칠 가능성도 있습니다. 다양한 값으로 실험하고 시스템 성능과 전력 소비를 모니터링하여 사용 사례에 가장 적합한 설정을 찾으세요.

2. Git에서 PolicyGenTemplate 변경 사항을 커밋한 다음, GitOps ZTP Argo CD 애플리케이션에서 모니터링하는 Git 저장소에 푸시합니다.

프로세스

1. 요구 사항에 따라 다음 PolicyGenTemplate 변경 사항을 group-du-3node-ranGen.yaml , group-du-sno-ranGen.yaml 또는 group-du-standard-ranGen.yaml 파일에 적용하세요.

   1. spec.sourceFiles 에 전송 호스트를 구성하는 PtpOperatorConfig CR 파일을 추가합니다.

      - fileName: PtpOperatorConfigForEvent.yaml
        policyName: "config-policy"
        spec:
          daemonNodeSelector: {}
          ptpEventConfig:
            enableEventPublisher: true
            transportHost: http://ptp-event-publisher-service-NODE_NAME.openshift-ptp.svc.cluster.local:9043

      Copy to Clipboard Toggle word wrap
      참고

      OpenShift Container Platform 4.13 이상에서는 PTP 이벤트와 함께 HTTP 전송을 사용할 때 PtpOperatorConfig 리소스에서 transportHost 필드를 설정할 필요가 없습니다.

   2. PTP 클록 유형과 인터페이스에 맞게 linuxptp 와 phc2sys를 구성합니다. 예를 들어, 다음 YAML을 spec.sourceFiles 에 추가합니다.

      - fileName: PtpConfigSlave.yaml 

      1

      
        policyName: "config-policy"
        metadata:
          name: "du-ptp-slave"
        spec:
          profile:
          - name: "slave"
            interface: "ens5f1" 

      2

      
            ptp4lOpts: "-2 -s --summary_interval -4" 

      3

      
            phc2sysOpts: "-a -r -m -n 24 -N 8 -R 16" 

      4

      
          ptpClockThreshold: 

      5

      
            holdOverTimeout: 30 # seconds
            maxOffsetThreshold: 100  # nano seconds
            minOffsetThreshold: -100

      Copy to Clipboard Toggle word wrap

      1

      요구 사항에 따라 PtpConfigMaster.yaml 또는 PtpConfigSlave.yaml 이 될 수 있습니다. group-du-sno-ranGen.yaml 또는 group-du-3node-ranGen.yaml 기반 구성의 경우 PtpConfigSlave.yaml을 사용하세요.

      2

      장치별 인터페이스 이름입니다.

      3

      PTP 빠른 이벤트를 활성화하려면 .spec.sourceFiles.spec.profile 의 ptp4lOpts 에 --summary_interval -4 값을 추가해야 합니다.

      4

      필수 phc2sysOpts 값. -m은 stdout 에 메시지를 출력합니다. linuxptp-daemon DaemonSet은 로그를 구문 분석하고 Prometheus 메트릭을 생성합니다.

      5

      선택 사항: ptpClockThreshold 스탠자가 없으면 ptpClockThreshold 필드에 기본값이 사용됩니다. 이 절에서는 기본 ptpClockThreshold 값을 보여줍니다. ptpClockThreshold 값은 PTP 마스터 클록이 분리된 후 PTP 이벤트가 트리거되기까지 걸리는 시간을 구성합니다. holdOverTimeout은 PTP 마스터 클록이 연결 해제될 때 PTP 클록 이벤트 상태가 FREERUN 으로 변경되기 전의 시간 값(초)입니다. maxOffsetThreshold 및 minOffsetThreshold 설정은 CLOCK_REALTIME ( phc2sys ) 또는 마스터 오프셋( ptp4l ) 값과 비교하는 나노초 단위의 오프셋 값을 구성합니다. ptp4l 또는 phc2sys 오프셋 값이 이 범위를 벗어나면 PTP 클록 상태가 FREERUN 으로 설정됩니다. 오프셋 값이 이 범위 내에 있으면 PTP 클록 상태가 LOCKED 로 설정됩니다.

2. 필요한 기타 변경 사항과 파일을 사용자 정의 사이트 저장소에 병합합니다.
3. GitOps ZTP를 사용하여 PTP 빠른 이벤트를 새 사이트에 배포하려면 사이트 구성 저장소에 변경 사항을 푸시하세요.

프로세스

1. storage.bu 파일을 만듭니다.

   variant: fcos
   version: 1.3.0
   storage:
     disks:
     - device: /dev/disk/by-path/pci-0000:01:00.0-scsi-0:2:0:0 

   1

   
       wipe_table: false
       partitions:
       - label: var-lib-containers
         start_mib: <start_of_partition> 

   2

   
         size_mib: <partition_size> 

   3

   
     filesystems:
       - path: /var/lib/containers
         device: /dev/disk/by-partlabel/var-lib-containers
         format: xfs
         wipe_filesystem: true
         with_mount_unit: true
         mount_options:
           - defaults
           - prjquota

   Copy to Clipboard Toggle word wrap

   1

   root 디스크를 지정합니다.

   2

   파티션의 시작을 MiB 단위로 지정합니다. 값이 너무 작으면 설치가 실패합니다.

   3

   파티션의 크기를 지정합니다. 값이 너무 작으면 배포가 실패합니다.

2. 다음 명령을 실행하여 storage.bu를 Ignition 파일로 변환합니다.

   $ butane storage.bu

   Copy to Clipboard Toggle word wrap

   출력 예

   {"ignition":{"version":"3.2.0"},"storage":{"disks":[{"device":"/dev/disk/by-path/pci-0000:01:00.0-scsi-0:2:0:0","partitions":[{"label":"var-lib-containers","sizeMiB":0,"startMiB":250000}],"wipeTable":false}],"filesystems":[{"device":"/dev/disk/by-partlabel/var-lib-containers","format":"xfs","mountOptions":["defaults","prjquota"],"path":"/var/lib/containers","wipeFilesystem":true}]},"systemd":{"units":[{"contents":"# # Generated by Butane\n[Unit]\nRequires=systemd-fsck@dev-disk-by\\x2dpartlabel-var\\x2dlib\\x2dcontainers.service\nAfter=systemd-fsck@dev-disk-by\\x2dpartlabel-var\\x2dlib\\x2dcontainers.service\n\n[Mount]\nWhere=/var/lib/containers\nWhat=/dev/disk/by-partlabel/var-lib-containers\nType=xfs\nOptions=defaults,prjquota\n\n[Install]\nRequiredBy=local-fs.target","enabled":true,"name":"var-lib-containers.mount"}]}}

   Copy to Clipboard Toggle word wrap

3. JSON Pretty Print 와 같은 도구를 사용하여 출력을 JSON 형식으로 변환합니다.

4. SiteConfig CR의 .spec.clusters.nodes.ignitionConfigOverride 필드에 출력을 복사합니다.

   예

   [...]
   spec:
     clusters:
       - nodes:
           - ignitionConfigOverride: |
             {
               "ignition": {
                 "version": "3.2.0"
               },
               "storage": {
                 "disks": [
                   {
                     "device": "/dev/disk/by-path/pci-0000:01:00.0-scsi-0:2:0:0",
                     "partitions": [
                       {
                         "label": "var-lib-containers",
                         "sizeMiB": 0,
                         "startMiB": 250000
                       }
                     ],
                     "wipeTable": false
                   }
                 ],
                 "filesystems": [
                   {
                     "device": "/dev/disk/by-partlabel/var-lib-containers",
                     "format": "xfs",
                     "mountOptions": [
                       "defaults",
                       "prjquota"
                     ],
                     "path": "/var/lib/containers",
                     "wipeFilesystem": true
                   }
                 ]
               },
               "systemd": {
                 "units": [
                   {
                     "contents": "# # Generated by Butane\n[Unit]\nRequires=systemd-fsck@dev-disk-by\\x2dpartlabel-var\\x2dlib\\x2dcontainers.service\nAfter=systemd-fsck@dev-disk-by\\x2dpartlabel-var\\x2dlib\\x2dcontainers.service\n\n[Mount]\nWhere=/var/lib/containers\nWhat=/dev/disk/by-partlabel/var-lib-containers\nType=xfs\nOptions=defaults,prjquota\n\n[Install]\nRequiredBy=local-fs.target",
                     "enabled": true,
                     "name": "var-lib-containers.mount"
                   }
                 ]
               }
             }
   [...]

   Copy to Clipboard Toggle word wrap

   참고

   .spec.clusters.nodes.ignitionConfigOverride 필드가 없으면 생성합니다.

검증

1. 설치 중 또는 설치 후에 다음 명령을 실행하여 허브 클러스터에서 BareMetalHost 개체에 주석이 표시되는지 확인합니다.

   $ oc get bmh -n my-sno-ns my-sno -ojson | jq '.metadata.annotations["bmac.agent-install.openshift.io/ignition-config-overrides"]

   Copy to Clipboard Toggle word wrap

   출력 예

   "{\"ignition\":{\"version\":\"3.2.0\"},\"storage\":{\"disks\":[{\"device\":\"/dev/disk/by-id/wwn-0x6b07b250ebb9d0002a33509f24af1f62\",\"partitions\":[{\"label\":\"var-lib-containers\",\"sizeMiB\":0,\"startMiB\":250000}],\"wipeTable\":false}],\"filesystems\":[{\"device\":\"/dev/disk/by-partlabel/var-lib-containers\",\"format\":\"xfs\",\"mountOptions\":[\"defaults\",\"prjquota\"],\"path\":\"/var/lib/containers\",\"wipeFilesystem\":true}]},\"systemd\":{\"units\":[{\"contents\":\"# Generated by Butane\\n[Unit]\\nRequires=systemd-fsck@dev-disk-by\\\\x2dpartlabel-var\\\\x2dlib\\\\x2dcontainers.service\\nAfter=systemd-fsck@dev-disk-by\\\\x2dpartlabel-var\\\\x2dlib\\\\x2dcontainers.service\\n\\n[Mount]\\nWhere=/var/lib/containers\\nWhat=/dev/disk/by-partlabel/var-lib-containers\\nType=xfs\\nOptions=defaults,prjquota\\n\\n[Install]\\nRequiredBy=local-fs.target\",\"enabled\":true,\"name\":\"var-lib-containers.mount\"}]}}"

   Copy to Clipboard Toggle word wrap

2. 설치 후 단일 노드 OpenShift 디스크 상태를 확인합니다.

   1. 다음 명령을 실행하여 단일 노드 OpenShift 노드에서 디버그 세션을 시작합니다. 이 단계는 <node_name>-debug라는 디버그 Pod를 인스턴스화합니다.

      $ oc debug node/my-sno-node

      Copy to Clipboard Toggle word wrap

   2. 다음 명령을 실행하여 디버그 셸에서 /host를 루트 디렉토리로 설정합니다. 디버그 Pod는 Pod 내의 /host에 호스트의 루트 파일 시스템을 마운트합니다. root 디렉토리를 /host로 변경하면 호스트의 실행 경로에 포함된 바이너리를 실행할 수 있습니다.

      # chroot /host

      Copy to Clipboard Toggle word wrap

   3. 다음 명령을 실행하여 사용 가능한 모든 블록 장치에 대한 정보를 나열하세요.

      # lsblk

      Copy to Clipboard Toggle word wrap

      출력 예

      NAME   MAJ:MIN RM   SIZE RO TYPE MOUNTPOINTS
      sda      8:0    0 446.6G  0 disk
      ├─sda1   8:1    0     1M  0 part
      ├─sda2   8:2    0   127M  0 part
      ├─sda3   8:3    0   384M  0 part /boot
      ├─sda4   8:4    0 243.6G  0 part /var
      │                                /sysroot/ostree/deploy/rhcos/var
      │                                /usr
      │                                /etc
      │                                /
      │                                /sysroot
      └─sda5   8:5    0 202.5G  0 part /var/lib/containers

      Copy to Clipboard Toggle word wrap

   4. 다음 명령을 실행하여 파일 시스템 디스크 공간 사용량에 대한 정보를 표시합니다.

      # df -h

      Copy to Clipboard Toggle word wrap

      출력 예

      Filesystem      Size  Used Avail Use% Mounted on
      devtmpfs        4.0M     0  4.0M   0% /dev
      tmpfs           126G   84K  126G   1% /dev/shm
      tmpfs            51G   93M   51G   1% /run
      /dev/sda4       244G  5.2G  239G   3% /sysroot
      tmpfs           126G  4.0K  126G   1% /tmp
      /dev/sda5       203G  119G   85G  59% /var/lib/containers
      /dev/sda3       350M  110M  218M  34% /boot
      tmpfs            26G     0   26G   0% /run/user/1000

      Copy to Clipboard Toggle word wrap

프로세스

1. 적절한 PolicyGenTemplate CR에서 스토리지 클래스, 영구 볼륨 클레임, 영구 볼륨 및 이미지 레지스트리 구성을 구성합니다. 예를 들어, 개별 사이트를 구성하려면 다음 YAML을 example-sno-site.yaml 파일에 추가합니다.

   sourceFiles:
     # storage class
     - fileName: StorageClass.yaml
       policyName: "sc-for-image-registry"
       metadata:
         name: image-registry-sc
         annotations:
           ran.openshift.io/ztp-deploy-wave: "100" 

   1

   
     # persistent volume claim
     - fileName: StoragePVC.yaml
       policyName: "pvc-for-image-registry"
       metadata:
         name: image-registry-pvc
         namespace: openshift-image-registry
         annotations:
           ran.openshift.io/ztp-deploy-wave: "100"
       spec:
         accessModes:
           - ReadWriteMany
         resources:
           requests:
             storage: 100Gi
         storageClassName: image-registry-sc
         volumeMode: Filesystem
     # persistent volume
     - fileName: ImageRegistryPV.yaml 

   2

   
       policyName: "pv-for-image-registry"
       metadata:
         annotations:
           ran.openshift.io/ztp-deploy-wave: "100"
     - fileName: ImageRegistryConfig.yaml
       policyName: "config-for-image-registry"
       complianceType: musthave
       metadata:
         annotations:
           ran.openshift.io/ztp-deploy-wave: "100"
       spec:
         storage:
           pvc:
             claim: "image-registry-pvc"

   Copy to Clipboard Toggle word wrap

   1

   사이트, 공통 또는 그룹 수준에서 이미지 레지스트리를 구성하는지에 따라 ztp-deploy-wave 에 적절한 값을 설정합니다. ztp-deploy-wave: "100"은 참조된 소스 파일을 함께 그룹화할 수 있으므로 개발이나 테스트에 적합합니다.

   2

   ImageRegistryPV.yaml 에서는 SiteConfig CR의 mount_point 필드에 설정된 값과 일치하도록 spec.local.path 필드가 /var/imageregistry 로 설정되어 있는지 확인합니다.

   중요

   complianceType: mustonlyhave for the - fileName: ImageRegistryConfig.yaml 설정을 설정하지 마십시오. 이로 인해 레지스트리 Pod 배포가 실패할 수 있습니다.

2. Git에서 PolicyGenTemplate 변경 사항을 커밋한 다음 GitOps ZTP ArgoCD 애플리케이션에서 모니터링하는 Git 리포지토리로 내보냅니다.