Skip to content

Commit bbc8680

Browse files
committed
csi: add nodeExpandSecret KEP details
Ref# KEP: kubernetes/enhancements#3173 Implementation: kubernetes/kubernetes#105963 Blog: kubernetes#33979 Signed-off-by: Humble Chirammal <[email protected]>
1 parent b61dfcd commit bbc8680

File tree

2 files changed

+19
-5
lines changed

2 files changed

+19
-5
lines changed

content/en/docs/concepts/storage/volumes.md

Lines changed: 17 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1218,16 +1218,28 @@ persistent volume:
12181218
`ControllerPublishVolume` and `ControllerUnpublishVolume` calls. This field is
12191219
optional, and may be empty if no secret is required. If the Secret
12201220
contains more than one secret, all secrets are passed.
1221-
* `nodeStageSecretRef`: A reference to the secret object containing
1222-
sensitive information to pass to the CSI driver to complete the CSI
1223-
`NodeStageVolume` call. This field is optional, and may be empty if no secret
1224-
is required. If the Secret contains more than one secret, all secrets
1225-
are passed.
1221+
`nodeExpandSecretRef`: A reference to the secret containing sensitive
1222+
information to pass to the CSI driver to complete the CSI
1223+
`NodeExpandVolume` call. This field is optional, and may be empty if no
1224+
secret is required. If the object contains more than one secret, all
1225+
secrets are passed. When you have configured secret data for node-initiated
1226+
volume expansion, the kubelet passes that data via the `NodeExpandVolume()`
1227+
call to the CSI driver. In order to use the `nodeExpandSecretRef` field, your
1228+
cluster should be running Kubernetes version 1.25 or later and you must enable
1229+
the [feature gate](https://kubernetes.io/docs/reference/command-line-tools-reference/feature-gates/)
1230+
named `CSINodeExpandSecret` for each kube-apiserver and for the kubelet on every
1231+
node. You must also be using a CSI driver that supports or requires secret data during
1232+
node-initiated storage resize operations.
12261233
* `nodePublishSecretRef`: A reference to the secret object containing
12271234
sensitive information to pass to the CSI driver to complete the CSI
12281235
`NodePublishVolume` call. This field is optional, and may be empty if no
12291236
secret is required. If the secret object contains more than one secret, all
12301237
secrets are passed.
1238+
* `nodeStageSecretRef`: A reference to the secret object containing
1239+
sensitive information to pass to the CSI driver to complete the CSI
1240+
`NodeStageVolume` call. This field is optional, and may be empty if no secret
1241+
is required. If the Secret contains more than one secret, all secrets
1242+
are passed.
12311243

12321244
#### CSI raw block volume support
12331245

content/en/docs/reference/command-line-tools-reference/feature-gates.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -86,6 +86,7 @@ different Kubernetes components.
8686
| `CSIMigrationvSphere` | `false` | Beta | 1.19 | |
8787
| `CSIMigrationPortworx` | `false` | Alpha | 1.23 | |
8888
| `csiMigrationRBD` | `false` | Alpha | 1.23 | |
89+
| `CSINodeExpandSecret` | `false` | Alpha | 1.25 | |
8990
| `CSIVolumeHealth` | `false` | Alpha | 1.21 | |
9091
| `ContextualLogging` | `false` | Alpha | 1.24 | |
9192
| `CustomCPUCFSQuotaPeriod` | `false` | Alpha | 1.12 | |
@@ -761,6 +762,7 @@ Each feature gate is designed for enabling/disabling a specific feature:
761762
from the Portworx in-tree plugin to Portworx CSI plugin.
762763
Requires Portworx CSI driver to be installed and configured in the cluster.
763764
- `CSINodeInfo`: Enable all logic related to the CSINodeInfo API object in `csi.storage.k8s.io`.
765+
- `CSINodeExpandSecret`: Enable SecretRef to be passed to CSI driver for NodeExpandVolume CSI operation.
764766
- `CSIPersistentVolume`: Enable discovering and mounting volumes provisioned through a
765767
[CSI (Container Storage Interface)](https://git.k8s.io/design-proposals-archive/storage/container-storage-interface.md)
766768
compatible volume plugin.

0 commit comments

Comments
 (0)