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 registry's
     garbage collector.

SYNOPSIS
     skopeo delete [options] image-name

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

     WARNING: If image-name contains a digest, this affects the referenced mani-
     fest, 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 current
     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 re-
     lease  the  allocated  disk space, you must login to the container registry
     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/config.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  en-
     vironment variable.

     --creds username[:password]

     Credentials for accessing the registry.

     --cert-dir path

     Use certificates at path (*.crt, *.cert, *.key) to connect to the registry.

     --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 REGISTRY_STOR-
     AGE_DELETE_ENABLED=true for the registry daemon.

     --registry-token token

     Bearer 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.

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

     $ 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 Tr-
     mac mitr@redhat.com <mailto:mitr@redhat.com>, Jhon Honce  jhonce@redhat.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.1.quarterly>

home | help