8.3. クラスター上のイメージモードについて

• マルチアーキテクチャーコンピュートマシンでは、クラスター上のイメージモードはサポートされていません。
• 同じマシン設定プールで複数の MachineOSConfig オブジェクトを使用することはサポートされていません。異なるカスタムレイヤーイメージを使用したいマシン設定プールごとに、個別の MachineOSConfig CR が必要です。
• カスタムレイヤーイメージを使用するマシンセットをスケールアップすると、ノードが 2 回再起動します。1 回目は、ノードがベースイメージを使用して最初に作成されるとき、2 回目はカスタムレイヤーイメージが適用されるときです。

• カスタムレイヤーイメージを持つノードでは、node disruption policy がサポートされません。その結果、次の設定変更によりノードが再起動します。

  • /var または /etc ディレクトリー内の設定ファイルの変更
  • systemd サービスの追加または変更
  • SSH キーの変更
  • ICSP、ITMS、および IDMS オブジェクトからミラーリングルールの削除
  • openshift-config namespace の user-ca-bundle configmap を更新することによる信頼できる CA の変更
• カスタムレイヤーイメージの作成に使用するイメージは、プッシュレジストリー内の領域を占有します。レジストリー内の空き領域に常に注意して、必要に応じてイメージを削除してください。イメージを作成した MachineOSBuild オブジェクトを削除することで、クラスター上のカスタムレイヤーイメージをリポジトリーから自動的に削除できます。レジストリープッシュシークレットによって提供される認証情報は、レジストリーからイメージを削除するパーミッションも付与する必要があることに注意してください。詳細は、「クラスター上のカスタムレイヤーイメージの削除」を参照してください。

関連情報

• クラスター上のイメージモードを使用してカスタムレイヤーイメージを適用する
• クラスター上のカスタムレイヤーイメージの削除
• マシン設定プールの一時停止
• クラスター上のカスタムレイヤーイメージの再ビルド
• クラスター上のカスタムレイヤーイメージを元に戻す
• カスタムレイヤーイメージの変更

• ビルドする Containerfile
• ビルドを関連付けるマシン設定プール
• 最終的なイメージをプッシュおよびプルする場所
• 使用するプッシュシークレットとプルシークレット

前提条件

• リポジトリーからベースオペレーティングシステムイメージをプルするために Machine Config Operator (MCO) が必要とするプルシークレットが openshift-machine-config-operator namespace にある。デフォルトでは、MCO はクラスターのグローバルプルシークレットを使用し、これを openshift-machine-config-operator namespace に同期します。プルシークレットを OpenShift Container Platform グローバルプルシークレットに追加することも、別のプルシークレットを使用することもできます。グローバルプルシークレットの変更は、「グローバルクラスターのプルシークレットの更新」を参照してください。

• MCO が新しいカスタムレイヤーイメージをプッシュするために必要なレジストリーのプッシュシークレットがある。シークレットによって提供される認証情報は、レジストリーからイメージを削除するパーミッションも付与する必要があります。

  注記

  非接続環境では、非接続クラスターがイメージをプッシュするレジストリーにアクセスできることを確認します。イメージのミラーリングはイメージのプルにのみ適用されます。

• ノードがレジストリーから新しいカスタムレイヤーイメージをプルするために必要なプルシークレットがあります。これは、イメージをリポジトリーにプッシュするために使用するシークレットとは異なるシークレットである必要があります。
• Containerfile を設定する方法をよく理解している。Containerfile の作成方法は、このドキュメントの範囲外です。
• オプション: カスタムレイヤーイメージを適用するノード用に、別のマシン設定プールがある。ノード用のカスタムマシン設定プールを持つことの利点の 1 つは、必要に応じて簡単にベースイメージに戻すことができることです。詳細は「クラスター上のレイヤーノードを元に戻す」を参照してください。

関連情報

• グローバルクラスターのプルシークレットの更新
• クラスター上のカスタムレイヤーイメージを元に戻す

前提条件

• MachineOSConfig オブジェクトを作成して、クラスター上のイメージモードを選択している。

手順

