タイプ: gpu

GPU デバイスは、指定の GPU デバイスをインスタンス内に出現させます。

注釈

コンテナでは、gpu デバイスは同時に複数の GPU にマッチングさせることができます。 VM では、各デバイスは1つの GPU にしかマッチできません。

以下のタイプの GPU が gputype デバイスオプションを使って追加できます:

  • physical(コンテナと VM): GPU 全体をインスタンスにパススルーします。 gputype が指定されない場合これがデフォルトです。

  • mdev(VM のみ): 仮想 GPU を作成しインスタンスにパススルーします。

  • mig(コンテナのみ): MIG(Multi-Instance GPU)を作成しインスタンスにパススルーします。

  • sriov(VM のみ): SR-IOV を有効にした GPU の仮想ファンクション(virtual function)をインスタンスに与えます。

利用可能なデバイスオプションは GPU タイプごとに異なり、以下のセクションの表に一覧表示されます。

gputype: physical

注釈

physical GPU タイプはコンテナと VM の両方でサポートされます。 ホットプラグはコンテナのみでサポートし、VM ではサポートしません。

physical GPU デバイスは GPU 全体をインスタンスにパススルーします。

デバイスオプション

physical タイプのデバイスには以下のデバイスオプションがあります:

gid

インスタンス(コンテナのみ)内のデバイス所有者のGID

Key: gid
Type:

int

Default:

0

Required:

no

id

GPUデバイスのDRMカードID

Key: id
Type:

string

Required:

no

mode

インスタンス(コンテナのみ)内のデバイスのモード

Key: mode
Type:

int

Default:

0660

Required:

no

pci

GPUデバイスのPCIアドレス

Key: pci
Type:

string

Required:

no

productid

GPUデバイスのプロダクトID

Key: productid
Type:

string

Required:

no

uid

インスタンス(コンテナのみ)内のデバイス所有者のUID

Key: uid
Type:

int

Default:

0

Required:

no

vendorid

GPUデバイスのベンダーID

Key: vendorid
Type:

string

Required:

no

gputype: mdev

注釈

mdev GPU タイプは VM でのみサポートされます。 ホットプラグはサポートしていません。

mdev GPU デバイスは仮想 GPU を作成しインスタンスにパススルーします。 利用可能なmdevプロファイルの一覧は incus info --resources を実行すると確認できます。

デバイスオプション

mdev タイプのデバイスには以下のデバイスオプションがあります:

id

GPUデバイスのDRMカードID

Key: id
Type:

string

Required:

no

mdev

使用するmdevプロファイル(必須 - 例:i915-GVTg_V5_4

Key: mdev
Type:

string

Required:

yes

productid

GPUデバイスのプロダクトID

Key: productid
Type:

string

Required:

no

vendorid

GPUデバイスのベンダーID

Key: vendorid
Type:

string

Required:

no

gputype: mig

注釈

mig GPU タイプはコンテナでのみサポートされます。 ホットプラグはサポートしていません。

mig GPU デバイスは MIG コンピュートインスタンスを作成しインスタンスにパススルーします。 現状これは NVIDIA MIG を事前に作成しておく必要があります。

デバイスオプション

mig タイプのデバイスには以下のデバイスオプションがあります:

id

GPUデバイスのDRMカードID

Key: id
Type:

string

Required:

no

mig.ci

既存のMIGコンピュートインスタンスID

Key: mig.ci
Type:

int

Required:

no

mig.gi

既存のMIG GPUインスタンスID

Key: mig.gi
Type:

int

Required:

no

mig.uuid

既存のMIGデバイスUUID(MIG-接頭辞は省略可)

Key: mig.uuid
Type:

string

Required:

no

pci

GPUデバイスのPCIアドレス

Key: pci
Type:

string

Required:

no

productid

GPUデバイスのプロダクトID

Key: productid
Type:

string

Required:

no

vendorid

GPUデバイスのベンダーID

Key: vendorid
Type:

string

Required:

no

mig.uuid(NVIDIA drivers 470+)か、mig.cimig.gi(古い NVIDIA ドライバー)の両方を設定する必要があります。

gputype: sriov

注釈

sriov GPU タイプは VM でのみサポートされます。 ホットプラグはサポートしていません。

sriov GPU デバイスは SR-IOV が有効な GPU の仮想ファンクション(virtual function)をインスタンスにパススルーします。

デバイスオプション

sriovタイプのデバイスには以下のデバイスオプションがあります:

id

GPUデバイスのDRMカードID

Key: id
Type:

string

Required:

no

pci

親GPUデバイスのPCIアドレス

Key: pci
Type:

string

Required:

no

productid

親GPUデバイスのプロダクトID

Key: productid
Type:

string

Required:

no

vendorid

親GPUデバイスのベンダーID

Key: vendorid
Type:

string

Required:

no