skopeo-list-tags(1)

NAME

skopeo-list-tags - 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-delay

Fixed delay between retries. If not set (or set to 0s), 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⟩