171 lines
4.6 KiB
Groff
171 lines
4.6 KiB
Groff
'\" t
|
|
.nh
|
|
.TH podman-image-inspect 1
|
|
.SH NAME
|
|
podman-image-inspect \- Display an image's configuration
|
|
|
|
.SH SYNOPSIS
|
|
\fBpodman image inspect\fP [\fIoptions\fP] \fIimage\fP [\fIimage\fP ...]
|
|
|
|
.SH DESCRIPTION
|
|
This displays the low-level information on images identified by name or ID. By default, this renders all results in a JSON array. If a format is specified, the given template is executed for each result.
|
|
|
|
.SH OPTIONS
|
|
.SS \fB--format\fP, \fB-f\fP=\fIformat\fP
|
|
Format the output using the given Go template.
|
|
The keys of the returned JSON can be used as the values for the --format flag (see examples below).
|
|
|
|
.PP
|
|
Valid placeholders for the Go template are listed below:
|
|
|
|
.TS
|
|
allbox;
|
|
l l
|
|
l l .
|
|
\fB\fBPlaceholder\fP\fP \fB\fBDescription\fP\fP
|
|
\&.Annotations ... T{
|
|
Annotation information included in the image
|
|
T}
|
|
\&.Architecture T{
|
|
Architecture of software in the image
|
|
T}
|
|
\&.Author Image author
|
|
\&.Comment Image comment
|
|
\&.Config ... Structure with config info
|
|
\&.Created ... T{
|
|
Image creation time (string, ISO3601)
|
|
T}
|
|
\&.Digest T{
|
|
Image digest (sha256:+64-char hash)
|
|
T}
|
|
\&.GraphDriver ... T{
|
|
Structure for the graph driver info
|
|
T}
|
|
\&.HealthCheck ... T{
|
|
Structure for the health check info
|
|
T}
|
|
\&.History T{
|
|
History information stored in image
|
|
T}
|
|
\&.ID Image ID (full 64-char hash)
|
|
\&.Labels ... T{
|
|
Label information included in the image
|
|
T}
|
|
\&.ManifestType Manifest type of the image
|
|
\&.NamesHistory T{
|
|
Name history information stored in image
|
|
T}
|
|
\&.Os T{
|
|
Operating system of software in the image
|
|
T}
|
|
\&.Parent T{
|
|
Parent image of the specified image
|
|
T}
|
|
\&.RepoDigests T{
|
|
Repository digests for the image
|
|
T}
|
|
\&.RepoTags Repository tags for the image
|
|
\&.RootFS ... T{
|
|
Structure for the root file system info
|
|
T}
|
|
\&.Size Size of image, in bytes
|
|
\&.User T{
|
|
Default user to execute the image as
|
|
T}
|
|
\&.Version Image Version
|
|
\&.VirtualSize T{
|
|
Virtual size of image, in bytes
|
|
T}
|
|
.TE
|
|
|
|
.SH EXAMPLE
|
|
Inspect information on the specified image:
|
|
|
|
.EX
|
|
$ podman image inspect fedora
|
|
[
|
|
{
|
|
"Id": "37e5619f4a8ca9dbc4d6c0ae7890625674a10dbcfb76201399e2aaddb40da17d",
|
|
"Digest": "sha256:1b0d4ddd99b1a8c8a80e885aafe6034c95f266da44ead992aab388e6aa91611a",
|
|
"RepoTags": [
|
|
"registry.fedoraproject.org/fedora:latest"
|
|
],
|
|
"RepoDigests": [
|
|
"registry.fedoraproject.org/fedora@sha256:1b0d4ddd99b1a8c8a80e885aafe6034c95f266da44ead992aab388e6aa91611a",
|
|
"registry.fedoraproject.org/fedora@sha256:b5290db40008aae9272ad3a6bd8070ef7ecd547c3bef014b894c327960acc582"
|
|
],
|
|
"Parent": "",
|
|
"Comment": "Created by Image Factory",
|
|
"Created": "2021-08-09T05:48:47Z",
|
|
"Config": {
|
|
"Env": [
|
|
"DISTTAG=f34container",
|
|
"FGC=f34",
|
|
"container=oci"
|
|
],
|
|
"Cmd": [
|
|
"/bin/bash"
|
|
],
|
|
"Labels": {
|
|
"license": "MIT",
|
|
"name": "fedora",
|
|
"vendor": "Fedora Project",
|
|
"version": "34"
|
|
}
|
|
},
|
|
"Version": "1.10.1",
|
|
"Author": "",
|
|
"Architecture": "amd64",
|
|
"Os": "linux",
|
|
"Size": 183852302,
|
|
"VirtualSize": 183852302,
|
|
"GraphDriver": {
|
|
"Name": "overlay",
|
|
"Data": {
|
|
"UpperDir": "/home/dwalsh/.local/share/containers/storage/overlay/0203e243f1ca4b6bb49371ecd21363212467ec6d7d3fa9f324cd4e78cc6b5fa2/diff",
|
|
"WorkDir": "/home/dwalsh/.local/share/containers/storage/overlay/0203e243f1ca4b6bb49371ecd21363212467ec6d7d3fa9f324cd4e78cc6b5fa2/work"
|
|
}
|
|
},
|
|
"RootFS": {
|
|
"Type": "layers",
|
|
"Layers": [
|
|
"sha256:0203e243f1ca4b6bb49371ecd21363212467ec6d7d3fa9f324cd4e78cc6b5fa2"
|
|
]
|
|
},
|
|
"Labels": {
|
|
"license": "MIT",
|
|
"name": "fedora",
|
|
"vendor": "Fedora Project",
|
|
"version": "34"
|
|
},
|
|
"Annotations": {},
|
|
"ManifestType": "application/vnd.docker.distribution.manifest.v2+json",
|
|
"User": "",
|
|
"History": [
|
|
{
|
|
"created": "2021-08-09T05:48:47Z",
|
|
"comment": "Created by Image Factory"
|
|
}
|
|
],
|
|
"NamesHistory": [
|
|
"registry.fedoraproject.org/fedora:latest"
|
|
]
|
|
}
|
|
]
|
|
.EE
|
|
|
|
.PP
|
|
Inspect image ID for the specified image:
|
|
|
|
.EX
|
|
$ podman image inspect --format '{{ .Id }}' fedora
|
|
37e5619f4a8ca9dbc4d6c0ae7890625674a10dbcfb76201399e2aaddb40da17d
|
|
.EE
|
|
|
|
.SH SEE ALSO
|
|
\fBpodman(1)\fP, \fBpodman-image(1)\fP, \fBpodman-inspect(1)\fP
|
|
|
|
.SH HISTORY
|
|
Sep 2021, Originally compiled by Dan Walsh dwalsh@redhat.com
|
|
\[la]mailto:dwalsh@redhat.com\[ra]
|