• オブジェクトを変更して、関連するカスタムレイヤーイメージを更新します。

  1. MachineOSConfig オブジェクトを編集して、カスタムレイヤーイメージを変更します。次の例では、カスタムレイヤーイメージを使用してインストールされたツリーパッケージがすでにあるノードに、rngd デーモンを追加します。

     apiVersion: machineconfiguration.openshift.io/v1
     kind: MachineOSConfig
     metadata:
       name: layered-image
     spec:
       machineConfigPool:
         name: layered-image
       containerFile:
       - containerfileArch: noarch
         content: |- 

     1

     
           FROM configs AS final
     
           RUN rpm-ostree install rng-tools && \
               systemctl enable rngd && \
               rpm-ostree cleanup -m && \
               ostree container commit
     
           RUN rpm-ostree install tree && \
               ostree container commit
       imageBuilder:
         imageBuilderType: PodImageBuilder
       baseImagePullSecret:
         name: global-pull-secret-copy 

     2

     
       renderedImagePushspec: image-registry.openshift-image-registry.svc:5000/openshift-machine-config-operator/os-images:latest 

     3

     
       renderedImagePushSecret:  

     4

     
         name: new-secret-name

     Copy to Clipboard Toggle word wrap

     1

     オプション: パッケージを追加または削除するなどして、Containerfile を変更します。

     2

     オプション: レジストリーからベースオペレーティングシステムイメージを取得するために必要なシークレットを更新します。

     3

     オプション: 新しくビルドされたカスタムレイヤーイメージのプッシュ先のイメージレジストリーを変更します。

     4

     オプション: 新しくビルドされたカスタムレイヤーイメージをレジストリーにプッシュするために必要なシークレットを更新します。

     変更を保存すると、MCO がノードをドレインし、スケジューリング対象から外して再起動します。再起動後、ノードはクラスターベースの Red Hat Enterprise Linux CoreOS (RHCOS) イメージを使用します。シークレットだけを変更した場合、新しいビルドがトリガーされず、再起動も実行されません。

関連情報

• マシン設定プールの一時停止

前提条件

• MachineOSConfig オブジェクトを作成して、クラスター上のイメージモードを選択している。

手順

• 次のコマンドを使用して、MachineOSConfig オブジェクトを編集し、machineconfiguration.openshift.io/rebuild アノテーションを追加します。

  $ oc edit MachineOSConfig <object_name>

  Copy to Clipboard Toggle word wrap

  MachineOSConfig オブジェクトの例

  apiVersion: machineconfiguration.openshift.io/v1
  kind: MachineOSConfig
  metadata:
    annotations:
      machineconfiguration.openshift.io/current-machine-os-build: layering-c26d4a003432df70ee66c83981144cfa
      machineconfiguration.openshift.io/rebuild: "" 

  1

  
  # ...
    name: layered-image
  # ...

  Copy to Clipboard Toggle word wrap

  1

  このアノテーションを追加すると、カスタムレイヤーイメージの再ビルドがトリガーされます。

検証

• 次のコマンドを使用して、MachineOSBuild オブジェクトがビルドされていることを確認します。

  $ oc get machineosbuild

  Copy to Clipboard Toggle word wrap

  出力例

  NAME                                             PREPARED   BUILDING   SUCCEEDED   INTERRUPTED   FAILED   AGE
  layered-image-d6b929a29c6dbfa8e4007c8069a2fd08   False      True       False       False         False    2m41s 

  1

  Copy to Clipboard Toggle word wrap

  1

  BUILDING 列の True 値は、MachineOSBuild オブジェクトがビルド中であることを示します。

• 次のコマンドを使用して、MachineOSConfig オブジェクトを編集し、MCO が machineconfiguration.openshift.io/rebuild アノテーションを削除したことを確認します。

  $ oc edit MachineOSConfig <object_name>

  Copy to Clipboard Toggle word wrap

  MachineOSConfig オブジェクトの例

  apiVersion: machineconfiguration.openshift.io/v1
  kind: MachineOSConfig
  metadata:
    annotations:
      machineconfiguration.openshift.io/current-machine-os-build: layering-c26d4a003432df70ee66c83981144cfa
  # ...
    name: layered-image
  # ...

  Copy to Clipboard Toggle word wrap

