9.17.19.5. 仮想マシンのホットプラグ機能の無効化

手順

1. VirtualMachineClusterInstancetype カスタムリソース (CR) の YAML ファイルを作成します。設定するインスタンスタイプに maxSockets spec を追加します。

   VirtualMachineClusterInstancetype CR の例:

   apiVersion: instancetype.kubevirt.io/v1beta1
   kind: VirtualMachineClusterInstancetype
   metadata:
     name: cx1.mycustom-numa-instance
   spec:
     cpu:
       dedicatedCPUPlacement: true
       isolateEmulatorThread: true
       numa:
         guestMappingPassthrough: {}
       guest: 8
       maxSockets: 8
     memory:
       guest: 16Gi
       hugepages:
         pageSize: 1Gi

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

   spec.cpu.dedicatedCPUPlacement

   仮想マシンインスタンスに専用リソースを割り当てるかどうかを指定します。これを true に設定すると、仮想マシンの仮想 CPU が物理ホストの CPU にピニングされます。これは、スケジューリングの揺らぎを最小限に抑えるために、ハイパフォーマンスワークロードでよく使用されます。

   spec.cpu.isolateEmulatorThread

   QEMU エミュレータースレッドを分離して専用の物理 CPU コアで実行するかどうかを指定します。これは通常 dedicatedCPUPlacement spec と一緒に使用されるパフォーマンス最適化です。

   spec.cpu.numa

   仮想マシンの NUMA トポロジー設定を指定します。

   spec.cpu.numa.guestMappingPassthrough

   仮想マシンの NUMA トポロジーが、基盤となるホストマシンの NUMA トポロジーをそのまま引き継ぐべきであることを指定します。これは、NUMA を考慮し、最適なパフォーマンスを必要とするアプリケーションにとって重要です。

   spec.cpu.guest

   仮想マシンに割り当てる仮想 CPU の合計数を指定します。

   spec.cpu.maxSockets

   仮想マシンの CPU ソケットの許容最大数を指定します。

   spec.memory

   仮想マシンのメモリー設定を指定します。

   spec.memory.guest

   仮想マシンに割り当てるメモリーの合計量を指定します。

   spec.memory.hugepages

   huge page に関連する設定を指定します。

   spec.memory.hugepages.pageSize

   仮想マシンのメモリーに使用する huge page のサイズを指定します。

2. 次のコマンドを実行して、VirtualMachineClusterInstancetype CR を作成します。

   $ oc create -f <filename>.yaml

検証

1. 更新された VirtualMachineClusterInstancetype 設定を使用する仮想マシンを作成します。

2. 次のコマンドを実行して出力を調べ、作成した仮想マシンの設定を確認します。

   $ oc get vmi <vm_name> -o yaml

   出力例

   apiVersion: kubevirt.io/v1
   kind: VirtualMachineInstance
   metadata:
     name: example-vmi
     labels:
       instancetype.kubevirt.io/cluster-instancetype: cx1.example-numa-instance
   spec:
     domain:
       cpu:
         dedicatedCPUPlacement: true
         isolateEmulatorThread: true
         sockets: 8
         cores: 1
         threads: 1
         numa:
           guestMappingPassthrough: {}
         guest: 8
         maxSockets: 8
   # ...

   spec.template.spec.domain.cpu セクションが次のようになっている場合、更新が正常に適用されています。

   • sockets の値がインスタンスタイプの maxSockets および guest の値と一致している。これにより、追加のホットプラグスロットが設定されなくなります。
   • dedicatedCPUPlacement フィールドと isolateEmulatorThread フィールドが存在し、true に設定されている。