skopeo-inspect(1)

NAME

skopeo-inspect - Return low-level information about image-name in a registry.

SYNOPSIS

skopeo inspect [options] image-name

DESCRIPTION

Return low-level information about image-name in a registry

image-name name of image to retrieve information about

OPTIONS

--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.

--cert-dir path

Use certificates at path (*.crt, *.cert, *.key) to connect to the registry.

--config

Output configuration in OCI format, default is to format in JSON format.

--creds username[:password]

Username and password for accessing the registry.

--format, -f=format

Format the output using the given Go template. The keys of the returned JSON can be used as the values for the --format flag (see examples below).

--no-creds

Access the registry anonymously.

--raw

Output raw manifest or config data depending on --config option. The --format option is not supported with --raw option.

--registry-token Bearer token

Registry 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

Require HTTPS and verify certificates when talking to container registries (defaults to true).

EXAMPLES

To review information for the image fedora from the docker.io registry:

    $ skopeo inspect docker://docker.io/fedora
    {
        "Name": "docker.io/library/fedora",
        "Digest": "sha256:a97914edb6ba15deb5c5acf87bd6bd5b6b0408c96f48a5cbd450b5b04509bb7d",
        "RepoTags": [
    	"20",
    	"21",
    	"22",
    	"23",
    	"24",
    	"heisenbug",
    	"latest",
    	"rawhide"
        ],
        "Created": "2016-06-20T19:33:43.220526898Z",
        "DockerVersion": "1.10.3",
        "Labels": {},
        "Architecture": "amd64",
        "Os": "linux",
        "Layers": [
    	"sha256:7c91a140e7a1025c3bc3aace4c80c0d9933ac4ee24b8630a6b0b5d8b9ce6b9d4"
        ]
    }

    $ /bin/skopeo inspect --config docker://registry.fedoraproject.org/fedora --format "{{ .Architecture }}"
    amd64

    $ /bin/skopeo inspect --format '{{ .Env }}' docker://registry.access.redhat.com/ubi8
    [PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin container=oci]

SEE ALSO

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

AUTHORS

Antonio Murdaca runcom@redhat.com ⟨mailto:runcom@redhat.com⟩, Miloslav Trmac mitr@redhat.com ⟨mailto:mitr@redhat.com⟩, Jhon Honce jhonce@redhat.com ⟨mailto:jhonce@redhat.com⟩