1skopeo-inspect(1)() skopeo-inspect(1)()
2
6 skopeo-inspect - Return low-level information about image-name in a
7 registry.
8
11 skopeo inspect [options] image-name
12
15 Return low-level information about image-name in a registry. See
16 skopeo(1) for the format of image-name.
17 The default output includes data from various sources: user input
20 (Name), the remote repository, if any (RepoTags), the top-level mani‐
21 fest (Digest), and a per-architecture/OS image matching the current
22 run-time environment (most other values). To see values for a differ‐
23 ent architecture/OS, use the --override-os / --override-arch options
24 documented in skopeo(1).
25
28 See also skopeo(1) for options placed before the subcommand name.
29 --authfile path
32 Path of the authentication file. Default is ${XDG_RUNTIME_DIR}/contain‐
35 ers/auth.json, which is set using skopeo login. If the authorization
36 state is not found there, $HOME/.docker/config.json is checked, which
37 is set using docker login.
38 --cert-dir path
41 Use certificates at path (*.crt, *.cert, *.key) to connect to the reg‐
44 istry.
45 --config
48 Output configuration in OCI format, default is to format in JSON for‐
51 mat.
52 --creds username[:password]
55 Username and password for accessing the registry.
58 --daemon-host host
61 Use docker daemon host at host (docker-daemon: transport only)
64 --format, -f=format
67 Format the output using the given Go template. The keys of the re‐
70 turned JSON can be used as the values for the --format flag (see exam‐
71 ples below). Supports the Go templating functions available at
72 https://pkg.go.dev/github.com/containers/common/pkg/report#hdr-Tem‐
73 plate_Functions
74 --help, -h
77 Print usage statement
80 --no-creds
83 Access the registry anonymously.
86 --raw
89 Output raw manifest or config data depending on --config option. The
92 --format option is not supported with --raw option.
93 --registry-token Bearer token
96 Registry token for accessing the registry.
99 --retry-times
102 The number of times to retry; retry wait time will be exponentially in‐
105 creased based on the number of failed attempts.
106 --shared-blob-dir directory
109 Directory to use to share blobs across OCI repositories.
112 --tls-verify=bool
115 Require HTTPS and verify certificates when talking to the container
118 registry or daemon. Default to registry.conf setting.
119 --username
122 The username to access the registry.
125 --password
128 The password to access the registry.
131 --no-tags, -n
134 Do not list the available tags from the repository in the output. When
137 true, the RepoTags array will be empty. Defaults to false, which in‐
138 cludes all available tags.
139
142 To review information for the image fedora from the docker.io registry:
143 $ skopeo inspect docker://docker.io/fedora
145 {
147 "Name": "docker.io/library/fedora",
148 "Digest": "sha256:f99efcddc4dd6736d8a88cc1ab6722098ec1d77dbf7aed9a7a514fc997ca08e0",
149 "RepoTags": [
150 "20",
151 "21",
152 "..."
153 ],
154 "Created": "2022-11-16T07:26:42.618327645Z",
155 "DockerVersion": "20.10.12",
156 "Labels": {
157 "maintainer": "Clement Verna \u003ccverna@fedoraproject.org\u003e"
158 },
159 "Architecture": "amd64",
160 "Os": "linux",
161 "Layers": [
162 "sha256:cb8b1ed77979b894115a983f391465651aa7eb3edd036be4b508eea47271eb93"
163 ],
164 "LayersData": [
165 {
166 "MIMEType": "application/vnd.docker.image.rootfs.diff.tar.gzip",
167 "Digest": "sha256:cb8b1ed77979b894115a983f391465651aa7eb3edd036be4b508eea47271eb93",
168 "Size": 65990920,
169 "Annotations": null
170 }
171 ],
172 "Env": [
173 "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
174 "DISTTAG=f37container",
175 "FGC=f37",
176 "FBR=f37"
177 ]
178 }
179 To inspect python from the docker.io registry and not show the avail‐
183 able tags:
184 $ skopeo inspect --no-tags docker://docker.io/library/python
186 {
187 "Name": "docker.io/library/python",
188 "Digest": "sha256:10fc14aa6ae69f69e4c953cffd9b0964843d8c163950491d2138af891377bc1d",
189 "RepoTags": [],
190 "Created": "2022-11-16T06:55:28.566254104Z",
191 "DockerVersion": "20.10.12",
192 "Labels": null,
193 "Architecture": "amd64",
194 "Os": "linux",
195 "Layers": [
196 "sha256:a8ca11554fce00d9177da2d76307bdc06df7faeb84529755c648ac4886192ed1",
197 "sha256:e4e46864aba2e62ba7c75965e4aa33ec856ee1b1074dda6b478101c577b63abd",
198 "..."
199 ],
200 "LayersData": [
201 {
202 "MIMEType": "application/vnd.docker.image.rootfs.diff.tar.gzip",
203 "Digest": "sha256:a8ca11554fce00d9177da2d76307bdc06df7faeb84529755c648ac4886192ed1",
204 "Size": 55038615,
205 "Annotations": null
206 },
207 {
208 "MIMEType": "application/vnd.docker.image.rootfs.diff.tar.gzip",
209 "Digest": "sha256:e4e46864aba2e62ba7c75965e4aa33ec856ee1b1074dda6b478101c577b63abd",
210 "Size": 5164893,
211 "Annotations": null
212 },
213 "..."
214 ],
215 "Env": [
216 "PATH=/usr/local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
217 "LANG=C.UTF-8",
218 "...",
219 ]
220 }
221 $ /bin/skopeo inspect --config docker://registry.fedoraproject.org/fedora --format "{{ .Architecture }}"
224 amd64
225 $ /bin/skopeo inspect --format '{{ .Env }}' docker://registry.access.redhat.com/ubi8
228 [PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin container=oci]
229
234 skopeo(1), skopeo-login(1), docker-login(1), containers-auth.json(5)
235
238 Antonio Murdaca runcom@redhat.com ⟨mailto:runcom@redhat.com⟩, Miloslav
239 Trmac mitr@redhat.com ⟨mailto:mitr@redhat.com⟩, Jhon Honce jhonce@red‐
240 hat.com ⟨mailto:jhonce@redhat.com⟩
241 skopeo-inspect(1)()