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

Merge pull request #10752 from vrothberg/fix-10730

Browse Source 
[CI:DOCS] push/pull docs: clarify supported transports
This commit is contained in:
OpenShift Merge Robot
2021-06-23 13:01:30 -04:00
committed by GitHub
parent 510509bafc 525cb54e14
commit e1f700c5d1
2 changed files with 36 additions and 55 deletions
Download Patch File Download Diff File Expand all files Collapse all files

48
docs/source/markdown/podman-pull.1.md
View File

@ -21,42 +21,30 @@ Images are stored in local image storage.
## SOURCE ## SOURCE
The SOURCE is the location from which the container images are pulled. SOURCE is the location from the container image is pulled from. It supports all transports from `containers-transports(5)`. If no transport is specified, the input is subject to short-name resolution and the `docker` (i.e., container registry) transport is used. For remote clients, `docker` is the only supported transport.
The Image "SOURCE" uses a "transport":"details" format. Only the `docker` (container registry)
transport is allowed for remote access.
Multiple transports are supported: ```
# Pull from a container registry
$ podman pull quay.io/username/myimage
**dir:**_path_ # Pull from a container registry with short-name resolution
An existing local directory _path_ storing the manifest, layer tarballs and signatures as individual files. This $ podman pull fedora
is a non-standardized format, primarily useful for debugging or noninvasive container inspection.
$ podman pull dir:/tmp/myimage # Pull from a container registry via the docker transport
$ podman pull docker://quay.io/username/myimage
**docker://**_docker-reference_ (Default) # Pull from a local directory
An image reference stored in a remote container image registry. The reference can include a path to a $ podman pull dir:/tmp/myimage
specific registry; if it does not, the registries listed in registries.conf will be queried to find a matching
image. By default, credentials from podman login (stored at $XDG_RUNTIME_DIR/containers/auth.json by default)
will be used to authenticate; if these cannot be found, we will fall back to using credentials in
$HOME/.docker/config.json.
$ podman pull quay.io/username/myimage # Pull from a tarball in the docker-archive format
$ podman pull docker-archive:/tmp/myimage
**docker-archive:**_path_[**:**_docker-reference_] # Pull from a local docker daemon
An image is stored in the `docker save` formatted file. _docker-reference_ is only used when creating such a $ sudo podman pull docker-daemon:docker.io/library/myimage:33
file, and it must not contain a digest.
$ podman pull docker-archive:/tmp/myimage # Pull from a tarball in the OCI-archive format
$ podman pull oci-archive:/tmp/myimage
**docker-daemon:**_docker-reference_ ```
An image in _docker-reference_ format stored in the docker daemon internal storage. The _docker-reference_ can also be an image ID (docker-daemon:algo:digest).
$ sudo podman pull docker-daemon:docker.io/library/myimage:33
**oci-archive:**_path_**:**_tag_
An image _tag_ in a directory compliant with "Open Container Image Layout Specification" at _path_.
$ podman pull oci-archive:/tmp/myimage
## OPTIONS ## OPTIONS
@ -217,7 +205,7 @@ registries.conf is the configuration file which specifies which container regist
NOTE: Use the environment variable `TMPDIR` to change the temporary storage location of downloaded container images. Podman defaults to use `/var/tmp`. NOTE: Use the environment variable `TMPDIR` to change the temporary storage location of downloaded container images. Podman defaults to use `/var/tmp`.
## SEE ALSO ## SEE ALSO
podman(1), podman-push(1), podman-login(1), containers-certs.d(5), containers-registries.conf(5) podman(1), podman-push(1), podman-login(1), containers-certs.d(5), containers-registries.conf(5), containers-transports(5)
## HISTORY ## HISTORY
July 2017, Originally compiled by Urvashi Mohnani <umohnani@redhat.com> July 2017, Originally compiled by Urvashi Mohnani <umohnani@redhat.com>

43
docs/source/markdown/podman-push.1.md
View File

@ -20,37 +20,30 @@ Images are pushed from those stored in local image storage.
## DESTINATION ## DESTINATION
The DESTINATION is a location to store container images DESTINATION is the location the container image is pushed to. It supports all transports from `containers-transports(5)`. If no transport is specified, the `docker` (i.e., container registry) transport is used. For remote clients, `docker` is the only supported transport.
The Image "DESTINATION" uses a "transport":"details" format.
If a transport is not given, podman push will attempt to push
to a registry.
Multiple transports are supported: ```
# Push to a container registry
$ podman push quay.io/podman/stable
**dir:**_path_ # Push to a container registry via the docker transport
An existing local directory _path_ storing the manifest, layer tarballs and signatures as individual files. This is a non-standardized format, primarily useful for debugging or noninvasive container inspection. $ podman push docker://quay.io/podman/stable
$ podman push myimage dir:/tmp/myimage # Push to a container registry with another tag
$ podman push myimage quay.io/username/myimage
**docker://**_docker-reference_ # Push to a local directory
An image in a registry implementing the "Docker Registry HTTP API V2". By default, uses the authorization state in `$XDG_RUNTIME_DIR/containers/auth.json`, which is set using `(podman login)`. If the authorization state is not found there, `$HOME/.docker/config.json` is checked, which is set using `(docker login)`. $ podman push myimage dir:/tmp/myimage
$ podman push myimage quay.io/username/myimage # Push to a tarball in the docker-archive format
$ podman push myimage docker-archive:/tmp/myimage
**docker-archive:**_path_[**:**_docker-reference_] # Push to a local docker daemon
An image is stored in the `docker save` formatted file. _docker-reference_ is only used when creating such a file, and it must not contain a digest. $ sudo podman push myimage docker-daemon:docker.io/library/myimage:33
$ podman push myimage docker-archive:/tmp/myimage # Push to a tarball in the OCI format
$ podman push myimage oci-archive:/tmp/myimage
**docker-daemon:**_docker-reference_ ```
An image in _docker-reference_ format stored in the docker daemon internal storage. _docker-reference_ must contain a tag.
$ sudo podman push myimage docker-daemon:docker.io/library/myimage:33
**oci-archive:**_path_**:**_tag_
An image _tag_ in a directory compliant with "Open Container Image Layout Specification" at _path_.
$ podman push myimage oci-archive:/tmp/myimage
## OPTIONS ## OPTIONS
@ -161,4 +154,4 @@ Storing signatures
``` ```
## SEE ALSO ## SEE ALSO
podman(1), podman-pull(1), podman-login(1), containers-certs.d(5) podman(1), podman-pull(1), podman-login(1), containers-certs.d(5), containers-transports(5)