7.3. クラスター上でのレイヤー化を使用してカスタムレイヤーイメージを適用する

手順

1. machineOSconfig オブジェクトを作成します。

   1. 以下のような YAML ファイルを作成します。

      apiVersion: machineconfiguration.openshift.io/v1alpha1
      kind: MachineOSConfig
      metadata:
        name: layered
      spec:
        machineConfigPool:
          name: <mcp_name> 

      1

      
        buildInputs:
          containerFile: 

      2

      
          - containerfileArch: noarch 

      3

      
            content: |-
              FROM configs AS final 

      4

      
              RUN rpm-ostree install tree && \
                  ostree container commit
          imageBuilder: 

      5

      
            imageBuilderType: PodImageBuilder
          baseImagePullSecret: 

      6

      
            name: global-pull-secret-copy
          renderedImagePushspec: image-registry.openshift-image-registry.svc:5000/openshift/os-image:latest  

      7

      
          renderedImagePushSecret: 

      8

      
            name: builder-dockercfg-7lzwl
        buildOutputs: 

      9

      
          currentImagePullSecret:
            name: builder-dockercfg-mtcl23

      1

      カスタムレイヤーイメージをデプロイするためのマシン設定プールを指定します。

      2

      カスタムレイヤーイメージを設定するための Containerfile を指定します。Containerfile では、複数のビルドステージを指定できます。

      3

      ビルドするイメージのアーキテクチャーを指定します。このパラメーターを noarch に設定する必要があります。

      4

      ビルドステージを final として指定します。このフィールドは必須で、ビルドの最後のイメージに適用されます。

      5

      使用する Image Builder の名前を指定します。このパラメーターを PodImageBuilder に設定する必要があります。

      6

      MCO がレジストリーからベースオペレーティングシステムイメージをプルするために必要なプルシークレットの名前を指定します。

      7

      新しくビルドされたカスタムレイヤーイメージをプッシュするイメージレジストリーを指定します。これは、クラスターがアクセスできる任意のレジストリーにすることができます。この例では、内部 OpenShift Container Platform レジストリーを使用します。

      8

      新しくビルドされたカスタムレイヤーイメージを、そのレジストリーにプッシュするために MCO が必要とするプッシュシークレットの名前を指定します。

      9

      新しくビルドされたカスタムレイヤーイメージをプルするためにノードが必要とするイメージレジストリーに必要なシークレットを指定します。これは、イメージをリポジトリーにプッシュするために使用するシークレットとは異なるシークレットである必要があります。

   2. MachineOSConfig オブジェクトを作成します。

      $ oc create -f <file_name>.yaml

2. MachineOSBuild オブジェクトが作成されて READY 状態になったら、必要に応じて、新しいカスタムレイヤーイメージを使用するノードのノード仕様を変更します。

   1. MachineOSBuild オブジェクトが READY であることを確認します。SUCCEEDED 値が True になったら、ビルドは完了です。

      $ oc get machineosbuild

      MachineOSBuild オブジェクトが準備完了状態であることを示す出力例

      NAME                                                                PREPARED   BUILDING   SUCCEEDED   INTERRUPTED   FAILED
      layered-rendered-layered-ad5a3cad36303c363cf458ab0524e7c0-builder   False      False      True        False         False

   2. MachineOSConfig オブジェクトで指定したマシン設定プールのラベルを追加して、カスタムレイヤーイメージをデプロイするノードを編集します。

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

      ここでは、以下のようになります。

      node-role.kubernetes.io/<mcp_name>=

      カスタムレイヤーイメージをデプロイするノードを特定するノードセレクターを指定します。

      変更を保存すると、MCO がノードをドレインし、スケジューリング対象から外して再起動します。再起動後、ノードは新しいカスタムレイヤーイメージを使用します。

検証

1. 次のコマンドを実行して、新しい Pod の準備ができていることを確認します。

   $ oc get pods -n openshift-machine-config-operator

   出力例

   NAME                                                              READY   STATUS    RESTARTS   AGE
   build-rendered-layered-ad5a3cad36303c363cf458ab0524e7c0           2/2     Running   0          2m40s 

   1

   
   # ...
   machine-os-builder-6fb66cfb99-zcpvq                               1/1     Running   0          2m42s 

   2

   1

   これは、カスタムレイヤーイメージがビルドされるビルド Pod です。

   2

   この Pod はトラブルシューティングに使用できます。

2. 次のコマンドを実行して、レイヤービルドの現在のステージを確認します。

   $ oc get machineosbuilds

   出力例

   NAME                                                                PREPARED   BUILDING   SUCCEEDED   INTERRUPTED   FAILED
   layered-rendered-layered-ef6460613affe503b530047a11b28710-builder   False      True       False       False         False

3. 次のコマンドを実行して、MachineOSBuild オブジェクトに新しいカスタムレイヤーイメージへの参照が含まれていることを確認します。

   $ oc describe machineosbuild <object_name>

   出力例

   apiVersion: machineconfiguration.openshift.io/v1alpha1
   kind: MachineOSBuild
   metadata:
     name: layered-rendered-layered-ad5a3cad36303c363cf458ab0524e7c0-builder
   spec:
     desiredConfig:
       name: rendered-layered-ad5a3cad36303c363cf458ab0524e7c0
     machineOSConfig:
       name: layered
     renderedImagePushspec: image-registry.openshift-image-registry.svc:5000/openshift-machine-config-operator/os-image:latest
   # ...
   status:
     conditions:
       - lastTransitionTime: "2024-05-21T20:25:06Z"
         message: Build Ready
         reason: Ready
         status: "True"
         type: Succeeded
     finalImagePullspec: image-registry.openshift-image-registry.svc:5000/openshift-machine-config-operator/os-image@sha256:f636fa5b504e92e6faa22ecd71a60b089dab72200f3d130c68dfec07148d11cd 

   1

   1

   新しいカスタムレイヤーイメージのダイジェスト付きイメージプル仕様。

4. 適切なノードが新しいカスタムレイヤーイメージを使用していることを確認します。

   1. コントロールプレーンノードの root としてデバッグセッションを開始します。

      $ oc debug node/<node_name>

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

      sh-4.4# chroot /host

   3. rpm-ostree status コマンドを実行して、カスタムレイヤーイメージが使用されていることを確認します。

      sh-5.1# rpm-ostree status

      出力例

      # ...
      Deployments:
      * ostree-unverified-registry:quay.io/openshift-release-dev/os-image@sha256:f636fa5b504e92e6faa22ecd71a60b089dab72200f3d130c68dfec07148d11cd 

      1

      
                         Digest: sha256:bcea2546295b2a55e0a9bf6dd4789433a9867e378661093b6fdee0031ed1e8a4
                        Version: 416.94.202405141654-0 (2024-05-14T16:58:43Z)

      1

      新しいカスタムレイヤーイメージのダイジェスト付きイメージプル仕様。