前提条件

• MachineOSConfig オブジェクトを作成して、クラスター上のイメージモードを選択している。
• カスタムマシン設定プール内のノードに MachineOSConfig オブジェクトを適用している。

手順

• 次のコマンドを使用して、ノードからラベルを削除します。

  $ oc label node/<node_name> node-role.kubernetes.io/<mcp_name>-

  Copy to Clipboard Toggle word wrap

  変更を保存すると、MCO がノードをドレインし、スケジューリング対象から外して再起動します。再起動後、ノードはクラスターベースの Red Hat Enterprise Linux CoreOS (RHCOS) イメージを使用します。

検証

• 次のチェックのいずれかを実行することで、カスタムレイヤーイメージが削除されたことを確認します。

  • ワーカーマシン設定プールが以前のマシン設定で更新されていることを確認します。

    $ oc get mcp

    Copy to Clipboard Toggle word wrap

    出力例

    NAME      CONFIG                                              UPDATED   UPDATING   DEGRADED   MACHINECOUNT   READYMACHINECOUNT   UPDATEDMACHINECOUNT   DEGRADEDMACHINECOUNT   AGE
    layered   rendered-layered-e8c8bc1de69777325003e80bc0c04b82   True      False      False      0              0                   0                     0                      4h20m 

    1

    
    master    rendered-master-50d7bc27ee8b9ca2250383f0647ade7f    True      False      False      3              3                   3                     0                      5h39m
    worker    rendered-worker-e8c8bc1de69777325003e80bc0c04b82    True      False      False      3              3                   3                     0                      5h39m 

    2

    Copy to Clipboard Toggle word wrap

    1

    カスタムマシン設定プールにはノードがなくなりました。

    2

    UPDATING フィールドが True の場合、マシン設定プールは以前のマシン設定で更新されます。フィールドが False になると、ワーカーマシン設定プールが以前のマシン設定にロールアウトされます。

  • ノードをチェックして、ノードのスケジューリングが無効になっていることを確認します。これは、変更が適用されていることを示しています。

    $ oc get nodes

    Copy to Clipboard Toggle word wrap

    出力例

    NAME                                         STATUS                     ROLES                  AGE   VERSION
    ip-10-0-148-79.us-west-1.compute.internal    Ready                      worker                 32m   v1.32.3
    ip-10-0-155-125.us-west-1.compute.internal   Ready,SchedulingDisabled   worker                 35m   v1.32.3
    ip-10-0-170-47.us-west-1.compute.internal    Ready                      control-plane,master   42m   v1.32.3
    ip-10-0-174-77.us-west-1.compute.internal    Ready                      control-plane,master   42m   v1.32.3
    ip-10-0-211-49.us-west-1.compute.internal    Ready                      control-plane,master   42m   v1.32.3
    ip-10-0-218-151.us-west-1.compute.internal   Ready                      worker                 31m   v1.32.3

    Copy to Clipboard Toggle word wrap

  • ノードが Ready 状態に戻ったら、ノードが基本イメージを使用していることを確認します。

    1. ノードへの oc debug セッションを開きます。以下に例を示します。

       $ oc debug node/ip-10-0-155-125.us-west-1.compute.internal

       Copy to Clipboard Toggle word wrap

    2. /host をデバッグシェル内のルートディレクトリーとして設定します。

       sh-4.4# chroot /host

       Copy to Clipboard Toggle word wrap

    3. rpm-ostree status コマンドを実行して、ベースイメージが使用中であることを確認します。

       sh-4.4# rpm-ostree status

       Copy to Clipboard Toggle word wrap

       出力例

       State: idle
       Deployments:
       * ostree-unverified-registry:registry.build05.ci.openshift.org/ci-ln-qd0hmqk/stable@sha256:a8bd32573f787f6d1c23e1d669abbefd1e31339826d06e750c0ca632ad6c414f
                          Digest: sha256:a8bd32573f787f6d1c23e1d669abbefd1e31339826d06e750c0ca632ad6c414f
                         Version: 419.96.202501202201-0 (2025-01-20T22:06:13Z)

       Copy to Clipboard Toggle word wrap