https://github.com/tumblr/docker-registry-pruner

Tool to apply retention logic to docker images in a Docker Registry
https://github.com/tumblr/docker-registry-pruner

cleanup docker docker-image docker-image-registry maintenance registry

Last synced: 3 months ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/tumblr/docker-registry-pruner
• Owner: tumblr
• License: apache-2.0
• Created: 2019-06-10T20:45:30.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2020-07-13T22:32:43.000Z (over 4 years ago)
• Last Synced: 2024-10-15T19:41:07.080Z (3 months ago)
• Topics: cleanup, docker, docker-image, docker-image-registry, maintenance, registry
• Language: Go
• Homepage:
• Size: 58.6 KB
• Stars: 129
• Watchers: 8
• Forks: 1
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

• jimsghstars - tumblr/docker-registry-pruner - Tool to apply retention logic to docker images in a Docker Registry (Go)

README

        
# 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](https://img.shields.io/github/release/tumblr/docker-registry-pruner.svg) [![Build Status](https://travis-ci.org/tumblr/docker-registry-pruner.svg?branch=master)](https://travis-ci.org/tumblr/docker-registry-pruner) [![Docker Image](https://img.shields.io/badge/Docker%20Hub-tumblr%2Fdocker--registry--pruner-blue.svg)](https://hub.docker.com/r/tumblr/docker-registry-pruner) ![Docker Automated build](https://img.shields.io/docker/automated/tumblr/docker-registry-pruner.svg) ![Docker Build Status](https://img.shields.io/docker/build/tumblr/docker-registry-pruner.svg) ![MicroBadger Size](https://img.shields.io/microbadger/image-size/tumblr/docker-registry-pruner.svg) ![Docker Pulls](https://img.shields.io/docker/pulls/tumblr/docker-registry-pruner.svg) ![Docker Stars](https://img.shields.io/docker/stars/tumblr/docker-registry-pruner.svg) [![Godoc](https://godoc.org/github.com/tumblr/docker-registry-pruner?status.svg)](http://godoc.org/github.com/tumblr/docker-registry-pruner)

# Documentation

## Quickstart

See [configuration overview](/docs/config.md) 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](/docs/config.md) for how to write config files to apply retention rules to images in your Registry.

# Examples

Check out [docs/examples.md](/docs/examples.md) for examples using the CLI tool.

# Hacking

See [docs/hacking.md](/docs/hacking.md) for how to hack and contribute.

# License

[Apache 2.0](/LICENSE.txt)

Copyright 2019, Tumblr, Inc.