Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

6.9. ブートイメージ管理

Google Cloud Platform (GCP) および Amazon Web Services (AWS) クラスターの場合、デフォルトでは、Machine Config Operator (MCO) がノードのスケールアップに使用されるブートイメージを管理および更新します。つまり、デフォルトでは、クラスターをアップグレードするたびに、MCO によってブートイメージが更新されます。

その他のすべてのプラットフォームでは、MCO はクラスターの更新ごとにブートイメージを更新しません。

6.9.1. ブートイメージ管理について
リンクのコピー

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

GCP および AWS の場合、必要に応じてブートイメージ管理機能を無効化できます。この機能が無効になっていると、ブートイメージはクラスターで更新されなくなります。たとえば、この機能を無効にすると、クラスターが元々 OpenShift Container Platform 4.16 で作成されていた場合、クラスターがそれ以降のバージョンであっても、MCO がノードの作成に使用するブートイメージは同じ 4.16 バージョンになります。

ただし、古いブートイメージを使用すると、次の問題が発生する可能性があります。

  • ノードの起動に余分に時間がかかる
  • 証明書の有効期限の問題が発生する
  • バージョンスキューの問題が発生する

この機能を無効にする方法は、「ブートイメージ管理を無効にする」を参照してください。この機能を無効にした場合は、いつでも再有効化できます。詳細は、「ブートイメージ管理を有効にする」を参照してください。

注記

ブートイメージ管理を設定する機能は、GCP および AWS クラスターでのみ使用できます。Cluster CAPI Operator によって管理されるクラスターではサポートされません。

機能を無効化した後、または再有効化した後のクラスターの動作は、次のシナリオを含め、変更を行ったタイミングによって異なります。

  • 新しい OpenShift Container Platform バージョンに更新する前にこの機能を無効にすると、次のようになります。

    • マシンセットで使用されるブートイメージのバージョンは、機能が無効にされたときと同じ OpenShift Container Platform バージョンのままになります。
    • ノードをスケールアップすると、新しいノードは同じ OpenShift Container Platform バージョンを使用します。

  • 新しい OpenShift Container Platform バージョンに更新した後にこの機能を無効にすると、次のようになります。

    • マシンセットで使用されるブートイメージバージョンは、更新された OpenShift Container Platform バージョンと一致するように更新されます。
    • ノードをスケールアップすると、新しいノードは更新された OpenShift Container Platform バージョンを使用します。
    • 新しい OpenShift Container Platform バージョンに更新すると、マシンセット内のブートイメージのバージョンは、現在のバージョンのままとなり、クラスターとともに更新されません。

  • 機能を無効にした後に有効にすると、次のようになります。

    • マシンセットで使用されるブートイメージバージョンが異なる場合は、現在の OpenShift Container Platform バージョンに更新されます。
    • ノードをスケールアップすると、新しいノードはクラスター内の現在の OpenShift Container Platform バージョンを使用します。
注記

ブートイメージはノードがスケールアップされるときにのみ使用されるため、この機能は既存のノードには影響しません。

クラスターで使用されている現在のブートイメージを表示するには、マシンセットを調べます。

注記

マシンセット内のブートイメージの場所と形式は、プラットフォームによって異なります。ただし、ブートイメージは常に spec.template.spec.providerSpec. パラメーターにリスト表示されます。

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

apiVersion: machine.openshift.io/v1beta1
kind: MachineSet
metadata:
  name: ci-ln-hmy310k-72292-5f87z-worker-a
  namespace: openshift-machine-api
spec:
# ...
  template:
# ...
    spec:
# ...
      providerSpec:
# ...
        value:
          disks:
          - autoDelete: true
            boot: true
            image: projects/rhcos-cloud/global/images/rhcos-412-85-202203181601-0-gcp-x86-64
1 

# ...
Copy to Clipboard Toggle word wrap

1
このブートイメージは、クラスターの現在のバージョンに関係なく、最初にインストールされた OpenShift Container Platform バージョン (この例では OpenShift Container Platform 4.12) と同じです。providerSpec フィールドの構造はプラットフォームごとに異なるため、マシンセット内でブートイメージが表現される方法はプラットフォームによって異なります。

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

apiVersion: machine.openshift.io/v1beta1
kind: MachineSet
metadata:
  name: ci-ln-hmy310k-72292-5f87z-worker-a
  namespace: openshift-machine-api
spec:
# ...
  template:
# ...
    spec:
# ...
      providerSpec:
         value:
          ami:
            id: ami-0e8fd9094e487d1ff
# ...
Copy to Clipboard Toggle word wrap

重要

ブートイメージ管理を有効にするマシンセットのいずれかが Ignition バージョン 2.2.0 に基づく *-user-data シークレットを使用している場合、この機能を有効にすると、Machine Config Operator によって Ignition バージョンが 3.4.0 に変換されます。OpenShift Container Platform バージョン 4.5 以下では、Ignition バージョン 2.2.0 が使用されます。この変換が失敗すると、MCO またはクラスターのパフォーマンスが低下する可能性があります。oc get ClusterOperator machine-config コマンドの出力に、err: converting ignition stub failed: failed to parse Ignition config を含むエラーメッセージが追加されました。この問題を修正するには、次の一般的な手順を実行します。

  1. ブートイメージ管理機能を無効にします。詳細は、「ブートイメージ管理を無効にする」を参照してください。
  2. Ignition バージョン 3.2.0 を使用するには、*-user-data シークレットを手動で更新します。
  3. ブートイメージ管理機能を有効にします。詳細は、「ブートイメージ管理を有効にする」を参照してください。

6.9.2. ブートイメージ管理を無効にする
リンクのコピー

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

MachineConfiguration オブジェクトを編集することで、クラスターのブートイメージ管理機能を無効化できます。無効化すると、Machine Config Operator (MCO) はクラスター内のブートイメージを管理しなくなり、クラスターの更新ごとにブートイメージを更新しなくなります。

この機能を無効にしても、ノードまたはマシンセットは元々インストールされたブートイメージにロールバックされません。マシンセットは、機能が無効化されたときに存在していたブートイメージバージョンを保持し、今後クラスターが新しい OpenShift Container Platform バージョンにアップグレードされても更新されません。この機能は既存のノードには影響しません。

GCP または AWS クラスターでこの機能を無効化した後、いつでも再有効化できます。詳細は、「更新されたブートイメージの有効化」を参照してください。

手順

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

検証

  • マシン設定オブジェクトを表示して、ブートイメージ管理機能の現在の状態を確認します。 

    $ 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

  • 次のコマンドを実行して、ブートイメージのバージョンを取得します。マシンセット内のブートイメージの場所と形式は、プラットフォームによって異なります。ただし、ブートイメージは常に 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 バージョンと同じです。

6.9.3. ブートイメージ管理を有効にする
リンクのコピー

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

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

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

手順

  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

検証

  • マシン設定オブジェクトを表示して、ブートイメージ管理機能の現在の状態を確認します。 

    $ 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

  • 次のコマンドを実行して、ブートイメージのバージョンを取得します。マシンセット内のブートイメージの場所と形式は、プラットフォームによって異なります。ただし、ブートイメージは常に 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 バージョンと同じです。
トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

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

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

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

会社概要

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

Theme

© 2025 Red Hat