diff options
| author | Radostin Stoyanov <rstoyanov@fedoraproject.org> | 2020-12-18 20:07:08 +0000 |
|---|---|---|
| committer | Radostin Stoyanov <rstoyanov@fedoraproject.org> | 2021-01-07 07:51:19 +0000 |
| commit | 288ccc4c84e917df0ff0ee659f47e3ecbc87796a (patch) | |
| tree | 33b3613a7b300a80cf4ced0182e789acfcb54259 /docs | |
| parent | 2b35876c8d03ddc12e8becd2364c39cd621e191d (diff) | |
| download | podman-288ccc4c84e917df0ff0ee659f47e3ecbc87796a.tar.gz podman-288ccc4c84e917df0ff0ee659f47e3ecbc87796a.tar.bz2 podman-288ccc4c84e917df0ff0ee659f47e3ecbc87796a.zip | |
Include named volumes in container migration
When migrating a container with associated volumes, the content of
these volumes should be made available on the destination machine.
This patch enables container checkpoint/restore with named volumes
by including the content of volumes in checkpoint file. On restore,
volumes associated with container are created and their content is
restored.
The --ignore-volumes option is introduced to disable this feature.
Example:
# podman container checkpoint --export checkpoint.tar.gz <container>
The content of all volumes associated with the container are included
in `checkpoint.tar.gz`
# podman container checkpoint --export checkpoint.tar.gz --ignore-volumes <container>
The content of volumes is not included in `checkpoint.tar.gz`. This is
useful, for example, when the checkpoint/restore is performed on the
same machine.
# podman container restore --import checkpoint.tar.gz
The associated volumes will be created and their content will be
restored. Podman will exit with an error if volumes with the same
name already exist on the system or the content of volumes is not
included in checkpoint.tar.gz
# podman container restore --ignore-volumes --import checkpoint.tar.gz
Volumes associated with container must already exist. Podman will not
create them or restore their content.
Signed-off-by: Radostin Stoyanov <rstoyanov@fedoraproject.org>
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/source/markdown/podman-container-checkpoint.1.md | 6 | ||||
| -rw-r--r-- | docs/source/markdown/podman-container-restore.1.md | 7 |
2 files changed, 13 insertions, 0 deletions
diff --git a/docs/source/markdown/podman-container-checkpoint.1.md b/docs/source/markdown/podman-container-checkpoint.1.md index bfda782c5..6a9469156 100644 --- a/docs/source/markdown/podman-container-checkpoint.1.md +++ b/docs/source/markdown/podman-container-checkpoint.1.md @@ -52,6 +52,12 @@ exported to a tar.gz file it is possible with the help of **--ignore-rootfs** to explicitly disable including changes to the root file-system into the checkpoint archive file. +#### **--ignore-volumes** + +This option must be used in combination with the **--export, -e** option. +When this option is specified, the content of volumes associated with +the container will not be included into the checkpoint tar.gz file. + ## EXAMPLE podman container checkpoint mywebserver diff --git a/docs/source/markdown/podman-container-restore.1.md b/docs/source/markdown/podman-container-restore.1.md index 494e7db1e..0593e6fe9 100644 --- a/docs/source/markdown/podman-container-restore.1.md +++ b/docs/source/markdown/podman-container-restore.1.md @@ -85,6 +85,13 @@ exported checkpoint with **--name, -n**. Using **--ignore-static-mac** tells Podman to ignore the MAC address if it was configured with **--mac-address** during container creation. + +#### **--ignore-volumes** + +This option must be used in combination with the **--import, -i** option. +When restoring containers from a checkpoint tar.gz file with this option, +the content of associated volumes will not be restored. + ## EXAMPLE podman container restore mywebserver |