1skopeo-list-tags(1)()                                    skopeo-list-tags(1)()
2
3
4

NAME

6       skopeo-list-tags  - List image names in a transport-specific collection
7       of images.
8
9

SYNOPSIS

11       skopeo list-tags [options] source-image
12
13
14       Return a list of tags from  source-image  in  a  registry  or  a  local
15       docker-archive file.
16
17
18       source-image name of the repository to retrieve a tag listing from or a
19       local docker-archive file.
20
21

OPTIONS

23       See also skopeo(1) for options placed before the subcommand name.
24
25
26       --authfile path
27
28
29       Path of the authentication file. Default is ${XDG_RUNTIME_DIR}/contain‐
30       ers/auth.json, which is set using skopeo login.
31         If  the  authorization  state  is not found there, $HOME/.docker/con‐
32       fig.json is checked, which is set using docker login.
33
34
35       --creds username[:password] for accessing the registry.
36
37
38       --cert-dir path
39
40
41       Use certificates at path (*.crt, *.cert, *.key) to connect to the  reg‐
42       istry.
43
44
45       --help, -h
46
47
48       Print usage statement
49
50
51       --no-creds
52
53
54       Access the registry anonymously.
55
56
57       --registry-token Bearer token
58
59
60       Bearer token for accessing the registry.
61
62
63       --retry-times
64
65
66       The number of times to retry. Retry wait time will be exponentially in‐
67       creased based on the number of failed attempts.
68
69
70       --tls-verify=bool
71
72
73       Require HTTPS and verify certificates when  talking  to  the  container
74       registry or daemon. Default to registry.conf setting.
75
76
77       --username
78
79
80       The username to access the registry.
81
82
83       --password
84
85
86       The password to access the registry.
87
88

REPOSITORY NAMES

90       Repository  names  are  transport-specific references as each transport
91       may have its own concept of a "repository" and "tags".
92
93
94       This commands refers to repositories using a transport:details  format.
95       The following formats are supported:
96
97
98       docker://docker-repository-reference
99         A repository in a registry implementing the "Docker Registry HTTP API
100       V2". By default, uses  the  authorization  state  in  either  $XDG_RUN‐
101       TIME_DIR/containers/auth.json,  which  is  set using (skopeo login). If
102       the authorization state is not found  there,  $HOME/.docker/config.json
103       is checked, which is set using (docker login).
104         A    docker-repository-reference    is   of   the   form:   registry‐
105       host:port/repositoryname which is similar  to  an  image-reference  but
106       with  no tag or digest allowed as the last component (e.g no :latest or
107       @sha256:xyz)
108
109         Examples of valid docker-repository-references:
110           "docker.io/myuser/myrepo"
111           "docker.io/nginx"
112           "docker.io/library/fedora"
113           "localhost:5000/myrepository"
114
115         Examples of invalid references:
116           "docker.io/nginx:latest"
117           "docker.io/myuser/myimage:v1.0"
118           "docker.io/myuser/myimage@sha256:f48c4cc192f4c3c6a069cb5cca6d0a9e34d6076ba7c214fd0cc3ca60e0af76bb"
119
120
121
122       **docker-archive:path[:docker-reference]
123         more than one images were stored in a docker save-formatted file.
124
125

EXAMPLES

127   Docker Transport
128       To get the list of tags in the "fedora" repository from  the  docker.io
129       registry  (the  repository  name expands to "library/fedora" per docker
130       transport canonical form):
131
132       $ skopeo list-tags docker://docker.io/fedora
133       {
134           "Repository": "docker.io/library/fedora",
135           "Tags": [
136               "20",
137               "21",
138               "22",
139               "23",
140               "24",
141               "25",
142               "26-modular",
143               "26",
144               "27",
145               "28",
146               "29",
147               "30",
148               "31",
149               "32",
150               "branched",
151               "heisenbug",
152               "latest",
153               "modular",
154               "rawhide"
155           ]
156       }
157
158
159
160
161       To list the tags in a local host docker/distribution registry  on  port
162       5000, in this case for the "fedora" repository:
163
164       $ skopeo list-tags docker://localhost:5000/fedora
165       {
166           "Repository": "localhost:5000/fedora",
167           "Tags": [
168               "latest",
169               "30",
170               "31"
171           ]
172       }
173
174
175
176
177   Docker-archive Transport
178       To list the tags in a local docker-archive file:
179
180       $ skopeo list-tags docker-archive:/tmp/busybox.tar.gz
181       {
182           "Tags": [
183               "busybox:1.28.3"
184           ]
185       }
186
187
188
189       Also supports more than one tags in an archive:
190
191       $ skopeo list-tags docker-archive:/tmp/docker-two-images.tar.gz
192       {
193           "Tags": [
194               "example.com/empty:latest",
195               "example.com/empty/but:different"
196           ]
197       }
198
199
200
201       Will include a source-index entry for each untagged image:
202
203       $ skopeo list-tags docker-archive:/tmp/four-tags-with-an-untag.tar
204       {
205           "Tags": [
206               "image1:tag1",
207               "image2:tag2",
208               "@2",
209               "image4:tag4"
210           ]
211       }
212
213
214
215

SEE ALSO

217       skopeo(1),  skopeo-login(1),  docker-login(1), containers-auth.json(5),
218       containers-transports(1)
219
220

AUTHORS

222       Zach Hill zach@anchore.com ⟨mailto:zach@anchore.com⟩
223
224
225
226                                                         skopeo-list-tags(1)()