9.12.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. 必要な USB デバイスを HyperConvered CR の permittedHostDevices スタンザに追加します。以下の例では、ベンダー ID 045e および製品 ID 07a5 のデバイスを追加します。

   oc patch hyperconverged kubevirt-hyperconverged \
     -n openshift-cnv \
     --type=merge \
     -p '{
       "metadata": {
         "annotations": {
           "kubevirt.kubevirt.io/jsonpatch": "[{\"op\": \"add\", \"path\": \"/spec/permittedHostDevices/usbHostDevices/-\", \"value\": {\"resourceName\": \"kubevirt.io/peripherals\", \"selectors\": [{\"vendor\": \"045e\", \"product\": \"07a5\"}]}}]"
         }
       }
     }'