Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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)()

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>

home | help