skopeo-inspect - Man Page
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. See skopeo(1) for the format of image-name.
The default output includes data from various sources: user input (Name), the remote repository, if any (RepoTags), the top-level manifest (Digest), and a per-architecture/OS image matching the current run-time environment (most other values). To see values for a different architecture/OS, use the --override-os / --override-arch options documented in skopeo(1).
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 usingdocker 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.
- --daemon-host host
- Use docker daemon host at host (
docker-daemon:
transport only) - --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). Supports the Go templating functions available at https://pkg.go.dev/github.com/containers/common/pkg/report#hdr-Template_Functions
- --help, -h
- Print usage statement
- --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.
- --shared-blob-dir directory
- Directory to use to share blobs across OCI repositories.
- --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.
- --no-tags, -n
- Do not list the available tags from the repository in the output. When
true
, theRepoTags
array will be empty. Defaults tofalse
, which includes all available tags.
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:f99efcddc4dd6736d8a88cc1ab6722098ec1d77dbf7aed9a7a514fc997ca08e0", "RepoTags": [ "20", "21", "..." ], "Created": "2022-11-16T07:26:42.618327645Z", "DockerVersion": "20.10.12", "Labels": { "maintainer": "Clement Verna \u003ccverna@fedoraproject.org\u003e" }, "Architecture": "amd64", "Os": "linux", "Layers": [ "sha256:cb8b1ed77979b894115a983f391465651aa7eb3edd036be4b508eea47271eb93" ], "LayersData": [ { "MIMEType": "application/vnd.docker.image.rootfs.diff.tar.gzip", "Digest": "sha256:cb8b1ed77979b894115a983f391465651aa7eb3edd036be4b508eea47271eb93", "Size": 65990920, "Annotations": null } ], "Env": [ "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin", "DISTTAG=f37container", "FGC=f37", "FBR=f37" ] }
To inspect python from the docker.io registry and not show the available tags:
$ skopeo inspect --no-tags docker://docker.io/library/python { "Name": "docker.io/library/python", "Digest": "sha256:10fc14aa6ae69f69e4c953cffd9b0964843d8c163950491d2138af891377bc1d", "RepoTags": [], "Created": "2022-11-16T06:55:28.566254104Z", "DockerVersion": "20.10.12", "Labels": null, "Architecture": "amd64", "Os": "linux", "Layers": [ "sha256:a8ca11554fce00d9177da2d76307bdc06df7faeb84529755c648ac4886192ed1", "sha256:e4e46864aba2e62ba7c75965e4aa33ec856ee1b1074dda6b478101c577b63abd", "..." ], "LayersData": [ { "MIMEType": "application/vnd.docker.image.rootfs.diff.tar.gzip", "Digest": "sha256:a8ca11554fce00d9177da2d76307bdc06df7faeb84529755c648ac4886192ed1", "Size": 55038615, "Annotations": null }, { "MIMEType": "application/vnd.docker.image.rootfs.diff.tar.gzip", "Digest": "sha256:e4e46864aba2e62ba7c75965e4aa33ec856ee1b1074dda6b478101c577b63abd", "Size": 5164893, "Annotations": null }, "..." ], "Env": [ "PATH=/usr/local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin", "LANG=C.UTF-8", "...", ] }
$ /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⟩