dalee/hitman repository overview

⁠Docker registry companion

Companion tool for Private Docker Registry.

⁠Features

• Browse Registry
• Delete images from Registry
• more coming..

⁠Requirements

• Registry 2.6+⁠
• CLI access to host where Registry is running

⁠Prebuilt docker image

Run somewhere on Docker enabled host:

$ docker pull dalee/hitman
$ docker run \
    -p 4000:4000 \
    -e MACARON_ENV=production \
    -e REGISTRY_URL=https://registry.example.com:5000/ \
    dalee/hitman

Put command to your favourite scheduler (cron, ci, etc..)

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

Where docker.registry is name of container running Docker Registry.

⁠Common pitfalls

• There are no auth, so, restrict access to UI via frontend (NGINX deny/allow for example)
• Multiple tags could point to single digest (you can have latest and v1.0.1 tags, but they actually single image, so be careful)
• Tag deletion will not frees you hard drive space until garbage-collect command is issued
• Depending on storage driver, you may have to manually delete empty repositories (ui will show you hint)

⁠Licensing

Software is licensed under the Apache License, Version 2.0. See LICENSE for the full license text.