Skip to content

Commit

Permalink
[CI:DOCS] clarify supported transports in manifest push
Browse files Browse the repository at this point in the history
Closes: containers#18357
Signed-off-by: Valentin Rothberg <vrothberg@redhat.com>
  • Loading branch information
vrothberg authored and cgiradkar committed Jul 12, 2023
1 parent b84c117 commit f4b6832
Showing 1 changed file with 2 additions and 32 deletions.
34 changes: 2 additions & 32 deletions docs/source/markdown/podman-manifest-push.1.md.in
Original file line number Diff line number Diff line change
Expand Up @@ -64,37 +64,7 @@ Sign the pushed images with a sigstore signature using a private key at the spec

## DESTINATION

The DESTINATION is a location to store container images
The Image "DESTINATION" uses a "transport":"details" format.
If a transport is not given, `podman push` attempts to push
to a registry.

Multiple transports are supported:

**dir:**_path_
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 manifest push mylist:v1.11 dir:/tmp/mylist

**docker://**_docker-reference_
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 manifest push mylist:v1.11 docker://registry.example.org/mylist:v1.11

**docker-archive:**_path_[**:**_docker-reference_]
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.

$ podman manifest push mylist:v1.11 docker-archive:/tmp/mylist

**docker-daemon:**_docker-reference_
An image in _docker-reference_ format stored in the docker daemon internal storage. _docker-reference_ must contain a tag.

$ podman manifest push mylist:v1.11 docker-daemon:registry.example.org/mylist:v1.11

**oci-archive:**_path_**:**_tag_
An image _tag_ in a directory compliant with "Open Container Image Layout Specification" at _path_.

$ podman manifest push mylist:v1.11 oci-archive:/tmp/mylist
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, including Mac and Windows (excluding WSL2) machines, `docker` is the only supported transport.

## EXAMPLE

Expand All @@ -103,4 +73,4 @@ podman manifest push mylist:v1.11 docker://registry.example.org/mylist:v1.11
```

## SEE ALSO
**[podman(1)](podman.1.md)**, **[podman-manifest(1)](podman-manifest.1.md)**
**[podman(1)](podman.1.md)**, **[podman-manifest(1)](podman-manifest.1.md)**, **[containers-transports(5)](https://github.com/containers/image/blob/main/docs/containers-transports.5.md)**

0 comments on commit f4b6832

Please sign in to comment.