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