第5章 ブートイメージ更新

手順

1. 次のコマンドを実行して、cluster という名前の MachineConfiguration オブジェクトを編集し、ブートイメージの更新を有効にします。

   Copy to Clipboard Toggle word wrap

   $ oc edit MachineConfiguration cluster

   • オプション: すべてのマシンセットのブートイメージ更新機能を設定します。

     Copy to Clipboard Toggle word wrap

     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

     1

     ブートイメージ更新機能を有効にします。

     2

     クラスター内のすべてのマシンセットを更新することを指定します。

   • オプション: 特定のマシンセットのブートイメージ更新機能を設定します。

     Copy to Clipboard Toggle word wrap

     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

     1

     ブートイメージ更新機能を有効にします。

     2

     このラベルが設定されたマシンすべてを更新するように指定します。

     ヒント

     適切なラベルがマシンセットに存在しない場合は、以下のようなコマンドを実行してキーと値のペアを追加します。

     Copy to Clipboard Toggle word wrap

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

検証

1. マシン設定オブジェクトを表示して、ブートイメージ更新の現在の状態を確認します。

   Copy to Clipboard Toggle word wrap

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

   ブートイメージ参照を含むマシンセット例

   Copy to Clipboard Toggle word wrap

   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

   1

   ブートイメージの更新のステータス。Cluster CAPI Operator のマシンセットとマシンのデプロイメントは、現在、ブートイメージの更新ではサポートされていません。

   2

   ブートイメージの更新が失敗したかどうかを示します。いずれかの更新が失敗すると、Machine Config Operator の機能が低下します。この場合、手動による介入が必要になる可能性があります。

2. 次のコマンドを実行してブートイメージのバージョンを取得します。

   Copy to Clipboard Toggle word wrap

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

   ブートイメージ参照を含むマシンセット例

   Copy to Clipboard Toggle word wrap

   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 バージョンと同じです。