Skip to content

Commit

Permalink
Document that Device Plugin feature is Beta (1.10) (#7512)
Browse files Browse the repository at this point in the history
  • Loading branch information
tengqm authored and k8s-ci-robot committed Feb 27, 2018
1 parent cf48480 commit cdf1c13
Show file tree
Hide file tree
Showing 3 changed files with 10 additions and 7 deletions.
7 changes: 4 additions & 3 deletions docs/concepts/cluster-administration/device-plugins.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ title: Device Plugins
description: Use the Kubernetes device plugin framework to implement plugins for GPUs, NICs, FPGAs, InfiniBand, and similar resources that require vendor-specific setup.
---

{% include feature-state-alpha.md %}
{% include feature-state-beta.md %}

{% capture overview %}
Starting in version 1.8, Kubernetes provides a
Expand All @@ -20,8 +20,9 @@ that may require vendor specific initialization and setup.

## Device plugin registration

The device plugins feature is gated by the `DevicePlugins` feature gate and is disabled by default.
When the device plugins feature is enabled, the kubelet exports a `Registration` gRPC service:
The device plugins feature is gated by the `DevicePlugins` feature gate which
is disabled by default before 1.10. When the device plugins feature is enabled,
the kubelet exports a `Registration` gRPC service:

```gRPC
service Registration {
Expand Down
3 changes: 2 additions & 1 deletion docs/reference/feature-gates.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,8 @@ different Kubernetes components.
| `CustomPodDNS` | `false` | Alpha | 1.9 | |
| `CustomResourceValidation` | `false` | Alpha | 1.8 | 1.8 |
| `CustomResourceValidation` | `true` | Beta | 1.9 | |
| `DevicePlugins` | `false` | Alpha | 1.8 | |
| `DevicePlugins` | `false` | Alpha | 1.8 | 1.9 |
| `DevicePlugins` | `true` | Beta | 1.10 | |
| `DynamicKubeletConfig` | `false` | Alpha | 1.4 | |
| `DynamicVolumeProvisioning` | `true` | Alpha | 1.3 | 1.7 |
| `DynamicVolumeProvisioning` | `true` | GA | 1.8 | |
Expand Down
7 changes: 4 additions & 3 deletions docs/tasks/manage-gpus/scheduling-gpus.md
Original file line number Diff line number Diff line change
Expand Up @@ -74,9 +74,10 @@ works on 1.8 and 1.9 as well. It will be deprecated in 1.10 and removed in
**From 1.8 onwards, the recommended way to consume GPUs is to use [device
plugins](/docs/concepts/cluster-administration/device-plugins).**

To enable GPU support through device plugins, a special **alpha** feature gate
`DevicePlugins` has to be set to true across the system:
`--feature-gates="DevicePlugins=true"`.
To enable GPU support through device plugins before 1,10, the `DevicePlugins`
feature gate has to be explicitly set to true across the system:
`--feature-gates="DevicePlugins=true"`. This is no longer required starting
from 1.10.

Then you have to install NVIDIA drivers on the nodes and run an NVIDIA GPU device
plugin ([see below](#deploying-nvidia-gpu-device-plugin)).
Expand Down

0 comments on commit cdf1c13

Please sign in to comment.