This package provides local path node storage and primarily supports RWO AccessMode.
It utilizes the Kubernetes [Local Persistent Volume feature](https://kubernetes.io/blog/2018/04/13/local-persistent-volumes-beta/)
and in Tanzu Community Edition, it is primarily intended for use with Docker, although it will work with any infrastructure provider
or package where persistent storage is needed.
This package also provides a `StorageClass`.
If there is no `StorageClass` already installed on the cluster,
then the `StorageClass` provided in this package will automatically be made the default.
Otherwise, the [`storageclass.kubernetes.io/is-default-class` may need to be modified.](https://kubernetes.io/docs/tasks/administer-cluster/change-default-storage-class/)
## Limitations
The local-path-storage binds to a single host node
and is not intended to dynamically change hosts.
Therefore, a PVC can _only_ be used by the node that creates it.
This can lead to unintended data loss when scaling or when pods roll from one node to another.
Further, it can make scheduling difficult since applications are "tied" to the node that created it's PV.
Further, local-path-storage does _not_ enforce capacity limitations
and may, possibly overwhelm the local node's disc capacity.
See the [local-path-storage GitHub](https://github.com/rancher/local-path-provisioner)
for further documentation and configuration options.
The end-to-end tests assume that a cluster is running and that the correct version of the package under test is available in a package repository that is already installed to the cluster.