9.5. 通用设备插件配置参考


本节详细介绍了 MicroShift config.yaml 文件中的通用设备插件的配置参数的详细参考。

Expand
表 9.1. GDP 配置字段定义表
参数描述

genericDevicePlugin

MicroShift 配置文件的 genericDevicePlugin 部分定义了 MicroShift GenericDevicePlugin API 实现的可配置参数。此表中的所有参数都是 MicroShift 配置的 genericDevicePlugin 部分中的子部分。

devices

是列出插件要公开的设备定义的子组。每个设备 条目都包含 'name' 和 组列表

devices.groups

列出设备组。组中的设备由通用名称下的一组设备组成。当您从那个池中请求设备时,您可以从不同的定义的路径接收设备。

devices.groups.count

指定此组可同时挂载的次数。如果未指定,则 Count 默认为 1。有可能为 /dev/fuse 设置高计数 1000,因为没有固有的限制,但性能可能根据主机的功能和设备的性质而受到影响。

devices.groups.paths

列出主机设备文件路径。路径可以是 glob 模式,例如 /dev/ttyUSB*,在这种情况下,每个匹配的设备都是可调度的数量时间。此字段使用 usbs 独占;您不能在同一设备组中定义这两个字段。

devices.groups.paths.limit

当组中的其他设备产生更多匹配项时,最多可同时指定组里可以同时使用的次数。例如,如果组中的一个路径匹配 5 个设备,另一个路径匹配 1 设备,但限制为 10,则组提供了 5 对设备。如果未指定,则限制默认为 1

devices.groups.paths.mountPath

主机设备应挂载到容器中的文件路径。如果未指定,mount Path 默认为 path

devices.groups.paths.path

主机上设备的文件路径,例如 /dev/video0/dev/ttyUSB*

devices.groups.paths.permissions

提供给挂载的设备的文件系统权限。仅适用于 类型的设备 的 挂载。可以是一个或多个:

* R- 允许容器从指定的设备读取。

* w - 允许容器写入指定设备。

* M- 允许容器创建尚不存在的设备文件。

如果未指定,权限 默认为 mrw

devices.groups.paths.readOnly

指定路径是否应以只读形式挂载。值为 truefalse。仅适用于挂载类型

devices.groups.path.type

描述此路径所代表的文件系统类型,因此应如何挂载它。类型可以是 DeviceMount。如果未指定,则 键入 默认为 设备

devices.groups.usbs

列出此设备组包含的 USB 规格:供应商和产品 ID 必须始终匹配。如果提供了串行 ID,或者如果 ID 为空,则串行 ID 必须匹配,如果 ID 为空,则 usbs 字段使用 paths 独占。

devices.groups.usbs.product

要匹配的设备的 USB 产品 ID,例如 0x7523

devices.groups.usbs.serial

要匹配的设备的序列号。USB 设备必须与所有给定属性完全匹配。

devices.groups.usbs.vendor

要匹配的设备的 USB 供应商 ID,例如 0x1a86

devices.name

代表此规格类型的设备的唯一字符串,如 串行视频fuse。此名称用于 Pod 资源请求,如 device.microshift.io/serial

domain

domain 是一个子组,用于指定节点上公告和存在哪些设备的域前缀。例如: device.microshift.io/serial。默认值为 device.microshift.io

status

Status 是一个指定默认 GDP 状态的子组。EnabledDisabled 是有效的值。

9.5.1. 配置问题故障排除

如果您遇到错误,如 "invalid configuration: failed to parse device" 或 "cannot 同时定义 path 和 usbs",这意味着您在设备的同一组条目中错误地混合了 路径和 usbs 字段。每个组 必须完全使用 pathsusbs 来定义其设备。

9.5.2. 其他资源

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

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

關於紅帽

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

Theme

© 2026 Red Hat