From 5df2a23f43cf1314e935a81bfc6cbcc27e29baef Mon Sep 17 00:00:00 2001 From: Praveen M Date: Thu, 2 Nov 2023 13:40:37 +0530 Subject: [PATCH] doc: updated doc for subvolumegroup creation Signed-off-by: Praveen M --- PendingReleaseNotes.md | 3 +++ deploy/csi-config-map-sample.yaml | 1 + docs/deploy-cephfs.md | 6 ++++++ 3 files changed, 10 insertions(+) diff --git a/PendingReleaseNotes.md b/PendingReleaseNotes.md index 3ee8d31d7..5b1be3f9f 100644 --- a/PendingReleaseNotes.md +++ b/PendingReleaseNotes.md @@ -3,6 +3,9 @@ ## Breaking Changes - Removed the deprecated grpc metrics flag's in [PR](https://github.com/ceph/ceph-csi/pull/4225) + +- Support for pre-creation of cephFS subvolumegroup before creating subvolume + is removed in [PR](https://github.com/ceph/ceph-csi/pull/4195) ## Features diff --git a/deploy/csi-config-map-sample.yaml b/deploy/csi-config-map-sample.yaml index 7f8653a58..1766d3227 100644 --- a/deploy/csi-config-map-sample.yaml +++ b/deploy/csi-config-map-sample.yaml @@ -20,6 +20,7 @@ kind: ConfigMap # NOTE: Make sure you don't add radosNamespace option to a currently in use # configuration as it will cause issues. # The field "cephFS.subvolumeGroup" is optional and defaults to "csi". +# NOTE: The given subvolumeGroup must already exist in the filesystem. # The "cephFS.netNamespaceFilePath" fields are the various network namespace # path for the Ceph cluster identified by the , This will be used # by the CephFS CSI plugin to execute the mount -t in the diff --git a/docs/deploy-cephfs.md b/docs/deploy-cephfs.md index ccdf70621..8428993ad 100644 --- a/docs/deploy-cephfs.md +++ b/docs/deploy-cephfs.md @@ -239,3 +239,9 @@ However, not all KMS are supported in order to be compatible with [fscrypt](https://github.com/google/fscrypt). In general KMS that either store secrets to use directly (Vault), or allow access to the plain password (Kubernetes Secrets) work. + +## CephFS PVC Provisioning + +Requires subvolumegroup to be created before provisioning the PVC. +If the subvolumegroup provided in `ceph-csi-config` ConfigMap is missing +in the ceph cluster, the PVC creation will fail and will stay in `Pending` state.