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

NAME

6       skopeo-list-tags  -  Return  a  list of tags for the transport-specific
7       image repository.
8
9

SYNOPSIS

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

REPOSITORY NAMES

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

EXAMPLES

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

SEE ALSO

136       skopeo(1), skopeo-login(1), docker-login(1), containers-auth.json(5)
137
138

AUTHORS

140       Zach Hill zach@anchore.com ⟨mailto:zach@anchore.com⟩
141
142
143
144                                                         skopeo-list-tags(1)()
Impressum