add multi-node cluster doc for the csi hostpath driver

Denys Kondratenko · Denys Kondratenko · commit 874de40ca7bf · 2023-02-13T22:26:03.000+01:00
diff --git a/site/content/en/docs/handbook/persistent_volumes.md b/site/content/en/docs/handbook/persistent_volumes.md
@@ -51,3 +51,5 @@ In addition, minikube implements a very simple, canonical implementation of dyna
 The default [Storage Provisioner Controller](https://github.com/kubernetes/minikube/blob/master/pkg/storage/storage_provisioner.go) is managed internally, in the minikube codebase, demonstrating how easy it is to plug a custom storage controller into kubernetes as a storage component of the system, and provides pods with dynamically, to test your pod's behaviour when persistent storage is mapped to it.
 
 Note that this is not a CSI based storage provider, rather, it simply declares a PersistentVolume object of type hostpath dynamically when the controller see's that there is an outstanding storage request.
+
+There is also [CSI Hostpath Driver]({{< ref "/docs/tutorials/volume_snapshots_and_csi" >}}) addon that enables dynamic provisioning and supports multi-node clusters as well as snapshots.
diff --git a/site/content/en/docs/tutorials/multi_node.md b/site/content/en/docs/tutorials/multi_node.md
@@ -14,6 +14,10 @@ date: 2019-11-24
 - minikube 1.10.1 or higher
 - kubectl
 
+## Caveat
+
+Default [host-path volume provisioner]({{< ref "/docs/handbook/persistent_volumes" >}}) doesn't support multi-node clusters ([#12360](https://github.com/kubernetes/minikube/issues/12360)). To be able to provision or claim volumes in multi-node clusters, you could use [CSI Hostpath Driver]({{< ref "/docs/tutorials/volume_snapshots_and_csi" >}}) addon.
+
 ## Tutorial
 
 - Start a cluster with 2 nodes in the driver of your choice:
diff --git a/site/content/en/docs/tutorials/volume_snapshots_and_csi.md b/site/content/en/docs/tutorials/volume_snapshots_and_csi.md
@@ -46,6 +46,10 @@ Once both addons are enabled, you can create persistent volumes and snapshots us
 volume snapshots, you can find some example yaml files along with a step-by-step [here](https://kubernetes-csi.github.io/docs/snapshot-restore-feature.html)).
 The driver stores all persistent volumes in the `/var/lib/csi-hostpath-data/` directory of minikube's host.
 
+## Multi-Node Clusters
+
+`csi-hostpath-driver` addon supports [Multi-Node Clusters]({{< ref "/docs/tutorials/multi_node" >}}) volume provisioning. It deploys `DaemonSet` that runs `hostpath` on each node to provision and claim volumes (See [#12360](https://github.com/kubernetes/minikube/issues/12360) for more details).
+
 ## Tutorial
 
 In this tutorial, you use `volumesnapshots` addon(1) and `csi-hostpath-driver` addon(2a).
@@ -65,6 +69,13 @@ minikube addons enable volumesnapshots
 minikube addons enable csi-hostpath-driver
 ```
 
+Optionally you could use it as a default storage class for the dynamic volume claims:
+```shell
+minikube addons disable storage-provisioner
+minikube addons disable default-storageclass
+kubectl patch storageclass csi-hostpath-sc -p '{"metadata": {"annotations":{"storageclass.kubernetes.io/is-default-class":"true"}}}'
+```
+
 <h2 class="step"><span class="fa-stack fa-1x"><i class="fa fa-circle fa-stack-2x"></i><strong class="fa-stack-1x text-primary">3</strong></span>Check volume snapshot class</h2>
 
 When you create the volume snapshot, you have to register [Volume Snapshot Classes](https://kubernetes.io/docs/concepts/storage/volume-snapshot-classes/) to your cluster.
