Features¶
- removing tags
- running garbage-collect
- cleaning empty repos (without tags)
- cleaning tags with regex and semantic versioning
- removing unknown tags
- no configuration changes in real registry service
State of Docker Registry¶
Workarounds for versions 2.6+ of Docker Registry.
See https://github.com/docker/distribution/issues/1811
Safe tag deletion¶
Docker Registry has no native support for deleting single tag from an image.
Fortunatelly it is possible to workaround this problem so Docker Registry Cleaner will safely remove tag from image, without removing image itself. The process is quite simple:
- find tags to remove
- upload fake image
- re-tag found tags to new image
- remove image with REST API call
Remove empty repositories¶
There is no way to remove repository using REST API, even one without tags - empty repo is still listed by registry.
Currently files should be cleaned on GC run on registry side (or some third party app, like this one).