9.5. Generic Device Plugin の設定リファレンス

genericDevicePlugin

MicroShift 設定ファイルの genericDevicePlugin セクションでは、MicroShift GenericDevicePlugin API の実装用の設定可能パラメーターを定義します。この表に示される以下のすべてのパラメーターは、MicroShift 設定における genericDevicePlugin セクションのサブセクションです。

devices

プラグインによって公開されるデバイス定義をリストするサブグループです。各 Device エントリーには、'name' と groups のリストが含まれます。

devices.groups

デバイスグループをリスト表示します。グループ内のデバイスは、コモンネームの名前の下にあるデバイスのプールを構成します。そのプールからデバイスを要求すると、定義されたさまざまなパスからデバイスを受け取ることができます。

devices.groups.count

このデバイスグループを同時にマウントできる回数を指定します。指定しない場合、Count はデフォルトで 1 になります。固有の制限がないため、/dev/fuse に 1000 などの高い数値を設定することは可能ですが、ホストの機能とデバイスの性質によってはパフォーマンスが影響を受ける可能性があります。

devices.groups.paths

ホストデバイスのファイルパスをリスト表示します。パスは glob パターンにすることができます (例: /dev/ttyUSB*)。その場合、一致する各デバイスは Count に指定された回数をスケジューリングできます。このフィールドは usbs と排他的であり、同じデバイスグループ内で両方を定義することはできません。

devices.groups.paths.limit

グループ内の他のデバイスがより多くの一致を生成した場合に、このデバイスをグループ内で同時に使用できる最大回数を指定します。たとえば、グループ内の 1 つのパスが 5 台のデバイスと一致し、別のパスが 1 台のデバイスと一致しているが制限が 10 の場合、グループは 5 組のデバイスを提供します。指定しない場合、制限はデフォルトで 1 になります。

devices.groups.paths.mountPath

コンテナー内でホストデバイスをマウントするファイルパス。指定しない場合、mountPath はデフォルトで path になります。

devices.groups.paths.path

ホスト上のデバイスのファイルパス (例: /dev/video0、/dev/ttyUSB*)。

devices.groups.paths.permissions

マウントされたデバイスに付与されたファイルシステムの権限。Device タイプのマウントにのみ適用されます。次の 1 つ以上の項目を指定できます。

* r - コンテナーは指定されたデバイスから読み取ることができます。

* w - コンテナーは指定されたデバイスに書き込むことができます。

* m - コンテナーはまだ存在しないデバイスファイルを作成できます。

指定しない場合、Permissions はデフォルトで mrw に設定されます。

devices.groups.paths.readOnly

パスを読み取り専用でマウントするかどうかを指定します。値は true または false です。Mount タイプのマウントにのみ適用されます。

devices.groups.path.type

この path が表すファイルシステムノードの種類と、それをマウントする方法を記述します。タイプは Device または Mount になります。指定しない場合、type はデフォルトで Device になります。

devices.groups.usbs

このデバイスグループを構成する USB 仕様をリスト表示します。ベンダー 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

この仕様が記述するデバイスの種類を表す一意の文字列 (例: serial、video、fuse)。この名前は、Pod リソースリクエストで使用されます (例: device.microshift.io/serial)。

domain

domain は、デバイスがアドバタイズされ、ノード内で存在するドメイン接頭辞を指定するサブグループです。たとえば、device.microshift.io/serial など。デフォルト値は device.microshift.io です。

status

status は、デフォルトの GDP ステータスを指定するサブグループです。有効な値は Enabled と Disabled です。