Add more detail to cluster volumes docs#43754
Conversation
Signed-off-by: Drew Erny <derny@mirantis.com>
| ## Creating a Docker CSI Plugin | ||
|
|
||
| Most CSI plugins are shipped with configuration specific to Kubernetes. They | ||
| are often provided in the form of Helm charts, and installation information may | ||
| include Kubernetes-specific steps. Docker CSI Plugins use the same binaries as | ||
| those for Kubernetes, but in a different environment and sometimes with | ||
| different configuration. |
There was a problem hiding this comment.
I think we need an example of how to configure a CSI plugin that would otherwise normally have configured that is Kubernetes-specific to run in Docker Swarm.
Can we pick a CSI plugin that's fairly simple, like maybe a CSI plugin for NFS or something non-cloud-specific and use that as an example to help support this improved documentation?
There was a problem hiding this comment.
I think a fork for Docker CSI of this one https://github.com/kubernetes-csi/csi-driver-host-path would make sense for CI
There was a problem hiding this comment.
I'd been hacking on the democratic-csi plugin to come up with these docs.
There was a problem hiding this comment.
Hmm, looking at the project, that might be a nice choice for people to get started with new drivers. If you have anything to try out or where we can help, let us know :)
|
CI failure is unrelated; as discussed we can make further enhancements to this docs later (and also look at integrating docs into docs.docker.com) |
| should be set as such. | ||
| related interfaces that CSI plugins can expose. | ||
|
|
||
| * `docker.csicontroller/1.0` is used for CSI Controller plugins. |
There was a problem hiding this comment.
I think a link directly to the code/definition of the interface would help make this easier as this is namespaced with docker.* .
As someone that is new to moby/moby I am still having a hard time finding my way around things, but as people seem to be willing to spend some time in investigating how to build CSI plugins, it would go a long way to be more specific here :).
| ## Creating a Docker CSI Plugin | ||
|
|
||
| Most CSI plugins are shipped with configuration specific to Kubernetes. They | ||
| are often provided in the form of Helm charts, and installation information may | ||
| include Kubernetes-specific steps. Docker CSI Plugins use the same binaries as | ||
| those for Kubernetes, but in a different environment and sometimes with | ||
| different configuration. |
There was a problem hiding this comment.
I think a fork for Docker CSI of this one https://github.com/kubernetes-csi/csi-driver-host-path would make sense for CI
| ## Creating a Docker CSI Plugin | ||
|
|
||
| Most CSI plugins are shipped with configuration specific to Kubernetes. They | ||
| are often provided in the form of Helm charts, and installation information may | ||
| include Kubernetes-specific steps. Docker CSI Plugins use the same binaries as | ||
| those for Kubernetes, but in a different environment and sometimes with | ||
| different configuration. |
There was a problem hiding this comment.
Hmm, looking at the project, that might be a nice choice for people to get started with new drivers. If you have anything to try out or where we can help, let us know :)
Adds more detail to the existing
docs/cluster_volumes.mddocumentation, explaining in more detail how to create a plugin.