9.18.9.4. 仲介デバイスの作成および公開

手順

1. ワーカーノードを調べて、仲介デバイスの名前セレクターとリソース名の値を特定します。

   1. oc debug コマンドを使用して、ワーカーノードとのデバッグセッションを開始します。以下に例を示します。

      $ oc debug node/node-11.redhat.com

   2. 次のコマンドを実行して、シェルプロセスのルートディレクトリーをホストノードのファイルシステムに変更します。

      # chroot /host

   3. mdev_bus ディレクトリーに移動してその内容を表示します。各サブディレクトリー名は、物理 GPU の PCI アドレスです。以下に例を示します。

      # cd sys/class/mdev_bus && ls

      出力例:

      0000:4b:00.4

   4. 物理デバイスのディレクトリーに移動し、ハードウェアベンダーによって定義されているサポート対象の仲介デバイスタイプをリスト表示します。以下に例を示します。

      # cd 0000:4b:00.4 && ls mdev_supported_types

      出力例:

      nvidia-742  nvidia-744	nvidia-746  nvidia-748	nvidia-750  nvidia-752
      nvidia-743  nvidia-745	nvidia-747  nvidia-749	nvidia-751  nvidia-753

   5. 使用する仲介デバイスタイプを選択し、name ファイルの内容を表示してその名前セレクターの値を特定します。以下に例を示します。

      # cat nvidia-745/name

      出力例:

      NVIDIA A2-2Q

2. 以下のコマンドを実行して、デフォルトのエディターで HyperConverged CR を開きます。

   $ oc edit hyperconverged kubevirt-hyperconverged -n openshift-cnv

3. 設定を更新して仲介デバイスを作成し、公開します。

   1. spec.permittedHostDevices.mediatedDevices スタンザに mdevNameSelector および resourceName 値を追加して、仲介デバイスをクラスターに公開します。resourceName 値は mdevNameSelector 値に基づいていますが、スペースの代わりにアンダースコアを使用します。

      HyperConverged CR の例:

      apiVersion: hco.kubevirt.io/v1
      kind: HyperConverged
      metadata:
        name: kubevirt-hyperconverged
        namespace: openshift-cnv
      spec:
        permittedHostDevices:
          mediatedDevices:
          - mdevNameSelector: NVIDIA A2-2Q
            resourceName: nvidia.com/NVIDIA_A2-2Q
            externalResourceProvider: true
          - mdevNameSelector: NVIDIA A2-4Q
            resourceName: nvidia.com/NVIDIA_A2-4Q
            externalResourceProvider: true
      # ...

      各項目の説明:

      mdevNameSelector

      ホスト上でこの値にマッピングされる仲介デバイスを指定します。

      resourceName

      ノード上で割り当てられる、対応するリソース名を指定します。

      externalResourceProvider

      デバイスが NVIDIA GPU Operator などの外部プロバイダーによって管理されていることを指定します。

4. 変更を保存し、エディターを終了します。