4.6. GitOps ZTP를 사용하여 호스트 펌웨어 설정 관리

프로세스

1. 관리 클러스터의 호스트 펌웨어 설정을 검색합니다. 다음 명령을 실행합니다.

   $ oc get hostfirmwaresettings -n <cluster_namespace> <node_name> -o yaml

   출력 예

   apiVersion: v1
   items:
   - apiVersion: metal3.io/v1alpha1
     kind: HostFirmwareSettings
     metadata:
       creationTimestamp: "2024-09-11T10:29:43Z"
       generation: 1
       name: compute-1.example.com
       namespace: kni-qe-24
       ownerReferences:
       - apiVersion: metal3.io/v1alpha1
         blockOwnerDeletion: true
         controller: true
         kind: BareMetalHost
         name: compute-1.example.com
         uid: 0baddbb7-bb34-4224-8427-3d01d91c9287
       resourceVersion: "280057626"
       uid: 65d0e89b-1cd8-4317-966d-2fbbbe033fe9
     spec:
       settings: {}
     status:
       conditions:
       - lastTransitionTime: "2024-09-11T10:29:43Z"
         message: ""
         observedGeneration: 1
         reason: Success
         status: "True" 1
         type: ChangeDetected
       - lastTransitionTime: "2024-09-11T10:29:43Z"
         message: Invalid BIOS setting
         observedGeneration: 1
         reason: ConfigurationError
         status: "False" 2
         type: Valid
       lastUpdated: "2024-09-11T10:29:43Z"
       schema:
         name: schema-40562318
         namespace: compute-1
       settings: 3
         AccessControlService: Enabled
         AcpiHpet: Enabled
         AcpiRootBridgePxm: Enabled
         # ...

   1

   호스트 펌웨어 설정의 변경 사항이 감지되었음을 나타냅니다.

   2

   호스트에 잘못된 펌웨어 설정이 있음을 나타냅니다.

   3

   구성된 호스트 펌웨어 설정의 전체 목록은 status.settings 필드에서 반환됩니다.

2. 선택 사항: 클러스터에서 Hfs( HostFirmwareSettings )사용자정의 리소스의 상태를 확인합니다.

   $ oc get hfs -n <managed_cluster_namespace> <managed_cluster_name> -o jsonpath='{.status.conditions[?(@.type=="ChangeDetected")].status}'

   출력 예

   True

3. 선택 사항: 클러스터 호스트에서 잘못된 펌웨어 설정을 확인합니다. 다음 명령을 실행합니다.

   $ oc get hfs -n <managed_cluster_namespace> <managed_cluster_name> -o jsonpath='{.status.conditions[?(@.type=="Valid")].status}'

   출력 예

   False

프로세스

1. 적용하려는 펌웨어 설정이 포함된 호스트 펌웨어 프로필을 생성합니다. 예를 들어 다음 YAML 파일을 생성합니다.

   host-firmware.profile

   BootMode: Uefi
   LogicalProc: Enabled
   ProcVirtualization: Enabled

2. 클러스터를 프로비저닝하는 방법을 정의하는 데 사용하는 kustomization.yaml 파일을 기준으로 하드웨어 프로필 YAML 파일을 저장합니다. 예를 들면 다음과 같습니다.

   example-ztp/install
       └── site-install
             ├── siteconfig-example.yaml
             ├── kustomization.yaml
             └── host-firmware.profile

3. 클러스터에 적용할 펌웨어 프로필을 포함하도록 SiteConfig CR을 편집합니다. 예를 들면 다음과 같습니다.

   apiVersion: ran.openshift.io/v1
   kind: SiteConfig
   metadata:
     name: "site-plan-cluster"
     namespace: "example-cluster-namespace"
   spec:
     baseDomain: "example.com"
     # ...
     biosConfigRef:
       filePath: "./host-firmware.profile" 1

   1

   하드웨어 프로필을 사이트 전체에서 모든 클러스터 호스트에 적용

   참고

   가능한 경우 클러스터당 단일 SiteConfig CR을 사용합니다.

4. 선택 사항: 특정 클러스터의 호스트에 하드웨어 프로필을 적용하려면 적용하려는 하드웨어 프로필을 사용하여 cluster .biosConfigRef.filePath 를 업데이트합니다. 예를 들면 다음과 같습니다.

   clusters:
     - clusterName: "cluster-1"
       # ...
       biosConfigRef:
         filePath: "./host-firmware.profile" 1

   1

   cluster-1 클러스터의 모든 호스트에 적용

5. 선택 사항: 클러스터의 특정 호스트에 하드웨어 프로필을 적용하려면 적용하려는 하드웨어 프로필을 사용하여 cluster .nodes.biosConfigRef.filePath 를 업데이트합니다. 예를 들면 다음과 같습니다.

   clusters:
     - clusterName: "cluster-1"
       # ...
       nodes:
         - hostName: "compute-1.example.com"
           # ...
           bootMode: "UEFI"
           biosConfigRef:
             filePath: "./host-firmware.profile" 1

   1

   펌웨어 프로필을 클러스터의 compute-1.example.com 호스트에 적용

6. Git 리포지토리에서 SiteConfig CR 및 관련 kustomization.yaml 변경 사항을 커밋하고 변경 사항을 내보냅니다.

   ArgoCD 파이프라인은 변경 사항을 감지하고 관리 클러스터 배포를 시작합니다.

   참고

   클러스터 배포는 잘못된 펌웨어 설정이 감지된 경우에도 진행됩니다. GitOps ZTP를 사용하여 수정 사항을 적용하려면 수정된 하드웨어 프로필로 클러스터를 재배포합니다.