9.17.12. USB ホストパススルーの設定

手順

1. HostDevices フィーチャーゲートが有効になっていることを確認します。

   $ oc get featuregate cluster -o yaml

   正常な出力

     featureGates:
   # ...
       enabled:
       - name: HostDevices

2. USB デバイスのベンダーと製品を特定します。

   $ lsusb

   出力例

   Bus 003 Device 007: ID 1b1c:0a60 example_manufacturer example_product_name

   • lsusb コマンドを使用できない場合は、ホストの /sys/bus/usb/devices/ ディレクトリーにある USB デバイス設定を調べます。

     for dev in *; do
         if [[ -f "$dev/idVendor" && -f "$dev/idProduct" ]]; then
             echo "Device: $dev"
             echo -n "  Manufacturer : "; cat "$dev/manufacturer"
             echo -n "  Product: "; cat "$dev/product"
             echo -n "  Vendor ID : "; cat "$dev/idVendor"
             echo -n "  Product ID: "; cat "$dev/idProduct"
             echo
         fi
     done

     出力例

     Device: 3-7
       Manufacturer : example_manufacturer
       Product: example_product_name
       Vendor ID : 1b1c
       Product ID: 0a60

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

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

4. 必要な USB デバイスを HyperConvered CR の permittedHostDevices スタンザに追加します。次の例では、ベンダー ID 045e と製品 ID 07a5 を持つデバイスを追加します。

   apiVersion: hco.kubevirt.io/v1beta1
   kind: HyperConverged
   metadata:
     name: kubevirt-hyperconverged
     namespace: openshift-cnv
   spec:
     permittedHostDevices:
       usbHostDevices:
       - resourceName: kubevirt.io/peripherals
         selectors:
         - vendor: "045e"
           product: "07a5"
         - vendor: "062a"
           product: "4102"
         - vendor: "072f"
           product: "b100"

   • spec.permittedHostDevices は、クラスター内で使用することが許可されているホストデバイスを定義します。
   • spec.permittedHostDevices.usbHostDevices は、使用可能な USB デバイスのリストを定義します。
   • spec.permittedHostDevices.usbHostDevices.resourceName は、仮想マシンに追加して割り当てる USB デバイスを定義します。この例では、リソースは 3 つのデバイスにバインドされており、各デバイスは vendor と product で識別され、selector と呼ばれます。