6.3. 启用引导镜像管理

先决条件

• 对于 vSphere，在集群中启用 TechPreviewNoUpgrade 功能集。如需更多信息，请参阅“使用功能门启用功能”。

  注意

  启用 TechPreviewNoUpgrade 功能集将无法撤消，并防止次版本更新。不建议在生产环境集群中使用这些功能集。

  等待 managedBootImagesStatus 小节显示在 MachineConfiguration 对象中。

  apiVersion: operator.openshift.io/v1
  kind: MachineConfiguration
  metadata:
    name: cluster
  # ...
  status:
  # ...
    managedBootImagesStatus:
      machineManagers:
      - apiGroup: machine.openshift.io
        resource: machinesets
        selection:
          mode: None

验证

• 当受影响的节点返回 READY 状态时，通过查看机器配置对象来查看引导镜像管理功能的当前状态：

  $ oc get machineconfiguration cluster -o yaml

  使用引导镜像引用的机器集示例

  kind: MachineConfiguration
  metadata:
    name: cluster
  # ...
  status:
    conditions:
    - lastTransitionTime: "2025-05-01T20:11:49Z"
      message: Reconciled 2 of 4 MAPI MachineSets | Reconciled 0 of 0 CAPI MachineSets
        | Reconciled 0 of 0 CAPI MachineDeployments
      reason: BootImageUpdateConfigurationUpdated
      status: "True"
      type: BootImageUpdateProgressing
    - lastTransitionTime: "2025-05-01T19:30:13Z"
      message: 0 Degraded MAPI MachineSets | 0 Degraded CAPI MachineSets | 0 CAPI MachineDeployments
      reason: BootImageUpdateConfigurationUpdated
      status: "False"
      type: BootImageUpdateDegraded
    managedBootImagesStatus:
      machineManagers:
      - apiGroup: machine.openshift.io
        resource: machinesets
        selection:
          mode: All

• 当受影响的节点返回到 READY 状态时，使用以下方法之一检查当前的引导镜像：

  • 对于 Google Cloud 和 AWS，运行以下命令来获取引导镜像版本。根据具体的平台，机器集中的引导镜像的位置和格式可能会有所不同。但是，引导镜像总是列在 spec.template.spec.providerSpec. 参数中。

    $ oc get machinesets <machineset_name> -n openshift-machine-api -o yaml

    使用引导镜像引用的机器集示例

    apiVersion: machine.openshift.io/v1beta1
    kind: MachineSet
    metadata:
      labels:
        machine.openshift.io/cluster-api-cluster: ci-ln-77hmkpt-72292-d4pxp
        update-boot-image: "true"
      name: ci-ln-77hmkpt-72292-d4pxp-worker-a
      namespace: openshift-machine-api
    spec:
    # ...
      template:
    # ...
        spec:
    # ...
          providerSpec:
    # ...
            value:
              disks:
              - autoDelete: true
                boot: true
                image: projects/rhcos-cloud/global/images/<boot_image> 

    1

    
    # ...

    1

    此引导镜像与当前的 OpenShift Container Platform 版本相同。

  • 对于 VMware vSphere，从受影响的节点获取引导镜像版本：

    1. 运行以下命令，打开到节点的 oc debug 会话：

       $ oc debug node/<node_name>

    2. 运行以下命令，将 /host 设置为 debug shell 中的根目录：

       sh-5.1# chroot /host

    3. 运行 rpm-ostree status 命令，以查看自定义分层镜像正在使用：

       sh-5.1# rpm-ostree status

       输出示例

       State: idle
       Deployments:
       * ostree-unverified-registry:quay.io/my-registry/...
                          Digest: sha256:...