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⟩