1skopeo-inspect(1)() skopeo-inspect(1)()
2
3
4
6 skopeo-inspect - Return low-level information about image-name in a
7 registry.
8
9
11 skopeo inspect [options] image-name
12
13
15 Return low-level information about image-name in a registry
16
17
18 image-name name of image to retrieve information about
19
20
22 --authfile path
23
24
25 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
30
31 --cert-dir path
32
33
34 Use certificates at path (*.crt, *.cert, *.key) to connect to the reg‐
35 istry.
36
37
38 --config
39
40
41 Output configuration in OCI format, default is to format in JSON for‐
42 mat.
43
44
45 --creds username[:password]
46
47
48 Username and password for accessing the registry.
49
50
51 --format, -f=format
52
53
54 Format the output using the given Go template. The keys of the
55 returned JSON can be used as the values for the --format flag (see
56 examples below).
57
58
59 --no-creds
60
61
62 Access the registry anonymously.
63
64
65 --raw
66
67
68 Output raw manifest or config data depending on --config option. The
69 --format option is not supported with --raw option.
70
71
72 --registry-token Bearer token
73
74
75 Registry token for accessing the registry.
76
77
78 --retry-times
79
80
81 The number of times to retry; retry wait time will be exponentially
82 increased based on the number of failed attempts.
83
84
85 --tls-verify
86
87
88 Require HTTPS and verify certificates when talking to container reg‐
89 istries (defaults to true).
90
91
93 To review information for the image fedora from the docker.io registry:
94
95
96 $ skopeo inspect docker://docker.io/fedora
97 {
98 "Name": "docker.io/library/fedora",
99 "Digest": "sha256:a97914edb6ba15deb5c5acf87bd6bd5b6b0408c96f48a5cbd450b5b04509bb7d",
100 "RepoTags": [
101 "20",
102 "21",
103 "22",
104 "23",
105 "24",
106 "heisenbug",
107 "latest",
108 "rawhide"
109 ],
110 "Created": "2016-06-20T19:33:43.220526898Z",
111 "DockerVersion": "1.10.3",
112 "Labels": {},
113 "Architecture": "amd64",
114 "Os": "linux",
115 "Layers": [
116 "sha256:7c91a140e7a1025c3bc3aace4c80c0d9933ac4ee24b8630a6b0b5d8b9ce6b9d4"
117 ]
118 }
119
120
121
122 $ /bin/skopeo inspect --config docker://registry.fedoraproject.org/fedora --format "{{ .Architecture }}"
123 amd64
124
125
126
127 $ /bin/skopeo inspect --format '{{ .Env }}' docker://registry.access.redhat.com/ubi8
128 [PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin container=oci]
129
130
131
132
134 skopeo(1), skopeo-login(1), docker-login(1), containers-auth.json(5)
135
136
138 Antonio Murdaca runcom@redhat.com ⟨mailto:runcom@redhat.com⟩, Miloslav
139 Trmac mitr@redhat.com ⟨mailto:mitr@redhat.com⟩, Jhon Honce jhonce@red‐
140 hat.com ⟨mailto:jhonce@redhat.com⟩
141
142
143
144 skopeo-inspect(1)()