Skip to content

Commit 094cd87

Browse files
committed
Documented the AutomountServiceAccountToken device-plugin option.
Following up on 2ff4d63 which added this option to the Module. Signed-off-by: Yoni Bettan <yonibettan@gmail.com>
1 parent 2ff4d63 commit 094cd87

1 file changed

Lines changed: 10 additions & 0 deletions

File tree

docs/mkdocs/documentation/deploy_kmod.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -47,6 +47,16 @@ successful loading. For those devices, the indication is the appearance of the d
4747
For those cases, using an init-container looping over files verification instead of adding that verification to the device-plugin
4848
image is preferable for debuggability and code re-usage reasons.
4949

50+
K8s automatically mounts the SA token and root CAs into the /var/run/secrets/kubernetes.io/serviceaccount of the
51+
device-plugin pods using projected volumes.
52+
As a result, mounting/overriding additional files into that directory is not allowed.
53+
In some cases, users may want to use additional custom CAs or tokens for the device plugin but k8s won't allow mounting
54+
them to the same path unless the auto-mount is disable.
55+
In such cases, the `module.spec.devicePlugin.automountServiceAccountToken` field can be set to false to disable the auto-mounting
56+
into device plugin pod, and allow users to mount what they need for the device plugin application.
57+
!!! note
58+
In this case, it is the user's responsibility to mount the necessary tokens and CAs into the device plugin pods, otherwise the device plugin may not work properly.
59+
5060
## `Module` CRD
5161

5262
The `Module` Custom Resource Definition represents a kernel module that should be loaded on all or select nodes in the

0 commit comments

Comments
 (0)