docker-registry-pruner icon indicating copy to clipboard operation
docker-registry-pruner copied to clipboard

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.

GitHub release Build Status Docker Image Docker Automated build Docker Build Status MicroBadger Size Docker Pulls Docker Stars Godoc

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.