podman/docs/source/markdown/podman-artifact-ls.1.md at 02dd3e123fdf02b47f02f21af551400656b87185

mirror of https://github.com/containers/podman.git synced 2025-12-02 11:08:36 +08:00

Files

Brent Baude d7553fabc7 podman artifact

the podman artifact verb is used to manage OCI artifacts.  the following
verbs were added to `podman artifact`:

* add
* inspect
* ls
* pull
* push
* rm

Notable items with this PR:

* all artifact commands and their output are subject to change. i.e.
  consider all of this tech preview
* there is no way to add a file to an artifact that already exists in
  the store.  you would need to delete and recreate the artifact.
* all references to artifacts names should be fully qualified names in
  the form of repo/name:tag (i.e. quay.io/artifact/foobar:latest)
* i understand that we will likely want to be able to attribute things
  like arch, etc to artifact files.  this function is not available yet.

Many thanks to Paul Holzinger for autocompletion PRs and review PRs that
fixed issues early on.

Also fix up some Args function to specify the correct number of args.

Signed-off-by: Paul Holzinger <pholzing@redhat.com>
Signed-off-by: Brent Baude <bbaude@redhat.com>

2025-01-21 12:47:30 -06:00

1.6 KiB

Raw Blame History

% podman-artifact-ls 1

WARNING: Experimental command

This command is considered experimental and still in development. Inputs, options, and outputs are all subject to change.

NAME

podman-artifact-ls - List OCI artifacts in local store

SYNOPSIS

podman artifact ls [options]

DESCRIPTION

List all local artifacts in your local store.

OPTIONS

--format

Print results with a Go template.

Placeholder	Description
.Digest	The computed digest of the artifact's manifest
.Repository	Repository name of the artifact
.Size	Size artifact in human readable units
.Tag	Tag of the artifact name

EXAMPLES

List artifacts in the local store

$ podman artifact ls
REPOSITORY                TAG         DIGEST                                                            SIZE
quay.io/artifact/foobar1  latest      ab609fad386df1433f461b0643d9cf575560baf633809dcc9c190da6cc3a3c29  2.097GB
quay.io/artifact/foobar2  special     cd734b558ceb8ccc0281ca76530e1dea1eb479407d3163f75fb601bffb6f73d0  12.58MB

List artifact digests and size using a --format

$ podman artifact ls --format "{{.Digest}} {{.Size}}"
ab609fad386df1433f461b0643d9cf575560baf633809dcc9c190da6cc3a3c29 2.097GB
cd734b558ceb8ccc0281ca76530e1dea1eb479407d3163f75fb601bffb6f73d0 12.58MB

HISTORY

Jan 2025, Originally compiled by Brent Baude bbaude@redhat.com

1.6 KiB Raw Blame History