Skip to content

Commit 7715646

Browse files
author
Tim Bannister
committed
Tweak wording for Device Plugins concept
1 parent caf587e commit 7715646

File tree

1 file changed

+10
-8
lines changed

1 file changed

+10
-8
lines changed

content/en/docs/concepts/extend-kubernetes/compute-storage-net/device-plugins.md

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -48,12 +48,14 @@ For example, after a device plugin registers `hardware-vendor.example/foo` with
4848
and reports two healthy devices on a node, the node status is updated
4949
to advertise that the node has 2 "Foo" devices installed and available.
5050

51-
Then, users can request devices in a
52-
[Container](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#container-v1-core)
53-
specification as they request other types of resources, with the following limitations:
54-
51+
Then, users can request devices as part of a Pod specification
52+
(see [`container`](/docs/reference/kubernetes-api/workload-resources/pod-v1/#Container)).
53+
Requesting extended resources is similar to how you manage requests and limits for
54+
other resources, with the following differences:
5555
* Extended resources are only supported as integer resources and cannot be overcommitted.
56-
* Devices cannot be shared among Containers.
56+
* Devices cannot be shared between containers.
57+
58+
### Example {#example-pod}
5759

5860
Suppose a Kubernetes cluster is running a device plugin that advertises resource `hardware-vendor.example/foo`
5961
on certain nodes. Here is an example of a pod requesting this resource to run a demo workload:
@@ -174,7 +176,7 @@ a Kubernetes release with a newer device plugin API version, upgrade your device
174176
to support both versions before upgrading these nodes. Taking that approach will
175177
ensure the continuous functioning of the device allocations during the upgrade.
176178

177-
## Monitoring Device Plugin Resources
179+
## Monitoring device plugin resources
178180

179181
{{< feature-state for_k8s_version="v1.15" state="beta" >}}
180182

@@ -310,7 +312,7 @@ DaemonSet, `/var/lib/kubelet/pod-resources` must be mounted as a
310312
Support for the `PodResourcesLister service` requires `KubeletPodResources` [feature gate](/docs/reference/command-line-tools-reference/feature-gates/) to be enabled.
311313
It is enabled by default starting with Kubernetes 1.15 and is v1 since Kubernetes 1.20.
312314

313-
## Device Plugin integration with the Topology Manager
315+
## Device plugin integration with the Topology Manager
314316

315317
{{< feature-state for_k8s_version="v1.18" state="beta" >}}
316318

@@ -357,5 +359,5 @@ Here are some examples of device plugin implementations:
357359

358360
* Learn about [scheduling GPU resources](/docs/tasks/manage-gpus/scheduling-gpus/) using device plugins
359361
* Learn about [advertising extended resources](/docs/tasks/administer-cluster/extended-resource-node/) on a node
360-
* Read about using [hardware acceleration for TLS ingress](https://kubernetes.io/blog/2019/04/24/hardware-accelerated-ssl/tls-termination-in-ingress-controllers-using-kubernetes-device-plugins-and-runtimeclass/) with Kubernetes
361362
* Learn about the [Topology Manager](/docs/tasks/administer-cluster/topology-manager/)
363+
* Read about using [hardware acceleration for TLS ingress](/blog/2019/04/24/hardware-accelerated-ssl/tls-termination-in-ingress-controllers-using-kubernetes-device-plugins-and-runtimeclass/) with Kubernetes

0 commit comments

Comments
 (0)