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

NAME

6       skopeo-list-tags  -  Return a list of tags the transport-specific image
7       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 podman 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

REPOSITORY NAMES

44       Repository names are transport-specific references  as  each  transport
45       may  have its own concept of a "repository" and "tags". Currently, only
46       the Docker transport is supported.
47
48
49       This commands refers to repositories using a transport:details  format.
50       The following formats are supported:
51
52
53       docker://docker-repository-reference
54         A repository in a registry implementing the "Docker Registry HTTP API
55       V2". By default, uses  the  authorization  state  in  either  $XDG_RUN‐
56       TIME_DIR/containers/auth.json,  which  is  set using (podman login). If
57       the authorization state is not found  there,  $HOME/.docker/config.json
58       is checked, which is set using (docker login).
59         A    docker-repository-reference    is   of   the   form:   registry‐
60       host:port/repositoryname which is similar  to  an  image-reference  but
61       with  no tag or digest allowed as the last component (e.g no :latest or
62       @sha256:xyz)
63
64
65                Examples of valid docker-repository-references:
66                  "docker.io/myuser/myrepo"
67                  "docker.io/nginx"
68                  "docker.io/library/fedora"
69                  "localhost:5000/myrepository"
70
71                Examples of invalid references:
72                  "docker.io/nginx:latest"
73                  "docker.io/myuser/myimage:v1.0"
74                  "docker.io/myuser/myimage@sha256:f48c4cc192f4c3c6a069cb5cca6d0a9e34d6076ba7c214fd0cc3ca60e0af76bb"
75
76
77

EXAMPLES

79   Docker Transport
80       To get the list of tags in the "fedora" repository from  the  docker.io
81       registry  (the  repository  name expands to "library/fedora" per docker
82       transport canonical form):
83
84
85              $ skopeo list-tags docker://docker.io/fedora
86              {
87                  "Repository": "docker.io/library/fedora",
88                  "Tags": [
89                      "20",
90                      "21",
91                      "22",
92                      "23",
93                      "24",
94                      "25",
95                      "26-modular",
96                      "26",
97                      "27",
98                      "28",
99                      "29",
100                      "30",
101                      "31",
102                      "32",
103                      "branched",
104                      "heisenbug",
105                      "latest",
106                      "modular",
107                      "rawhide"
108                  ]
109              }
110
111
112
113
114       To list the tags in a local host docker/distribution registry  on  port
115       5000, in this case for the "fedora" repository:
116
117
118              $ skopeo list-tags docker://localhost:5000/fedora
119              {
120                  "Repository": "localhost:5000/fedora",
121                  "Tags": [
122                      "latest",
123                      "30",
124                      "31"
125                  ]
126              }
127
128
129
130
131

SEE ALSO

133       skopeo(1), podman-login(1), docker-login(1)
134
135

AUTHORS

137       Zach Hill zach@anchore.com ⟨mailto:zach@anchore.com⟩
138
139
140
141                                                         skopeo-list-tags(1)()