FreeBSD Manual Pages
skopeo-inspect(1)() skopeo-inspect(1)() NAME skopeo-inspect - Return low-level information about image-name in a reg- istry. 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 primary registry credentials file. On Linux, the default is ${XDG_RUNTIME_DIR}/containers/auth.json. See containers-auth.json(5) for more details about the credential search mechanism and defaults on other platforms. Use skopeo login to manage the credentials. The default value of this option is read from the REGISTRY\_AUTH\_FILE en- vironment variable. --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-Tem- plate_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. By default, no retries are attempted. --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. --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 reg- istry 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, the RepoTags array will be empty. Defaults to false, 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 Tr- mac mitr@redhat.com <mailto:mitr@redhat.com>, Jhon Honce jhonce@redhat.com <mailto:jhonce@redhat.com> skopeo-inspect(1)()
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | SEE ALSO | AUTHORS
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=skopeo-inspect&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>