1skopeo-list-tags(1)() skopeo-list-tags(1)()
2
6 skopeo-list-tags - List tags in the transport-specific image reposi‐
7 tory.
8
11 skopeo list-tags [options] repository-name
12 Return a list of tags from repository-name in a registry.
15 repository-name name of repository to retrieve tag listing from
18
21 --authfile path
22 Path of the authentication file. Default is ${XDG_RUNTIME_DIR}/contain‐
25 ers/auth.json, which is set using skopeo login.
26 If the authorization state is not found there, $HOME/.docker/con‐
27 fig.json is checked, which is set using docker login.
28 --creds username[:password] for accessing the registry.
31 --cert-dir path
34 Use certificates at path (*.crt, *.cert, *.key) to connect to the reg‐
37 istry.
38 --help, -h
41 Print usage statement
44 --no-creds bool-value
47 Access the registry anonymously.
50 --registry-token Bearer token
53 Bearer token for accessing the registry.
56 --retry-times
59 The number of times to retry. Retry wait time will be exponentially in‐
62 creased based on the number of failed attempts.
63 --tls-verify=bool
66 Require HTTPS and verify certificates when talking to the container
69 registry or daemon. Default to registry.conf setting.
70 --username
73 The username to access the registry.
76 --password
79 The password to access the registry.
82
85 Repository names are transport-specific references as each transport
86 may have its own concept of a "repository" and "tags". Currently, only
87 the Docker transport is supported.
88 This commands refers to repositories using a transport:details format.
91 The following formats are supported:
92 docker://docker-repository-reference
95 A repository in a registry implementing the "Docker Registry HTTP API
96 V2". By default, uses the authorization state in either $XDG_RUN‐
97 TIME_DIR/containers/auth.json, which is set using (skopeo login). If
98 the authorization state is not found there, $HOME/.docker/config.json
99 is checked, which is set using (docker login).
100 A docker-repository-reference is of the form: registry‐
101 host:port/repositoryname which is similar to an image-reference but
102 with no tag or digest allowed as the last component (e.g no :latest or
103 @sha256:xyz)
104 Examples of valid docker-repository-references:
107 "docker.io/myuser/myrepo"
108 "docker.io/nginx"
109 "docker.io/library/fedora"
110 "localhost:5000/myrepository"
111 Examples of invalid references:
113 "docker.io/nginx:latest"
114 "docker.io/myuser/myimage:v1.0"
115 "docker.io/myuser/myimage@sha256:f48c4cc192f4c3c6a069cb5cca6d0a9e34d6076ba7c214fd0cc3ca60e0af76bb"
116
120 Docker Transport
121 To get the list of tags in the "fedora" repository from the docker.io
122 registry (the repository name expands to "library/fedora" per docker
123 transport canonical form):
124 $ skopeo list-tags docker://docker.io/fedora
127 {
128 "Repository": "docker.io/library/fedora",
129 "Tags": [
130 "20",
131 "21",
132 "22",
133 "23",
134 "24",
135 "25",
136 "26-modular",
137 "26",
138 "27",
139 "28",
140 "29",
141 "30",
142 "31",
143 "32",
144 "branched",
145 "heisenbug",
146 "latest",
147 "modular",
148 "rawhide"
149 ]
150 }
151 To list the tags in a local host docker/distribution registry on port
156 5000, in this case for the "fedora" repository:
157 $ skopeo list-tags docker://localhost:5000/fedora
160 {
161 "Repository": "localhost:5000/fedora",
162 "Tags": [
163 "latest",
164 "30",
165 "31"
166 ]
167 }
168
174 skopeo(1), skopeo-login(1), docker-login(1), containers-auth.json(5)
175
178 Zach Hill zach@anchore.com ⟨mailto:zach@anchore.com⟩
179 skopeo-list-tags(1)()