FreeBSD Manual Pages
skopeo-inspect(1)() 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. 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 mani- fest (Digest), and a per-architecture/OS image matching the current run-time environment (most other values). To see values for a differ- ent 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}/contain- ers/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 reg- istry. --config Output configuration in OCI format, default is to format in JSON for- mat. --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 re- turned JSON can be used as the values for the --format flag (see exam- ples 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; retry wait time will be exponentially in- creased 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, the RepoTags array will be empty. Defaults to false, which in- cludes 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 avail- able 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@red- hat.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+14.3.quarterly>
