opensource/podman
1
0
Fork 0
mirror of https://github.com/containers/podman.git synced 2025-05-21 17:16:22 +08:00
Code Issues Packages Projects Releases Wiki Activity

docs: add note to system migrate

Browse Source 
add a note explaining how it can be used to recreate the rootless user
namespace.

Signed-off-by: Giuseppe Scrivano <gscrivan@redhat.com>
This commit is contained in:
Giuseppe Scrivano
2019-06-18 11:06:03 +02:00
parent 8bcfd24397
commit 300025359e
1 changed files with 14 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

15
docs/podman-system-migrate.1.md
View File

@ -11,11 +11,24 @@ podman\-system\-migrate - Migrate container to the latest version of podman
**podman system migrate** takes care of migrating existing containers to the latest version of podman if any change is necessary. **podman system migrate** takes care of migrating existing containers to the latest version of podman if any change is necessary.
"Rootless Podman uses a pause process to keep the unprivileged
namespaces alive. This prevents any change to the `/etc/subuid` and
`/etc/subgid` files from being propagated to the rootless containers
while the pause process is running.
For these changes to be propagated, it is necessary to first stop all
running containers associated with the user and to also stop the pause
process and delete its pid file. Instead of doing it manually, `podman
system migrate` can be used to stop both the running containers and the
pause process. The `/etc/subuid` and `/etc/subgid` files can then be
edited or changed with usermod to recreate the user namespace with the
newly configured mappings.
## SYNOPSIS ## SYNOPSIS
**podman system migrate** **podman system migrate**
## SEE ALSO ## SEE ALSO
`podman(1)`, `libpod.conf(5)` `podman(1)`, `libpod.conf(5)`, `usermod(8)`
## HISTORY ## HISTORY
April 2019, Originally compiled by Giuseppe Scrivano (gscrivan at redhat dot com) April 2019, Originally compiled by Giuseppe Scrivano (gscrivan at redhat dot com)