mirror of
https://github.com/containers/podman.git
synced 2025-11-04 08:56:05 +08:00
86 lines
2.8 KiB
Markdown
86 lines
2.8 KiB
Markdown
% podman-container-checkpoint(1)
|
|
|
|
## NAME
|
|
podman\-container\-checkpoint - Checkpoints one or more running containers
|
|
|
|
## SYNOPSIS
|
|
**podman container checkpoint** [*options*] *container* ...
|
|
|
|
## DESCRIPTION
|
|
Checkpoints all the processes in one or more containers. You may use container IDs or names as input.
|
|
|
|
## OPTIONS
|
|
#### **--keep**, **-k**
|
|
|
|
Keep all temporary log and statistics files created by CRIU during checkpointing. These files
|
|
are not deleted if checkpointing fails for further debugging. If checkpointing succeeds these
|
|
files are theoretically not needed, but if these files are needed Podman can keep the files
|
|
for further analysis.
|
|
|
|
#### **--all**, **-a**
|
|
|
|
Checkpoint all running containers.
|
|
|
|
#### **--latest**, **-l**
|
|
|
|
Instead of providing the container name or ID, checkpoint the last created container.
|
|
|
|
The latest option is not supported on the remote client.
|
|
|
|
#### **--leave-running**, **-R**
|
|
|
|
Leave the container running after checkpointing instead of stopping it.
|
|
|
|
#### **--tcp-established**
|
|
|
|
Checkpoint a container with established TCP connections. If the checkpoint
|
|
image contains established TCP connections, this options is required during
|
|
restore. Defaults to not checkpointing containers with established TCP
|
|
connections.
|
|
|
|
#### **--export**, **-e**
|
|
|
|
Export the checkpoint to a tar.gz file. The exported checkpoint can be used
|
|
to import the container on another system and thus enabling container live
|
|
migration. This checkpoint archive also includes all changes to the container's
|
|
root file-system, if not explicitly disabled using **--ignore-rootfs**
|
|
|
|
#### **--ignore-rootfs**
|
|
|
|
This only works in combination with **--export, -e**. If a checkpoint is
|
|
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.
|
|
|
|
#### **--pre-checkpoint**, **-P**
|
|
|
|
Dump the container's memory information only, leaving the container running. Later
|
|
operations will supersede prior dumps. It only works on runc 1.0-rc3 or higher.
|
|
|
|
#### **--with-previous**
|
|
|
|
Check out the container with previous criu image files in pre-dump. It only works
|
|
without **--pre-checkpoint** or **-P**. It only works on runc 1.0-rc3 or higher.
|
|
|
|
## EXAMPLE
|
|
|
|
podman container checkpoint mywebserver
|
|
|
|
podman container checkpoint 860a4b23
|
|
|
|
podman container checkpoint -P -e pre-checkpoint.tar.gz -l
|
|
|
|
podman container checkpoint --with-previous -e checkpoint.tar.gz -l
|
|
|
|
## SEE ALSO
|
|
podman(1), podman-container-restore(1)
|
|
|
|
## HISTORY
|
|
September 2018, Originally compiled by Adrian Reber <areber@redhat.com>
|