opensource/podman
1
0
Fork 0
mirror of https://github.com/containers/podman.git synced 2025-08-06 03:19:52 +08:00
Code Issues Packages Projects Releases Wiki Activity

add podman volume reload to sync volume plugins

Browse Source 
Libpod requires that all volumes are stored in the libpod db. Because
volume plugins can be created outside of podman, it will not show all
available plugins. This podman volume reload command allows users to
sync the libpod db with their external volume plugins. All new volumes
from the plugin are also created in the libpod db and when a volume from
the db no longer exists it will be removed if possible.

There are some problems:
- naming conflicts, in this case we only use the first volume we found.
  This is not deterministic.
- race conditions, we have no control over the volume plugins. It is
  possible that the volumes changed while we run this command.

Fixes #14207

Signed-off-by: Paul Holzinger <pholzing@redhat.com>
This commit is contained in:
Paul Holzinger
2022-06-23 15:59:58 +02:00
parent 6e8953abfc
commit 2fab7d169b
14 changed files with 268 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files

29
docs/source/markdown/podman-volume-reload.1.md Normal file
View File

@ -0,0 +1,29 @@
% podman-volume-reload(1)
## NAME
podman\-volume\-reload - Reload all volumes from volumes plugins
## SYNOPSIS
**podman volume reload**
## DESCRIPTION
**podman volume reload** checks all configured volume plugins and updates the libpod database with all available volumes.
Existing volumes are also removed from the database when they are no longer present in the plugin.
This command it is best effort and cannot guarantee a perfect state because plugins can be modified from the outside at any time.
Note: This command is not supported with podman-remote.
## EXAMPLES
```
$ podman volume reload
Added:
vol6
Removed:
t3
```
## SEE ALSO
**[podman(1)](podman.1.md)**, **[podman-volume(1)](podman-volume.1.md)**

1
docs/source/markdown/podman-volume.1.md
View File

@ -21,6 +21,7 @@ podman volume is a set of subcommands that manage volumes.
| ls | [podman-volume-ls(1)](podman-volume-ls.1.md) | List all the available volumes. |
| mount | [podman-volume-mount(1)](podman-volume-mount.1.md) | Mount a volume filesystem. |
| prune | [podman-volume-prune(1)](podman-volume-prune.1.md) | Remove all unused volumes. |
| reload | [podman-volume-reload(1)](podman-volume-reload.1.md) | Reload all volumes from volumes plugins. |
| rm | [podman-volume-rm(1)](podman-volume-rm.1.md) | Remove one or more volumes. |
| unmount | [podman-volume-unmount(1)](podman-volume-unmount.1.md) | Unmount a volume. |