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 --authfile path
29 Path of the authentication file. Default is ${XDG_RUNTIME_DIR}/contain‐
32 ers/auth.json, which is set using skopeo login. If the authorization
33 state is not found there, $HOME/.docker/config.json is checked, which
34 is set using docker login.
35 --cert-dir path
38 Use certificates at path (*.crt, *.cert, *.key) to connect to the reg‐
41 istry.
42 --config
45 Output configuration in OCI format, default is to format in JSON for‐
48 mat.
49 --creds username[:password]
52 Username and password for accessing the registry.
55 --daemon-host host
58 Use docker daemon host at host (docker-daemon: transport only)
61 --format, -f=format
64 Format the output using the given Go template. The keys of the re‐
67 turned JSON can be used as the values for the --format flag (see exam‐
68 ples below).
69 --help, -h
72 Print usage statement
75 --no-creds
78 Access the registry anonymously.
81 --raw
84 Output raw manifest or config data depending on --config option. The
87 --format option is not supported with --raw option.
88 --registry-token Bearer token
91 Registry token for accessing the registry.
94 --retry-times
97 The number of times to retry; retry wait time will be exponentially in‐
100 creased based on the number of failed attempts.
101 --shared-blob-dir directory
104 Directory to use to share blobs across OCI repositories.
107 --tls-verify=bool
110 Require HTTPS and verify certificates when talking to the container
113 registry or daemon. Default to registry.conf setting.
114 --username
117 The username to access the registry.
120 --password
123 The password to access the registry.
126 --no-tags, -n
129 Do not list the available tags from the repository in the output. When
132 true, the RepoTags array will be empty. Defaults to false, which in‐
133 cludes all available tags.
134
137 To review information for the image fedora from the docker.io registry:
138 $ skopeo inspect docker://docker.io/fedora
141 {
142 "Name": "docker.io/library/fedora",
143 "Digest": "sha256:a97914edb6ba15deb5c5acf87bd6bd5b6b0408c96f48a5cbd450b5b04509bb7d",
144 "RepoTags": [
145 "20",
146 "21",
147 "22",
148 "23",
149 "24",
150 "heisenbug",
151 "latest",
152 "rawhide"
153 ],
154 "Created": "2016-06-20T19:33:43.220526898Z",
155 "DockerVersion": "1.10.3",
156 "Labels": {},
157 "Architecture": "amd64",
158 "Os": "linux",
159 "Layers": [
160 "sha256:7c91a140e7a1025c3bc3aace4c80c0d9933ac4ee24b8630a6b0b5d8b9ce6b9d4"
161 ]
162 }
163 To inspect python from the docker.io registry and not show the avail‐
167 able tags:
168 $ skopeo inspect --no-tags docker://docker.io/library/python
171 {
172 "Name": "docker.io/library/python",
173 "Digest": "sha256:5ca194a80ddff913ea49c8154f38da66a41d2b73028c5cf7e46bc3c1d6fda572",
174 "RepoTags": [],
175 "Created": "2021-10-05T23:40:54.936108045Z",
176 "DockerVersion": "20.10.7",
177 "Labels": null,
178 "Architecture": "amd64",
179 "Os": "linux",
180 "Layers": [
181 "sha256:df5590a8898bedd76f02205dc8caa5cc9863267dbcd8aac038bcd212688c1cc7",
182 "sha256:705bb4cb554eb7751fd21a994f6f32aee582fbe5ea43037db6c43d321763992b",
183 "sha256:519df5fceacdeaadeec563397b1d9f4d7c29c9f6eff879739cab6f0c144f49e1",
184 "sha256:ccc287cbeddc96a0772397ca00ec85482a7b7f9a9fac643bfddd87b932f743db",
185 "sha256:e3f8e6af58ed3a502f0c3c15dce636d9d362a742eb5b67770d0cfcb72f3a9884",
186 "sha256:aebed27b2d86a5a3a2cbe186247911047a7e432b9d17daad8f226597c0ea4276",
187 "sha256:54c32182bdcc3041bf64077428467109a70115888d03f7757dcf614ff6d95ebe",
188 "sha256:cc8b7caedab13af07adf4836e13af2d4e9e54d794129b0fd4c83ece6b1112e86",
189 "sha256:462c3718af1d5cdc050cfba102d06c26f78fe3b738ce2ca2eb248034b1738945"
190 ],
191 "Env": [
192 "PATH=/usr/local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
193 "LANG=C.UTF-8",
194 "GPG_KEY=A035C8C19219BA821ECEA86B64E628F8D684696D",
195 "PYTHON_VERSION=3.10.0",
196 "PYTHON_PIP_VERSION=21.2.4",
197 "PYTHON_SETUPTOOLS_VERSION=57.5.0",
198 "PYTHON_GET_PIP_URL=https://github.com/pypa/get-pip/raw/d781367b97acf0ece7e9e304bf281e99b618bf10/public/get-pip.py",
199 "PYTHON_GET_PIP_SHA256=01249aa3e58ffb3e1686b7141b4e9aac4d398ef4ac3012ed9dff8dd9f685ffe0"
200 ]
201 }
202 $ /bin/skopeo inspect --config docker://registry.fedoraproject.org/fedora --format "{{ .Architecture }}"
206 amd64
207 $ /bin/skopeo inspect --format '{{ .Env }}' docker://registry.access.redhat.com/ubi8
211 [PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin container=oci]
212
217 skopeo(1), skopeo-login(1), docker-login(1), containers-auth.json(5)
218
221 Antonio Murdaca runcom@redhat.com ⟨mailto:runcom@redhat.com⟩, Miloslav
222 Trmac mitr@redhat.com ⟨mailto:mitr@redhat.com⟩, Jhon Honce jhonce@red‐
223 hat.com ⟨mailto:jhonce@redhat.com⟩
224 skopeo-inspect(1)()