github.com/stone-payments/gcd
go get github.com/stone-payments/gcd

github.com/stone-payments/gcd

🐳 Garbage Collector for Docker

by stone-payments

v0.0.0-20171031024548-bb2636666868 (see all)License:MIT
go get github.com/stone-payments/gcd
Readme

gcd

Build Status Coverage Status Go Report Card

Description

This project is a garbage collector for docker images and containers. It was created to alleviate the problem of old and unused containers laying around on Docker utilizing storage resources.

Usage

Running locally built ELF

./bin/gcd

Running pre-built Docker image from Docker Hub

docker run --name gcd -v /var/run/docker.sock:/var/run/docker.sock guiferpa/gcd

Parameters

gcd can be parametrized via command-line arguments and, if you're using the Docker image, by environment variables.

CLI arguments

  • -docker-host: set docker host target (default: /var/run/docker.sock).
  • -sweep-interval: set interval in seconds between sweeps (default: 60).
  • -remove-images: remove images that aren't container dependencies (default: true).
  • -remove-healthy-containers-exited: remove containers exited with code 0 (default: true).

Environment variables

  • GCD_DOCKER_HOST: set docker host target (default: /var/run/docker.sock).
  • GCD_SWEEP_INTERVAL: set interval in seconds between sweeps (default: 60).
  • GCD_REMOVE_IMAGES: remove images that aren't container dependencies (default: true).
  • GCD_REMOVE_HEALTHY_CONTAINERS_EXITED: remove containers exited with code 0 (default: true).

Building

Building ELF

git clone https://github.com/stone-payments/gcd.git
make build

Building docker image

⚠️ This project uses multi-stage build to build the docker image with the included Dockerfile. Docker >=17.05 is required.

make build-image

License

This code is licensed under the MIT license.

GitHub Stars

11

LAST COMMIT

5yrs ago

MAINTAINERS

0

CONTRIBUTORS

5

OPEN ISSUES

1

OPEN PRs

0
VersionTagPublished
v0.0.0-20171031024548-bb2636666868
1yr ago
No alternatives found
No tutorials found
Add a tutorial