This repository houses community-maintained external provisioners plus a helper library for building them. Each provisioner is contained in its own directory so for information on how to use one, enter its directory and read its documentation. The library is contained in the lib
directory.
An external provisioner is a dynamic PV provisioner whose code lives out-of-tree/external to Kubernetes. Unlike in-tree dynamic provisioners that run as part of the Kubernetes controller manager, external ones can be deployed & updated independently.
External provisioners work just like in-tree dynamic PV provisioners. A StorageClass
object can specify an external provisioner instance to be its provisioner
like it can in-tree provisioners. The instance will then watch for PersistentVolumeClaims
that ask for the StorageClass
and automatically create PersistentVolumes
for them. For more information on how dynamic provisioning works, see the docs or this blog post.
import (
"github.com/kubernetes-incubator/external-storage/lib/controller"
)
You need to implement the Provisioner
interface then pass your implementation to a ProvisionController
and run the controller. The controller takes care of deciding when to call your implementation's Provision
or Delete
. The interface and controller are defined in the above package.
You will want to import a specific version of the library to ensure compatibility with certain versions of Kubernetes and to avoid breaking changes. This repo will be tagged according to the library's version (individual provisioners will need to version themselves independently, e.g. by in their documentation pointing to Docker Hub and using Docker tags), so to keep track of releases, go to this repo's releases page.
Note that because your provisioner needs to depend also on client-go and the library itself depends on a specific version of client-go, to avoid a dependency conflict you must ensure you use the exact same version of client-go as the library. You can check what version of client-go the library depends on by looking at its glide.yaml.
February
- Finalize repo structure, release process, etc.
Learn how to engage with the Kubernetes community on the community page.
You can reach the maintainers of this project at:
- Slack: #sig-storage
This is a Kubernetes Incubator project. The project was established 2016-11-15 (as nfs-provisioner). The incubator team for the project is:
- Sponsor: Clayton (@smarterclayton)
- Champion: Jan (@jsafrane) & Brad (@childsb)
- SIG: sig-storage
Participation in the Kubernetes community is governed by the Kubernetes Code of Conduct.