File: buildah-images.1.md

package info (click to toggle)
golang-github-containers-buildah 1.28.2%2Bds1-3%2Bdeb12u1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 6,336 kB
  • sloc: sh: 2,291; makefile: 218; perl: 187; awk: 12; ansic: 1
file content (137 lines) | stat: -rw-r--r-- 4,546 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
# buildah-images "1" "March 2017" "buildah"

## NAME
buildah\-images - List images in local storage.

## SYNOPSIS
**buildah images** [*options*] [*image*]

## DESCRIPTION
Displays locally stored images, their names, sizes, created date and their IDs.
The created date is displayed in the time locale of the local machine.

## OPTIONS

**--all**, **-a**

Show all images, including intermediate images from a build.

**--digests**

Show the image digests.

**--filter**, **-f**=[]

Filter output based on conditions provided (default []).

  Filters:

  **after,since=image**
    Filter on images created since the given image.

  **before=image**
    Filter on images created before the given image.

  **dangling=true|false**
    Show dangling images. An images is considered to be dangling if it has no associated names and tags.

  **id=id**
    Show image with this specific ID.

  **intermediate=true|false**
    Show intermediate images. An images is considered to be an indermediate image if it is dangling and has no children.

  **label=key[=value]**
    Filter by images labels key and/or value.

  **readonly=true|false**
    Show only read only images or Read/Write images. The default is to show both.  Read/Only images can be configured by modifying the  "additionalimagestores" in the /etc/containers/storage.conf file.

  **reference=reference**
    Show images matching the specified reference. Wildcards are supported (e.g., "reference=*fedora:3*").

**--format**="TEMPLATE"

Pretty-print images using a Go template.

Valid placeholders for the Go template are listed below:

| **Placeholder** | **Description**                          |
| --------------- | -----------------------------------------|
| .Created        | Creation date in epoch time              |
| .CreatedAt      | Creation date Pretty Formatted           |
| .CreatedAtRaw   | Creation date in raw format              |
| .Digest         | Image Digest                             |
| .ID             | Image ID                                 |
| .Name           | Image Name                               |
| .ReadOnly       | Indicates if image came from a R/O store |
| .Size           | Image Size                               |
| .Tag            | Image Tag                                |

**--history**

Display the image name history.

**--json**

Display the output in JSON format.

**--no-trunc**

Do not truncate output.

**--noheading**, **-n**

Omit the table headings from the listing of images.

**--quiet**, **-q**

Displays only the image IDs.

## EXAMPLE

buildah images

buildah images fedora:latest

buildah images --json

buildah images --quiet

buildah images -q --noheading --no-trunc

buildah images --quiet fedora:latest

buildah images --filter dangling=true

buildah images --format "ImageID: {{.ID}}"

```
$ buildah images
REPOSITORY                        TAG        IMAGE ID       CREATED        SIZE
registry.access.redhat.com/ubi8   latest     53ce4390f2ad   3 weeks ago    233 MB
docker.io/library/busybox         latest     16ea53ea7c65   3 weeks ago    1.46 MB
quay.io/libpod/testimage          20210610   9f9ec7f2fdef   4 months ago   7.99 MB
```

```
# buildah images -a
IMAGE NAME                                               IMAGE TAG            IMAGE ID             CREATED AT             SIZE
registry.access.redhat.com/ubi8   latest     53ce4390f2ad   3 weeks ago    233 MB
<none>                                                   <none>               8c6e16890c2b         Jun 13, 2018 15:52     4.42 MB
localhost/test                                           latest               c0cfe75da054         Jun 13, 2018 15:52     4.42 MB
```

```
# buildah images --format '{{.ID}} {{.CreatedAtRaw}}'
3f53bb00af943dfdf815650be70c0fa7b426e56a66f5e3362b47a129d57d5991 2018-12-20 19:21:30.122610396 -0500 EST
8e09da8f6701d7cde1526d79e3123b0f1109b78d925dfe9f9bac6d59d702a390 2019-01-08 09:22:52.330623532 -0500 EST
```

```
# buildah images --format '{{.ID}} {{.Name}} {{.Digest}} {{.CreatedAt}} {{.Size}} {{.CreatedAtRaw}}'
3f53bb00af943dfdf815650be70c0fa7b426e56a66f5e3362b47a129d57d5991 docker.io/library/alpine sha256:3d2e482b82608d153a374df3357c0291589a61cc194ec4a9ca2381073a17f58e Dec 20, 2018 19:21 4.67 MB 2018-12-20 19:21:30.122610396 -0500 EST
8e09da8f6701d7cde1526d79e3123b0f1109b78d925dfe9f9bac6d59d702a390 <none> sha256:894532ec56e0205ce68ca7230b00c18aa3c8ee39fcdb310615c60e813057229c Jan 8, 2019 09:22 4.67 MB 2019-01-08 09:22:52.330623532 -0500 EST
```
## SEE ALSO
buildah(1), containers-storage.conf(5)