mirror of
https://github.com/containers/podman.git
synced 2025-08-06 11:32:07 +08:00
bc2763eac8
like images and containers, it could be handy to have a --noheading option that removes the headings on the output. Signed-off-by: Brent Baude <bbaude@redhat.com>
74 lines
2.1 KiB
Markdown
74 lines
2.1 KiB
Markdown
% 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 |
|
|
|
|
@@option no-trunc
|
|
|
|
@@option noheading
|
|
|
|
## EXAMPLES
|
|
|
|
List artifacts in the local store
|
|
```
|
|
$ podman artifact ls
|
|
REPOSITORY TAG DIGEST SIZE
|
|
quay.io/artifact/foobar1 latest ab609fad386d 2.097GB
|
|
quay.io/artifact/foobar2 special cd734b558ceb 12.58MB
|
|
```
|
|
|
|
List artifacts in the local store without truncating the digest
|
|
```
|
|
$ podman artifact ls --no-trunc
|
|
REPOSITORY TAG DIGEST SIZE
|
|
quay.io/artifact/foobar1 latest ab609fad386df1433f461b0643d9cf575560baf633809dcc9c190da6cc3a3c29 2.097GB
|
|
quay.io/artifact/foobar2 special cd734b558ceb8ccc0281ca76530e1dea1eb479407d3163f75fb601bffb6f73d0 12.58MB
|
|
```
|
|
|
|
List artifacts in the local store without the title header
|
|
```
|
|
$ podman artifact ls --noheading
|
|
quay.io/artifact/foobar1 latest ab609fad386d 2.097GB
|
|
quay.io/artifact/foobar2 special cd734b558ceb 12.58MB
|
|
```
|
|
|
|
List artifact digests and size using a --format
|
|
```
|
|
$ podman artifact ls --format "{{.Digest}} {{.Size}}"
|
|
ab609fad386d 2.097GB
|
|
cd734b558ceb 12.58MB
|
|
```
|
|
|
|
|
|
|
|
## SEE ALSO
|
|
**[podman(1)](podman.1.md)**, **[podman-artifact(1)](podman-artifact.1.md)**
|
|
|
|
## HISTORY
|
|
Jan 2025, Originally compiled by Brent Baude <bbaude@redhat.com>
|