You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This page gives an overview of CDI and NRI Plugin support in the GPU Operator.
24
+
25
+
**************************************
26
+
About Container Device Interface (CDI)
27
+
**************************************
26
28
27
29
The `Container Device Interface (CDI) <https://github.com/cncf-tags/container-device-interface/blob/main/SPEC.md>`_
28
30
is an open specification for container runtimes that abstracts what access to a device, such as an NVIDIA GPU, means,
@@ -31,23 +33,22 @@ ensure that a device is available in a container. CDI simplifies adding support
31
33
the specification is applicable to all container runtimes that support CDI.
32
34
33
35
Starting with GPU Operator v25.10.0, CDI is used by default for enabling GPU support in containers running on Kubernetes.
34
-
Specifically, CDI support in container runtimes, e.g. containerd and cri-o, is used to inject GPU(s) into workload
36
+
Specifically, CDI support in container runtimes, like containerd and cri-o, is used to inject GPU(s) into workload
35
37
containers. This differs from prior GPU Operator releases where CDI was used via a CDI-enabled ``nvidia`` runtime class.
36
38
37
39
Use of CDI is transparent to cluster administrators and application developers.
38
40
The benefits of CDI are largely to reduce development and support for runtime-specific
39
41
plugins.
40
42
41
-
********************************
42
-
Enabling CDI During Installation
43
-
********************************
43
+
************
44
+
Enabling CDI
45
+
************
44
46
45
47
CDI is enabled by default during installation in GPU Operator v25.10.0 and later.
46
48
Follow the instructions for installing the Operator with Helm on the :doc:`getting-started` page.
47
49
48
50
CDI is also enabled by default during a Helm upgrade to GPU Operator v25.10.0 and later.
49
51
50
-
*******************************
51
52
Enabling CDI After Installation
52
53
*******************************
53
54
@@ -125,3 +126,79 @@ disable CDI and use the legacy NVIDIA Container Toolkit stack instead with the f
125
126
nvidia.com/gpu.deploy.operator-validator=true \
126
127
nvidia.com/gpu.present=true \
127
128
--overwrite
129
+
130
+
131
+
.. _nri-plugin:
132
+
133
+
**********************************************
134
+
About the Node Resource Interface (NRI) Plugin
135
+
**********************************************
136
+
137
+
Node Resource Interface (NRI) is a standardized interface for plugging in extensions, called NRI Plugins, to OCI-compatible container runtimes like CRI-O and containerd.
138
+
NRI Plugins serve as hooks which intercept pod and container lifecycle events and perform functions including inject devices to a container, topology aware placement strategies, and more.
139
+
For more details on NRI, refer to the `NRI overview <https://github.com/containerd/nri/tree/main?tab=readme-ov-file#background>`_ in the containerd repository.
140
+
141
+
When enabled in the GPU Operator, the NRI Plugin is managed by the NVIDIA Container Toolkit andprovides an alternative to the ``nvidia`` runtime class to provision GPU workload pods.
142
+
It allows the GPU Operator to extend the container runtime behaviour without modifying the container runtime itself.
143
+
This feature also simplifies deployments on platforms like k3s, k0s, or RKE, because the GPU Operator no longer needs you to set values like ``CONTAINERD_CONFIG``, ``CONTAINERD_SOCKET``, or ``RUNTIME_CONFIG_SOURCE`` for the Container Toolkit.
144
+
145
+
***********************
146
+
Enabling the NRI Plugin
147
+
***********************
148
+
149
+
The NRI Plugin requires the following:
150
+
151
+
- CDI to be enabled in the GPU Operator.
152
+
153
+
- CRI-O v1.34.0 or later or containerd v1.7.30, v2.1.x, or v2.2.x.
154
+
If you are not using the latest containerd version, check that both CDI and NRI are enabled in the containerd configuration file before deploying GPU Operator.
155
+
156
+
To enable the NRI Plugin during installation, follow the instructions for installing the Operator with Helm on the :doc:`getting-started` page and include the ``--set cdi.nriPluginEnabled=true`` argument in you Helm command.
157
+
158
+
Enabling the NRI Plugin After Installation
159
+
******************************************
160
+
161
+
#. Enable NRI Plugin by modifying the cluster policy:
0 commit comments