9.17.10.2.3. PCI デバイスの VFIO ドライバーへのバインディング

手順

1. lspci コマンドを実行して、PCI デバイスの vendor-ID および device-ID を取得します。

   $ lspci -nnv | grep -i nvidia

   出力例:

   02:01.0 3D controller [0302]: NVIDIA Corporation GV100GL [Tesla V100 PCIe 32GB] [10de:1eb8] (rev a1)

2. Butane 設定ファイル 100-worker-vfiopci.bu を作成し、PCI デバイスを VFIO ドライバーにバインドします。

   注記

   設定ファイルで指定する Butane のバージョン は、OpenShift Container Platform のバージョンと同じである必要があり、末尾は常に 0 です。たとえば、4.20.0 などです。Butane の詳細は、「Butane を使用したマシン設定の作成」を参照してください。

   以下に例を示します。

   variant: openshift
   version: 4.20.0
   metadata:
     name: 100-worker-vfiopci
     labels:
       machineconfiguration.openshift.io/role: worker
   storage:
     files:
     - path: /etc/modprobe.d/vfio.conf
       mode: 0644
       overwrite: true
       contents:
         inline: |
           options vfio-pci ids=10de:1eb8 

   1

   
     - path: /etc/modules-load.d/vfio-pci.conf 

   2

   
       mode: 0644
       overwrite: true
       contents:
         inline: vfio-pci

   • metadata.labels.machineconfiguration.openshift.io/role: worker は、新しいカーネル引数がワーカーノードにのみ適用されることを指定します。
   • storage.files.contents.inline (パスは /etc/modprobe.d/vfio.conf) は、以前に決定された ベンダー ID 値 (10de) と デバイス ID 値 (1eb8) を指定して、単一のデバイスを VFIO ドライバーにバインドします。複数のデバイスのリストをベンダーおよびデバイス情報とともに追加できます。
   • storage.files.path は、contents.inline が vfio-pci である場合、ワーカーノードに vfio-pci カーネルモジュールをロードするファイルを指定します。

3. Butane を使用して、ワーカーノードに配信される設定を含む MachineConfig オブジェクトファイル (100-worker-vfiopci.yaml) を生成します。

   $ butane 100-worker-vfiopci.bu -o 100-worker-vfiopci.yaml

4. MachineConfig オブジェクトをワーカーノードに適用します。

   $ oc apply -f 100-worker-vfiopci.yaml

5. MachineConfig オブジェクトが追加されていることを確認します。

   $ oc get MachineConfig

   出力例:

   NAME                             GENERATEDBYCONTROLLER                      IGNITIONVERSION  AGE
   00-master                        d3da910bfa9f4b599af4ed7f5ac270d55950a3a1   3.5.0            25h
   00-worker                        d3da910bfa9f4b599af4ed7f5ac270d55950a3a1   3.5.0            25h
   01-master-container-runtime      d3da910bfa9f4b599af4ed7f5ac270d55950a3a1   3.5.0            25h
   01-master-kubelet                d3da910bfa9f4b599af4ed7f5ac270d55950a3a1   3.5.0            25h
   01-worker-container-runtime      d3da910bfa9f4b599af4ed7f5ac270d55950a3a1   3.5.0            25h
   01-worker-kubelet                d3da910bfa9f4b599af4ed7f5ac270d55950a3a1   3.5.0            25h
   100-worker-iommu                                                            3.5.0            30s
   100-worker-vfiopci-configuration                                            3.5.0            30s