9.3. 配置通用设备插件


在 MicroShift 中默认禁用通用设备插件(GDP)。要将串行端口和相机等主机设备公开给 pod,您可以启用 GDP 并在 config.yaml 文件中定义设备,或创建 /etc/microshift/config.d/10-gdp.yaml 等配置片断文件。

先决条件

  • 已安装 MicroShift。
  • 您在 /etc/microshift 目录中创建了自定义 config.yaml 文件。
  • 已安装 OpenShift CLI(oc)。
  • 在 MicroShift 主机上具有 sudo 权限。
  • 您已找出要向 MicroShift 节点公开的特定主机设备。例如: /dev/video0,/dev/ttyUSB*, 或 USB Vendor/Product ID。

流程

  1. 在 CLI 中使用 sudo 权限,在文本编辑器中打开 /etc/microshift/config.yaml。
  2. 找到 genericDevicePlugin 部分。如果不存在,请添加它。
  3. 将 status 参数设置为 Enabled,并定义应公开的 设备。每个设备定义 都需要一个名称和 一个或多个组。每个组都可以使用 路径 (包括文件型设备)指定设备,包括 glob 模式或 usbs,用于使用 Vendor/Product ID 的 USB 设备。您不能在同一设备组中混合 路径和 usbs。

    带有默认值的 GDP 字段

    apiServer:
    # ...
    genericDevicePlugin:
      devices:
      - groups:
        - paths:
          - path: /dev/ttyUSB*
          - path: /dev/ttyACM*
        name: serial
      - groups:
        - paths:
          - path: /dev/fuse
        name: fuse
      - groups:
        - usbs:
          - product: "0x7523"
            serial: ""
            vendor: "0x1a86"
        name: converter
      domain: device.microshift.io
      status: Enabled

    其中:

    /dev/ttyUSB*
    指定此 glob 匹配的所有 USB 串行设备的文件路径。
    /dev/ttyACM*
    指定此 glob 匹配的所有 ACM 串行设备的文件路径。
    /dev/fuse
    指定 fuse 设备的文件路径。
    fuse
    指定设备的名称。
    0x7523
    指定 CH340 串行转换器的产品 ID。
    0x1a86
    指定 CH340 串行转换器的供应商 ID。
    device.microshift.io
    指定 GDP 的默认域。
    重要
    • microshift show-config 参数的输出可能包含串行设备的预配置默认路径,即使您没有在 config.yaml 中明确配置了它们。如果在没有特定用户配置的情况下启用了通用设备插件,则这些路径代表默认的发现设置。
    • 为了实现一致性和精确的设备目标,特别是在处理多个类似设备时,请考虑使用 /dev/serial/by-id/ 或特定 USB 供应商、产品或 Serial ID 而非 /dev/ttyUSB* 等广泛 glob 模式。
    • 设备组中的 count 参数允许单个设备或由 glob 匹配的一组设备,以便同时分配给不同的 pod。如果省略 , 则默认为 1。
  4. 保存 config.yaml 文件。
  5. 重启 MicroShift 服务以应用更改:

    $ sudo systemctl restart microshift

    花一些时间让 MicroShift 重启,并使 GDP 使用 Kubelet 注册其设备。

验证

  • 您可以运行以下命令来检查节点中的可用设备:

    $ oc describe node <microshift_node_name> | grep "device.microshift.io"
  • 根据您的配置,预期输出表示设备现在可以在 MicroShift 节点中发现并可以调度。

    输出示例

    Capacity:
     cpu:                                2
     device.microshift.io/audio:         0
     device.microshift.io/capture:       0
     device.microshift.io/custom-device: 1
     device.microshift.io/dummy-video:   0
     device.microshift.io/fuse:          0
     device.microshift.io/serial:        5
     device.microshift.io/video:         0
    Allocatable:
     cpu:                                2
     device.microshift.io/audio:         0
     device.microshift.io/capture:       0
     device.microshift.io/custom-device: 1
     device.microshift.io/dummy-video:   0
     device.microshift.io/fuse:          0
     device.microshift.io/serial:        5
     device.microshift.io/video:         0
    Allocated resources:
     (Total limits may be over 100 percent, i.e., overcommitted.)
     Resource                           Requests     Limits
     --------                           --------     ------
     cpu                                450m (22%)   500m (25%)
     memory                             1550Mi (42%) 500Mi (13%)
     ephemeral-storage                  0 (0%)       0 (0%)
     hugepages-1Gi                      0 (0%)       0 (0%)
     hugepages-2Mi                      0 (0%)       0 (0%)
     device.microshift.io/audio         0            0
     device.microshift.io/capture       0            0
     device.microshift.io/custom-device 1            1
     device.microshift.io/dummy-video   1            1
     device.microshift.io/fuse          0            0
     device.microshift.io/serial        0            0
     device.microshift.io/video         0            0

Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

关于红帽文档

Legal Notice

Theme

© 2026 Red Hat
返回顶部