6.3. ブートイメージ管理を有効にする


デフォルトでは、Google Cloud および Amazon Web Services (AWS)クラスターの場合、Machine Config Operator (MCO)はクラスターを更新するたびに、クラスター内のマシンセットのブートイメージを更新します。

ブートイメージ管理機能を無効化してブートイメージが更新されないようにした場合は、MachineConfiguration オブジェクトを編集し、機能を再有効化できます。

VMware vSphere では、テクノロジープレビュー機能としてブートイメージ管理を有効にできます。

重要

vSphere でのブートイメージ管理は、テクノロジープレビュー機能のみです。テクノロジープレビュー機能は、Red Hat 製品のサービスレベルアグリーメント (SLA) の対象外であり、機能的に完全ではないことがあります。Red Hat は、実稼働環境でこれらを使用することを推奨していません。テクノロジープレビュー機能は、最新の製品機能をいち早く提供して、開発段階で機能のテストを行い、フィードバックを提供していただくことを目的としています。

Red Hat のテクノロジープレビュー機能のサポート範囲に関する詳細は、テクノロジープレビュー機能のサポート範囲 を参照してください。

この機能を有効化すると、ブートイメージが現在の OpenShift Container Platform バージョンに更新されます。今後クラスターが新しい OpenShift Container Platform バージョンに再度更新されると、ブートイメージも再度更新されます。機能の有効化後に作成された新しいノードは、更新されたブートイメージを使用します。この機能は既存のノードには影響しません。

前提条件

  • 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
    Copy to Clipboard Toggle word wrap

手順

  1. cluster という名前の MachineConfiguration オブジェクトを編集して、一部またはすべてのマシンセットのブートイメージ管理機能を有効化します。

    $ 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:
          - apiGroup: machine.openshift.io 
      2
      
            resource: machinesets 
      3
      
            selection:
              mode: All 
      4
      Copy to Clipboard Toggle word wrap
      1
      ブートイメージ管理機能を設定します。
      2
      API グループを指定します。これは machine.openshift.io である必要があります。
      3
      変更を適用する、指定された API グループ内のリソースを指定します。これは machinesets である必要があります。
      4
      クラスター内のすべてのマシンセットに対して機能が有効化されるように指定します。
    • オプション: 特定のマシンセットに対してブートイメージ管理機能を有効化します。

      apiVersion: operator.openshift.io/v1
      kind: MachineConfiguration
      metadata:
        name: cluster
        namespace: openshift-machine-config-operator
      spec:
      # ...
        managedBootImages: 
      1
      
          machineManagers:
          - apiGroup: machine.openshift.io 
      2
      
            resource: machinesets 
      3
      
            selection:
              mode: Partial 
      4
      
              partial:
                machineResourceSelector:
                  matchLabels:
                    region: "east"
      Copy to Clipboard Toggle word wrap
      1
      ブートイメージの更新機能を設定します。
      2
      API グループを指定します。これは machine.openshift.io である必要があります。
      3
      変更を適用する、指定された API グループ内のリソースを指定します。これは machinesets である必要があります。
      4
      指定されたラベルを持つマシンセットに対して機能が有効であることを指定します。
      ヒント

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

      $ oc label machineset.machine ci-ln-hmy310k-72292-5f87z-worker-a region="east" -n openshift-machine-api
      Copy to Clipboard Toggle word wrap

検証

  • 影響を受けるノードが READY 状態に戻ると、マシン設定オブジェクトを表示してブートイメージ管理機能の現在の状態を表示します。

    $ oc get machineconfiguration cluster -o yaml
    Copy to Clipboard Toggle word wrap

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

    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
    Copy to Clipboard Toggle word wrap

  • 影響を受けるノードが READY 状態に戻ったら、次のいずれかの方法を使用して、現在のブートイメージを確認します。

    • Google Cloud と AWS の場合は、次のコマンドを実行してブートイメージバージョンを取得します。マシンセット内のブートイメージの場所と形式は、プラットフォームによって異なります。ただし、ブートイメージは常に spec.template.spec.providerSpec. パラメーターにリスト表示されます。

      $ 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
      
      # ...
      Copy to Clipboard Toggle word wrap

      1
      このブートイメージは、現在の OpenShift Container Platform バージョンと同じです。
    • VMware vSphere の場合は、影響を受けるノードからブートイメージバージョンを取得します。

      1. 以下のようなコマンドを実行して、ノードへの oc debug セッションを開きます。

        $ oc debug node/<node_name>
        Copy to Clipboard Toggle word wrap
      2. 次のコマンドを実行して、デバッグシェル内のルートディレクトリーとして /host を設定します。

        sh-5.1# chroot /host
        Copy to Clipboard Toggle word wrap
      3. rpm-ostree status コマンドを実行して、カスタムレイヤーイメージが使用されていることを確認します。

        sh-5.1# rpm-ostree status
        Copy to Clipboard Toggle word wrap

        出力例

        State: idle
        Deployments:
        * ostree-unverified-registry:quay.io/my-registry/...
                           Digest: sha256:...
        Copy to Clipboard Toggle word wrap

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat