tumblr / docker-registry-pruner

Tool to apply retention logic to docker images in a Docker Registry

docker-registry-pruner 🐳✂️

docker-registry-pruner is a rules-based tool that applies business logic to docker images in a Docker Registry storage system for retention.

Documentation

Quickstart

See configuration overview for how to write a config file. Then, map it into your container and run the report!

$ docker run -ti -v $(pwd)/config:/app/config --rm tumblr/docker-registry-pruner --mode report --config ./config/myconfig.yaml

Once you are happy with the report, you can perform pruning! WARNING: this is destructive!

$ docker run -ti -v $(pwd)/config:/app/config --rm tumblr/docker-registry-pruner --mode prune --config ./config/myconfig.yaml

Configuration

See the configuration overview for how to write config files to apply retention rules to images in your Registry.

Examples

Check out docs/examples.md for examples using the CLI tool.

Hacking

See docs/hacking.md for how to hack and contribute.

License

Apache 2.0

Copyright 2019, Tumblr, Inc.