Merge pull request #14333 from rook/mergify/bp/release-1.14/pr-13876

doc: add recommendation for nfs in external cluster (backport #13876)
2024-06-13 10:25:47 -06:00
commit 622e2000d5
@@ -259,6 +259,10 @@ Consume the S3 Storage, in two different ways:
 If encryption or compression on the wire is needed, specify the `--v2-port-enable` flag.
 If the v2 address type is present in the `ceph quorum_status`, then the output of 'ceph mon data' i.e, `ROOK_EXTERNAL_CEPH_MON_DATA` will use the v2 port(`3300`).

+### NFS storage
+
+Rook suggests a different mechanism for making use of an [NFS service running on the external Ceph standalone cluster](../../../Storage-Configuration/NFS/nfs-csi-driver.md#consuming-nfs-from-an-external-source), if desired.
+
 ## Exporting Rook to another cluster

 If you have multiple K8s clusters running, and want to use the local `rook-ceph` cluster as the central storage,
@@ -206,3 +206,16 @@ To clean your cluster of the resources created by this example, run the followin
 ```console
 kubectl delete -f deploy/examples/csi/nfs/pvc-clone.yaml
 ```
+
+## Consuming NFS from an external source
+
+For consuming NFS services and exports external to the Kubernetes cluster (including those backed by an external standalone Ceph cluster), Rook recommends using Kubernetes regular NFS consumption model. This requires the Ceph admin to create the needed export, while reducing the privileges needed in the client cluster for the NFS volume.
+
+Export and get the nfs client to a particular cephFS filesystem:
+
+```yaml
+ceph nfs export create cephfs <nfs-client-name> /test <filesystem-name>
+ceph nfs export get <service> <export-name>
+```
+
+Create the [PV and PVC](https://github.com/kubernetes/examples/tree/master/staging/volumes/nfs) using `nfs-client-server-ip`. It will mount NFS volumes with PersistentVolumes and then mount the PVCs in the [user Pod Application](https://kubernetes.io/docs/concepts/storage/volumes/#nfs) to utilize the NFS type storage.