mirror of
https://github.com/containers/podman.git
synced 2025-05-21 00:56:36 +08:00

Added functionality for users to transfer images from root storage to rootless storage without using sshd. This is done through rootful podman by running `sudo podman image scp root@localhost::image user@localhost:: the user is needed in order to find and use their uid/gid to exec a new process. added necessary tests, and functions for this implementation. Created new image function Transfer so that the underlying code is majorly removed from CLI Signed-off-by: cdoern <cdoern@redhat.com>
86 lines
2.7 KiB
Markdown
86 lines
2.7 KiB
Markdown
% podman-image-scp(1)
|
|
|
|
## NAME
|
|
podman-image-scp - Securely copy an image from one host to another
|
|
|
|
## SYNOPSIS
|
|
**podman image scp** [*options*] *name*[:*tag*]
|
|
|
|
## DESCRIPTION
|
|
**podman image scp** copies container images between hosts on a network. You can load to the remote host or from the remote host as well as in between two remote hosts.
|
|
Note: `::` is used to specify the image name depending on if you are saving or loading. Images can also be transferred from rootful to rootless storage on the same machine without using sshd. This feature is not supported on the remote client.
|
|
|
|
**podman image scp [GLOBAL OPTIONS]**
|
|
|
|
**podman image** *scp [OPTIONS] NAME[:TAG] [HOSTNAME::]*
|
|
|
|
**podman image** *scp [OPTIONS] [HOSTNAME::]IMAGENAME*
|
|
|
|
**podman image** *scp [OPTIONS] [HOSTNAME::]IMAGENAME [HOSTNAME::]*
|
|
|
|
## OPTIONS
|
|
|
|
#### **--quiet**, **-q**
|
|
|
|
Suppress the output
|
|
|
|
#### **--help**, **-h**
|
|
|
|
Print usage statement
|
|
|
|
## EXAMPLES
|
|
|
|
|
|
```
|
|
$ podman image scp alpine
|
|
Loaded image(s): docker.io/library/alpine:latest
|
|
```
|
|
|
|
```
|
|
$ podman image scp alpine Fedora::/home/charliedoern/Documents/alpine
|
|
Getting image source signatures
|
|
Copying blob 72e830a4dff5 done
|
|
Copying config 85f9dc67c7 done
|
|
Writing manifest to image destination
|
|
Storing signatures
|
|
Loaded image(s): docker.io/library/alpine:latest
|
|
```
|
|
|
|
```
|
|
$ podman image scp Fedora::alpine RHEL::
|
|
Loaded image(s): docker.io/library/alpine:latest
|
|
```
|
|
|
|
```
|
|
$ podman image scp charliedoern@192.168.68.126:22/run/user/1000/podman/podman.sock::alpine
|
|
WARN[0000] Unknown connection name given. Please use system connection add to specify the default remote socket location
|
|
Getting image source signatures
|
|
Copying blob 9450ef9feb15 [--------------------------------------] 0.0b / 0.0b
|
|
Copying config 1f97f0559c done
|
|
Writing manifest to image destination
|
|
Storing signatures
|
|
Loaded image(s): docker.io/library/alpine:latest
|
|
```
|
|
|
|
```
|
|
$ sudo podman image scp root@localhost::alpine username@localhost::
|
|
Copying blob e2eb06d8af82 done
|
|
Copying config 696d33ca15 done
|
|
Writing manifest to image destination
|
|
Storing signatures
|
|
Run Directory Obtained: /run/user/1000/
|
|
[Run Root: /var/tmp/containers-user-1000/containers Graph Root: /root/.local/share/containers/storage DB Path: /root/.local/share/containers/storage/libpod/bolt_state.db]
|
|
Getting image source signatures
|
|
Copying blob 5eb901baf107 skipped: already exists
|
|
Copying config 696d33ca15 done
|
|
Writing manifest to image destination
|
|
Storing signatures
|
|
Loaded image(s): docker.io/library/alpine:latest
|
|
```
|
|
|
|
## SEE ALSO
|
|
podman(1), podman-load(1), podman-save(1), podman-remote(1), podman-system-connection-add(1), containers.conf(5), containers-transports(5)
|
|
|
|
## HISTORY
|
|
July 2021, Originally written by Charlie Doern <cdoern@redhat.com>
|