skopeo-list-tags - Man Page
List image names in a transport-specific collection of images.
Synopsis
skopeo list-tags [options] source-image
Return a list of tags from source-image in a registry or a local docker-archive file.
source-image name of the repository to retrieve a tag listing from or a local docker-archive file.
Options
See also skopeo(1) for options placed before the subcommand name.
- --authfile path
- Path of the authentication file. Default is ${XDG_RUNTIME_DIR}/containers/auth.json, which is set using skopeo login.
If the authorization state is not found there, $HOME/.docker/config.json is checked, which is set using docker login. - --creds username[:password]
- for accessing the registry.
- --cert-dir path
- Use certificates at path (*.crt, *.cert, *.key) to connect to the registry.
- --help, -h
- Print usage statement
- --no-creds
- Access the registry anonymously.
- --registry-token Bearer token
- Bearer token for accessing the registry.
- --retry-times
- The number of times to retry. Retry wait time will be exponentially increased based on the number of failed attempts.
- --tls-verify=bool
- Require HTTPS and verify certificates when talking to the container registry or daemon. Default to registry.conf setting.
- --username
- The username to access the registry.
- --password
- The password to access the registry.
Repository Names
Repository names are transport-specific references as each transport may have its own concept of a "repository" and "tags".
This commands refers to repositories using a transport:details format. The following formats are supported:
docker://docker-repository-reference
A repository in a registry implementing the "Docker Registry HTTP API V2". By default, uses the authorization state in either $XDG_RUNTIME_DIR/containers/auth.json, which is set using (skopeo login). If the authorization state is not found there, $HOME/.docker/config.json is checked, which is set using (docker login).
A docker-repository-reference is of the form: registryhost:port/repositoryname which is similar to an image-reference but with no tag or digest allowed as the last component (e.g no :latest or @sha256:xyz)
Examples of valid docker-repository-references: "docker.io/myuser/myrepo" "docker.io/nginx" "docker.io/library/fedora" "localhost:5000/myrepository" Examples of invalid references: "docker.io/nginx:latest" "docker.io/myuser/myimage:v1.0" "docker.io/myuser/myimage@sha256:f48c4cc192f4c3c6a069cb5cca6d0a9e34d6076ba7c214fd0cc3ca60e0af76bb"
**docker-archive:path[:docker-reference]
more than one images were stored in a docker save-formatted file.
Examples
Docker Transport
To get the list of tags in the "fedora" repository from the docker.io registry (the repository name expands to "library/fedora" per docker transport canonical form):
$ skopeo list-tags docker://docker.io/fedora { "Repository": "docker.io/library/fedora", "Tags": [ "20", "21", "22", "23", "24", "25", "26-modular", "26", "27", "28", "29", "30", "31", "32", "branched", "heisenbug", "latest", "modular", "rawhide" ] }
To list the tags in a local host docker/distribution registry on port 5000, in this case for the "fedora" repository:
$ skopeo list-tags docker://localhost:5000/fedora { "Repository": "localhost:5000/fedora", "Tags": [ "latest", "30", "31" ] }
Docker-archive Transport
To list the tags in a local docker-archive file:
$ skopeo list-tags docker-archive:/tmp/busybox.tar.gz { "Tags": [ "busybox:1.28.3" ] }
Also supports more than one tags in an archive:
$ skopeo list-tags docker-archive:/tmp/docker-two-images.tar.gz { "Tags": [ "example.com/empty:latest", "example.com/empty/but:different" ] }
Will include a source-index entry for each untagged image:
$ skopeo list-tags docker-archive:/tmp/four-tags-with-an-untag.tar { "Tags": [ "image1:tag1", "image2:tag2", "@2", "image4:tag4" ] }
See Also
skopeo(1), skopeo-login(1), docker-login(1), containers-auth.json(5), containers-transports(1)
Authors
Zach Hill zach@anchore.com ⟨mailto:zach@anchore.com⟩