container/podman
container/podman
1
0
Fork 0
mirror of https://github.com/containers/podman synced 2024-10-21 01:34:37 +00:00
Code Issues Packages Projects Releases Wiki Activity
podman/docs/podman-image.1.md

35 lines
2.7 KiB
Markdown
Raw Normal View History

docs: fix headers Signed-off-by: Valentin Rothberg <vrothberg@suse.com> Closes: #1375 Approved by: rhatdan
2018-08-30 08:41:19 +00:00
% podman-image(1)
add podman container and image command Signed-off-by: Daniel J Walsh <dwalsh@redhat.com> Closes: #941 Approved by: TomSweeneyRedHat
2018-06-13 11:40:41 +00:00
## NAME
podman\-image - Manage images
## SYNOPSIS
docs: Follow man-pages(7) suggestions for SYNOPSIS man-pages(7) has [1]: > For commands, this shows the syntax of the command and its arguments > (including options); boldface is used for as-is text and italics are > used to indicate replaceable arguments. Brackets ([]) surround > optional arguments, vertical bars (|) separate choices, and ellipses > (...) can be repeated. I've adjusted our SYNOPSIS entries to match that formatting, and generally tried to make them more consistent with the precedent set by the man-pages project. Outside of the SYNOPSIS entry, I prefer using backticks for literals, although in some places I've left the ** bolding to keep things visually similar to a nearby SYNOPSIS entry. [1]: http://man7.org/linux/man-pages/man7/man-pages.7.html Signed-off-by: W. Trevor King <wking@tremily.us> Closes: #1027 Approved by: rhatdan
2018-06-29 17:53:33 +00:00
**podman image** *subcommand*
add podman container and image command Signed-off-by: Daniel J Walsh <dwalsh@redhat.com> Closes: #941 Approved by: TomSweeneyRedHat
2018-06-13 11:40:41 +00:00
## DESCRIPTION
The image command allows you to manage images
## COMMANDS
| Command | Man Page | Description |
| -------- | ----------------------------------------- | ------------------------------------------------------------------------------ |
| build | [podman-build(1)](podman-build.1.md) | Build a container using a Dockerfile. |
add podman container|image exists Add an exists subcommand to podman container and podman image that allows users to verify the existence of a container or image by ID or name. The return code can be 0 (success), 1 (failed to find), or 125 (failed to work with runtime). Issue #1845 Signed-off-by: baude <bbaude@redhat.com>
2018-11-25 22:26:39 +00:00
| exists | [podman-exists(1)](podman-image-exists.1.md) | Check if a image exists in local storage |
add podman container and image command Signed-off-by: Daniel J Walsh <dwalsh@redhat.com> Closes: #941 Approved by: TomSweeneyRedHat
2018-06-13 11:40:41 +00:00
| history | [podman-history(1)](podman-history.1.md) | Show the history of an image. |
| import | [podman-import(1)](podman-import.1.md) | Import a tarball and save it as a filesystem image. |
| inspect | [podman-inspect(1)](podman-inspect.1.md) | Display a image or image's configuration. |
Allow alias for list, ls, ps to work Allow multiple alias for listing containers and images. Also fix documentation for umount and unmount Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>
2018-12-22 12:28:21 +00:00
| list | [podman-images(1)](podman-images.1.md) | List the container images on the system. |
add podman container and image command Signed-off-by: Daniel J Walsh <dwalsh@redhat.com> Closes: #941 Approved by: TomSweeneyRedHat
2018-06-13 11:40:41 +00:00
| load | [podman-load(1)](podman-load.1.md) | Load an image from the docker archive. |
Allow alias for list, ls, ps to work Allow multiple alias for listing containers and images. Also fix documentation for umount and unmount Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>
2018-12-22 12:28:21 +00:00
| ls | [podman-images(1)](podman-images.1.md) | List the container images on the system. |
add podman container and image command Signed-off-by: Daniel J Walsh <dwalsh@redhat.com> Closes: #941 Approved by: TomSweeneyRedHat
2018-06-13 11:40:41 +00:00
| pull | [podman-pull(1)](podman-pull.1.md) | Pull an image from a registry. |
Add ability to prune containers and images Allow user to prune unused/unnamed images, the layer images from building, via podman rmi --prune. Allow user to prune stopped/exiuted containers via podman rm --prune. This should resolve #1910 Signed-off-by: baude <bbaude@redhat.com>
2018-12-01 15:49:46 +00:00
| prune| [podman-container-prune(1)](podman-container-prune.1.md) | Removed all unused images from the local store |
add podman container and image command Signed-off-by: Daniel J Walsh <dwalsh@redhat.com> Closes: #941 Approved by: TomSweeneyRedHat
2018-06-13 11:40:41 +00:00
| push | [podman-push(1)](podman-push.1.md) | Push an image from local storage to elsewhere. |
| rm | [podman-rm(1)](podman-rmi.1.md) | Removes one or more locally stored images. |
| save | [podman-save(1)](podman-save.1.md) | Save an image to docker-archive or oci. |
| tag | [podman-tag(1)](podman-tag.1.md) | Add an additional name to a local image. |
[WIP]Support podman image sign Generate a signature claim for an image using user keyring (--sign-by). The signature file will be stored in simple json format under the default or the given directory (--directory or yaml file in /etc/containers/registries.d/). Signed-off-by: Qi Wang <qiwan@redhat.com>
2018-12-12 20:48:21 +00:00
| trust | [podman-image-trust(1)](podman-image-trust.1.md) | Manage container image trust policy. |
| sign | [podman-image-sign(1)](podman-image-sign.1.md) | Sign an image. |
add podman container and image command Signed-off-by: Daniel J Walsh <dwalsh@redhat.com> Closes: #941 Approved by: TomSweeneyRedHat
2018-06-13 11:40:41 +00:00
## SEE ALSO
podman
Reference in a new issue Copy permalink