4.6. GitOps ZTP によるホストファームウェア設定の管理

手順

1. マネージドクラスターのホストファームウェア設定を取得します。以下のコマンドを実行します。

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

   Copy to Clipboard Toggle word wrap

   出力例

   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
         # ...

   Copy to Clipboard Toggle word wrap

   1

   ホストファームウェア設定の変更が検出されたことを示しています。

   2

   ホストのファームウェア設定が無効であることを示しています。

   3

   status.settings フィールドに、設定されているホストファームウェア設定の完全なリストが返されます。

2. オプション: クラスターの HostFirmwareSettings (hfs) カスタムリソースのステータスを確認します。

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

   Copy to Clipboard Toggle word wrap

   出力例

   True

   Copy to Clipboard Toggle word wrap

3. オプション: クラスターホストに無効なファームウェア設定がないか確認します。以下のコマンドを実行します。

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

   Copy to Clipboard Toggle word wrap

   出力例

   False

   Copy to Clipboard Toggle word wrap

手順

1. 適用するファームウェア設定を含むホストファームウェアプロファイルを作成します。たとえば、次の YAML ファイルを作成します。

   host-firmware.profile

   BootMode: Uefi
   LogicalProc: Enabled
   ProcVirtualization: Enabled

   Copy to Clipboard Toggle word wrap

2. クラスターのプロビジョニング方法を定義するために使用する kustomization.yaml ファイルを基準として、ハードウェアプロファイルの YAML ファイルを保存します。次に例を示します。

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

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

   1

   サイト全体のすべてのクラスターホストにハードウェアプロファイルを適用します。

   注記

   可能な場合は、クラスターごとに 1 つの SiteConfig CR を使用してください。

4. オプション: 特定のクラスター内のホストにハードウェアプロファイルを適用するには、clusters.biosConfigRef.filePath を適用するハードウェアプロファイルで更新します。以下に例を示します。

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

   1

   Copy to Clipboard Toggle word wrap

   1

   cluster-1 クラスター内のすべてのホストに適用されます。

5. オプション: クラスター内の特定のホストにハードウェアプロファイルを適用するには、clusters.nodes.biosConfigRef.filePath を、適用するハードウェアプロファイルで更新します。以下に例を示します。

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

   1

   Copy to Clipboard Toggle word wrap

   1

   ファームウェアプロファイルをクラスター内の compute-1.example.com ホストに適用します。

6. SiteConfig CR と関連する kustomization.yaml の変更を Git リポジトリーにコミットし、変更をプッシュします。

   ArgoCD パイプラインが変更を検出し、マネージドクラスターのデプロイを開始します。

   注記

   無効なファームウェア設定が検出された場合でも、クラスターのデプロイは続行されます。GitOps ZTP を使用して修正を適用するには、修正したハードウェアプロファイルを使用してクラスターを再デプロイしてください。