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. 可选：检查集群中的 HostFirmwareSettings (hfs)自定义资源的状态：

   $ 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. 可选。要将硬件配置集应用到特定集群中的主机，请使用您要应用的硬件配置集更新 clusters.biosConfigRef.filePath。例如：

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

   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

   1

   将固件配置集应用到集群中的 compute-1.example.com 主机

6. 在 Git 存储库中提交 SiteConfig CR 及关联的 kustomization.yaml 更改并推送更改。

   ArgoCD 管道检测到更改并开始受管集群部署。

   注意

   即使检测到无效的固件设置，集群部署也会进行。要使用 GitOps ZTP 应用更正，请使用更正的硬件配置集重新部署集群。