1skopeo-list-tags(1)() skopeo-list-tags(1)()
2
6 skopeo-list-tags - List image names in a transport-specific collection
7 of images.
8
11 skopeo list-tags [options] source-image
12 Return a list of tags from source-image in a registry or a local
15 docker-archive file.
16 source-image name of the repository to retrieve a tag listing from or a
19 local docker-archive file.
20
23 --authfile path
24 Path of the authentication file. Default is ${XDG_RUNTIME_DIR}/contain‐
27 ers/auth.json, which is set using skopeo login.
28 If the authorization state is not found there, $HOME/.docker/con‐
29 fig.json is checked, which is set using docker login.
30 --creds username[:password] for accessing the registry.
33 --cert-dir path
36 Use certificates at path (*.crt, *.cert, *.key) to connect to the reg‐
39 istry.
40 --help, -h
43 Print usage statement
46 --no-creds
49 Access the registry anonymously.
52 --registry-token Bearer token
55 Bearer token for accessing the registry.
58 --retry-times
61 The number of times to retry. Retry wait time will be exponentially in‐
64 creased based on the number of failed attempts.
65 --tls-verify=bool
68 Require HTTPS and verify certificates when talking to the container
71 registry or daemon. Default to registry.conf setting.
72 --username
75 The username to access the registry.
78 --password
81 The password to access the registry.
84
87 Repository names are transport-specific references as each transport
88 may have its own concept of a "repository" and "tags".
89 This commands refers to repositories using a transport:details format.
92 The following formats are supported:
93 docker://docker-repository-reference
96 A repository in a registry implementing the "Docker Registry HTTP API
97 V2". By default, uses the authorization state in either $XDG_RUN‐
98 TIME_DIR/containers/auth.json, which is set using (skopeo login). If
99 the authorization state is not found there, $HOME/.docker/config.json
100 is checked, which is set using (docker login).
101 A docker-repository-reference is of the form: registry‐
102 host:port/repositoryname which is similar to an image-reference but
103 with no tag or digest allowed as the last component (e.g no :latest or
104 @sha256:xyz)
105 Examples of valid docker-repository-references:
108 "docker.io/myuser/myrepo"
109 "docker.io/nginx"
110 "docker.io/library/fedora"
111 "localhost:5000/myrepository"
112 Examples of invalid references:
114 "docker.io/nginx:latest"
115 "docker.io/myuser/myimage:v1.0"
116 "docker.io/myuser/myimage@sha256:f48c4cc192f4c3c6a069cb5cca6d0a9e34d6076ba7c214fd0cc3ca60e0af76bb"
117 **docker-archive:path[:docker-reference]
121 more than one images were stored in a docker save-formatted file.
122
125 Docker Transport
126 To get the list of tags in the "fedora" repository from the docker.io
127 registry (the repository name expands to "library/fedora" per docker
128 transport canonical form):
129 $ skopeo list-tags docker://docker.io/fedora
132 {
133 "Repository": "docker.io/library/fedora",
134 "Tags": [
135 "20",
136 "21",
137 "22",
138 "23",
139 "24",
140 "25",
141 "26-modular",
142 "26",
143 "27",
144 "28",
145 "29",
146 "30",
147 "31",
148 "32",
149 "branched",
150 "heisenbug",
151 "latest",
152 "modular",
153 "rawhide"
154 ]
155 }
156 To list the tags in a local host docker/distribution registry on port
161 5000, in this case for the "fedora" repository:
162 $ skopeo list-tags docker://localhost:5000/fedora
165 {
166 "Repository": "localhost:5000/fedora",
167 "Tags": [
168 "latest",
169 "30",
170 "31"
171 ]
172 }
173 Docker-archive Transport
178 To list the tags in a local docker-archive file:
179 $ skopeo list-tags docker-archive:/tmp/busybox.tar.gz
182 {
183 "Tags": [
184 "busybox:1.28.3"
185 ]
186 }
187 Also supports more than one tags in an archive:
191 $ skopeo list-tags docker-archive:/tmp/docker-two-images.tar.gz
194 {
195 "Tags": [
196 "example.com/empty:latest",
197 "example.com/empty/but:different"
198 ]
199 }
200 Will include a source-index entry for each untagged image:
204 $ skopeo list-tags docker-archive:/tmp/four-tags-with-an-untag.tar
207 {
208 "Tags": [
209 "image1:tag1",
210 "image2:tag2",
211 "@2",
212 "image4:tag4"
213 ]
214 }
215
220 skopeo(1), skopeo-login(1), docker-login(1), containers-auth.json(5),
221 containers-transports(1)
222
225 Zach Hill zach@anchore.com ⟨mailto:zach@anchore.com⟩
226 skopeo-list-tags(1)()