spiegel_podman/docs/source
Matthew Heon b53cb57680 Initial implementation of volume plugins
This implements support for mounting and unmounting volumes
backed by volume plugins. Support for actually retrieving
plugins requires a pull request to land in containers.conf and
then that to be vendored, and as such is not yet ready. Given
this, this code is only compile tested. However, the code for
everything past retrieving the plugin has been written - there is
support for creating, removing, mounting, and unmounting volumes,
which should allow full functionality once the c/common PR is
merged.

A major change is the signature of the MountPoint function for
volumes, which now, by necessity, returns an error. Named volumes
managed by a plugin do not have a mountpoint we control; instead,
it is managed entirely by the plugin. As such, we need to cache
the path in the DB, and calls to retrieve it now need to access
the DB (and may fail as such).

Notably absent is support for SELinux relabelling and chowning
these volumes. Given that we don't manage the mountpoint for
these volumes, I am extremely reluctant to try and modify it - we
could easily break the plugin trying to chown or relabel it.

Also, we had no less than *5* separate implementations of
inspecting a volume floating around in pkg/infra/abi and
pkg/api/handlers/libpod. And none of them used volume.Inspect(),
the only correct way of inspecting volumes. Remove them all and
consolidate to using the correct way. Compat API is likely still
doing things the wrong way, but that is an issue for another day.

Fixes #4304

Signed-off-by: Matthew Heon <matthew.heon@pm.me>
2021-01-14 15:35:33 -05:00
..
_static sort api endpoints in documentation 2020-12-24 09:52:01 -06:00
markdown Initial implementation of volume plugins 2021-01-14 15:35:33 -05:00
Commands.rst [CI:DOCS] Touch up Podman description in man page menu 2020-11-13 20:28:52 -05:00
conf.py squash 2020-11-25 18:27:31 +01:00
connection.rst Add missing pages for docs.podman.io 2020-08-10 19:35:23 -04:00
generate.rst Update document formatting and packaging code 2019-10-31 12:31:39 -05:00
healthcheck.rst Update document formatting and packaging code 2019-10-31 12:31:39 -05:00
image.rst Cross-reference *.rst files too 2020-08-11 08:03:37 -06:00
includes.rst Switch all references to github.com/containers/libpod -> podman 2020-07-28 08:23:45 -04:00
index.rst Add missing pages for docs.podman.io 2020-08-10 19:35:23 -04:00
Introduction.rst Fix documentation link and typo 2020-10-09 12:58:16 +03:00
managecontainers.rst squash 2020-11-25 18:27:31 +01:00
manifest.rst Add missing pages for docs.podman.io 2020-08-10 19:35:23 -04:00
network.rst Implement pod-network-reload 2020-12-07 19:26:23 +01:00
play.rst Update document formatting and packaging code 2019-10-31 12:31:39 -05:00
pod.rst Remove containers when pruning a stopped pod. 2019-11-26 13:19:31 -05:00
Reference.rst [CI:DOCS] Docs revamp. 2020-05-21 17:16:10 -04:00
Search.rst [CI:DOCS] Docs revamp. 2020-05-21 17:16:10 -04:00
system.rst Cross-reference *.rst files too 2020-08-11 08:03:37 -06:00
Tutorials.rst squash 2020-11-25 18:27:31 +01:00
volume.rst Enable pre-commit tool linting 2020-01-14 13:42:59 +00:00