Chapter 5. Updated boot images

Procedure

1. Edit the MachineConfiguration object, named cluster, to enable the updating of boot images by running the following command:

   $ oc edit MachineConfiguration cluster

   Copy to Clipboard Toggle word wrap

   • Optional: Configure the boot image update feature for all the machine sets:

     apiVersion: operator.openshift.io/v1
     kind: MachineConfiguration
     metadata:
       name: cluster
       namespace: openshift-machine-config-operator
     spec:
     # ...
       managedBootImages: 

     1

     
         machineManagers:
         - resource: machinesets
           apiGroup: machine.openshift.io
           selection:
             mode: All 

     2

     Copy to Clipboard Toggle word wrap

     1

     Activates the boot image update feature.

     2

     Specifies that all the machine sets in the cluster are to be updated.

   • Optional: Configure the boot image update feature for specific machine sets:

     apiVersion: operator.openshift.io/v1
     kind: MachineConfiguration
     metadata:
       name: cluster
       namespace: openshift-machine-config-operator
     spec:
     # ...
       managedBootImages: 

     1

     
         machineManagers:
         - resource: machinesets
           apiGroup: machine.openshift.io
           selection:
             mode: Partial
             partial:
               machineResourceSelector:
                 matchLabels:
                   update-boot-image: "true" 

     2

     Copy to Clipboard Toggle word wrap

     1

     Activates the boot image update feature.

     2

     Specifies that any machine set with this label is to be updated.

     Tip

     If an appropriate label is not present on the machine set, add a key-value pair by running a command similar to following:

     $ oc label machineset.machine ci-ln-hmy310k-72292-5f87z-worker-a update-boot-image=true -n openshift-machine-api

     Copy to Clipboard Toggle word wrap

Verification

1. View the current state of the boot image updates by viewing the machine configuration object:

   $ oc get machineconfiguration cluster -n openshift-machine-api -o yaml

   Copy to Clipboard Toggle word wrap

   Example machine set with the boot image reference

   kind: MachineConfiguration
   metadata:
     name: cluster
   # ...
   status:
     conditions:
     - lastTransitionTime: "2024-09-09T13:51:37Z" 

   1

   
       message: Reconciled 1 of 2 MAPI MachineSets | Reconciled 0 of 0 CAPI MachineSets
         | Reconciled 0 of 0 CAPI MachineDeployments
       reason: BootImageUpdateConfigurationAdded
       status: "True"
       type: BootImageUpdateProgressing
     - lastTransitionTime: "2024-09-09T13:51:37Z" 

   2

   
       message: 0 Degraded MAPI MachineSets | 0 Degraded CAPI MachineSets | 0 CAPI MachineDeployments
       reason: BootImageUpdateConfigurationAdded
       status: "False"
       type: BootImageUpdateDegraded

   Copy to Clipboard Toggle word wrap

   1

   Status of the boot image update. Cluster CAPI Operator machine sets and machine deployments are not currently supported for boot image updates.

   2

   Indicates if any boot image updates failed. If any of the updates fail, the Machine Config Operator is degraded. In this case, manual intervention might be required.

2. Get the boot image version by running the following command:

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

   Copy to Clipboard Toggle word wrap

   Example machine set with the boot image reference

   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

   
   # ...

   Copy to Clipboard Toggle word wrap

   1

   This boot image is the same as the current OpenShift Container Platform version. The location and format of the boot image within the machine set differs, based on the platform. However, the boot image is always listed in the spec.template.spec.providerSpec. parameter.

Procedure

1. Disable updated boot images by editing the MachineConfiguration object:

   $ oc edit MachineConfiguration cluster

   Copy to Clipboard Toggle word wrap

2. Make the machineManagers parameter an empty array:

   apiVersion: operator.openshift.io/v1
   kind: MachineConfiguration
   metadata:
     name: cluster
     namespace: openshift-machine-config-operator
   spec:
   # ...
     managedBootImages: 

   1

   
       machineManagers: []

   Copy to Clipboard Toggle word wrap

   1

   Remove the parameters listed under machineManagers and add the [] characters to disable boot image updates.