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

FreeBSD Manual Pages

  
 
  

home | help
skopeo-delete(1)()					    skopeo-delete(1)()

NAME
       skopeo-delete  -	 Mark  the  image-name	for later deletion by the reg-
       istry's garbage collector.

SYNOPSIS
       skopeo delete [options] image-name

DESCRIPTION
       Mark image-name for deletion.  The effect of this is registry-specific;
       many registries dont support this operation, or dont allow it  in  some
       circumstances / configurations.

       WARNING:	 If  image-name	contains a digest, this	affects	the referenced
       manifest, and may delete	all  tags  (within  the	 current  repository?)
       pointing	to that	manifest.

       WARNING:	 If  image-name	contains a tag (but not	a digest), in the cur-
       rent version of Skopeo this resolves the	tag into a  digest,  and  then
       deletes	the  manifest by digest, as described above (possibly deleting
       all tags	pointing to that manifest, not just the	 provided  tag).  This
       behavior	may change in the future.

       When using the github.com/distribution/distribution registry server: To
       release	the allocated disk space, you must login to the	container reg-
       istry server and	execute	 the  container	 registry  garbage  collector.
       E.g.,

       /usr/bin/registry garbage-collect /etc/docker-distribution/registry/config.yml

       Note:  sometimes	 the config.yml	is stored in /etc/docker/registry/con-
       fig.yml

       If you are running the container	registry inside	 of  a	container  you
       would execute something like:

       $ docker	exec -it registry /usr/bin/registry garbage-collect /etc/docker-distribution/registry/config.yml

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
       environment variable.

       --creds username[:password]

       Credentials for accessing the registry.

       --cert-dir path

       Use certificates	at path	(*.crt,	*.cert,	*.key) to connect to the  reg-
       istry.

       --daemon-host host

       Use docker daemon host at host (docker-daemon: transport	only)

       --help, -h

       Print usage statement

       --no-creds

       Access the registry anonymously.

       Additionally,  the  registry  must  allow  deletions  by	 setting  REG-
       ISTRY_STORAGE_DELETE_ENABLED=true for the registry daemon.

       --registry-token	token

       Bearer token for	accessing the registry.

       --retry-times

       The number of times to retry.

       --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
       registry	or daemon. Default to registry.conf setting.

       --username

       The username to access the registry.

       --password

       The password to access the registry.

EXAMPLES
       Mark  image  example/pause  for	deletion from the registry.example.com
       registry:

       $ skopeo	delete docker://registry.example.com/example/pause:latest

       See above for additional	details	on using the command delete.

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-delete(1)()

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=skopeo-delete&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help