1skopeo-list-tags(1)() skopeo-list-tags(1)()
2
3
4
6 skopeo-list-tags - Return a list of tags for the transport-specific
7 image repository.
8
9
11 skopeo list-tags repository-name
12
13
14 Return a list of tags from repository-name in a registry.
15
16
17 repository-name name of repository to retrieve tag listing from
18
19
20 --authfile path
21
22
23 Path of the authentication file. Default is ${XDG_RUNTIME_DIR}/contain‐
24 ers/auth.json, which is set using skopeo login.
25 If the authorization state is not found there, $HOME/.docker/con‐
26 fig.json is checked, which is set using docker login.
27
28
29 --creds username[:password] for accessing the registry.
30
31
32 --cert-dir path Use certificates at path (*.crt, *.cert, *.key) to con‐
33 nect to the registry.
34
35
36 --tls-verify bool-value Require HTTPS and verify certificates when
37 talking to container registries (defaults to true).
38
39
40 --no-creds bool-value Access the registry anonymously.
41
42
43 --registry-token Bearer token for accessing the registry.
44
45
47 Repository names are transport-specific references as each transport
48 may have its own concept of a "repository" and "tags". Currently, only
49 the Docker transport is supported.
50
51
52 This commands refers to repositories using a transport:details format.
53 The following formats are supported:
54
55
56 docker://docker-repository-reference
57 A repository in a registry implementing the "Docker Registry HTTP API
58 V2". By default, uses the authorization state in either $XDG_RUN‐
59 TIME_DIR/containers/auth.json, which is set using (skopeo login). If
60 the authorization state is not found there, $HOME/.docker/config.json
61 is checked, which is set using (docker login).
62 A docker-repository-reference is of the form: registry‐
63 host:port/repositoryname which is similar to an image-reference but
64 with no tag or digest allowed as the last component (e.g no :latest or
65 @sha256:xyz)
66
67
68 Examples of valid docker-repository-references:
69 "docker.io/myuser/myrepo"
70 "docker.io/nginx"
71 "docker.io/library/fedora"
72 "localhost:5000/myrepository"
73
74 Examples of invalid references:
75 "docker.io/nginx:latest"
76 "docker.io/myuser/myimage:v1.0"
77 "docker.io/myuser/myimage@sha256:f48c4cc192f4c3c6a069cb5cca6d0a9e34d6076ba7c214fd0cc3ca60e0af76bb"
78
79
80
82 Docker Transport
83 To get the list of tags in the "fedora" repository from the docker.io
84 registry (the repository name expands to "library/fedora" per docker
85 transport canonical form):
86
87
88 $ skopeo list-tags docker://docker.io/fedora
89 {
90 "Repository": "docker.io/library/fedora",
91 "Tags": [
92 "20",
93 "21",
94 "22",
95 "23",
96 "24",
97 "25",
98 "26-modular",
99 "26",
100 "27",
101 "28",
102 "29",
103 "30",
104 "31",
105 "32",
106 "branched",
107 "heisenbug",
108 "latest",
109 "modular",
110 "rawhide"
111 ]
112 }
113
114
115
116
117 To list the tags in a local host docker/distribution registry on port
118 5000, in this case for the "fedora" repository:
119
120
121 $ skopeo list-tags docker://localhost:5000/fedora
122 {
123 "Repository": "localhost:5000/fedora",
124 "Tags": [
125 "latest",
126 "30",
127 "31"
128 ]
129 }
130
131
132
133
134
136 skopeo(1), skopeo-login(1), docker-login(1), containers-auth.json(5)
137
138
140 Zach Hill zach@anchore.com ⟨mailto:zach@anchore.com⟩
141
142
143
144 skopeo-list-tags(1)()