spotify/docker-gcArchived
Docker Gc
docker-gc is a garbage collection tool for Docker hosts designed to reclaim disk space by automatically removing exited containers, unused images, and dangling volumes. It functions as a resource cleaner that optimizes host storage through the lifecycle management of orphaned or inactive container resources.
The utility manages image retention by preserving a minimum number of the most recent images per repository while deleting older versions. It employs configurable grace periods to determine when images and containers become eligible for deletion and supports pattern-based exclusion to prevent specific assets from being targeted.
The tool covers a broad range of maintenance operations, including state-driven resource selection to identify candidates for removal and the purging of temporary artifacts to maintain system health.
Features
- Unused Container Resource Pruning - Provides a CLI tool for removing dangling images, stopped containers, and unused volumes to reclaim host disk space.
- Container Maintenance - Automates the cleanup of temporary Docker artifacts to maintain the health of development and production servers.
- Container Image Retention Policies - Implements chronological pruning of Docker images while respecting minimum retention counts per repository.
- Container Storage Optimization - Prevents Docker host disk exhaustion by cleaning up orphaned containers and volumes.
- Container State Filtering - Identifies candidates for removal by filtering for specific states like exited containers or dangling volumes.
- Container Garbage Collection - Provides automated garbage collection for unused container images, exited containers, and dangling volumes.
- Dangling Volume Cleanup - Purges dangling Docker volumes and unused resources to prevent host disk space exhaustion.
- Repository-Aware Image Retention - Tracks the most recent images per repository to maintain a minimum count of preserved builds.
- Unused Image Pruning - Removes unused or old Docker images to reclaim disk space on the host system.
- Container Lifecycle Cleanup - Automatically deletes exited Docker containers based on age or specific grace periods.
- Docker Engine API Clients - Utilizes the Docker Engine API to programmatically query and delete host containers, images, and volumes.
- Docker - Purges inactive Docker resources based on configurable grace periods and retention rules.
- Image Version Retention Management - Preserves a minimum number of recent Docker images while deleting older versions.
- Image Version Retention - Keeps a specified minimum number of the most recent images for each repository to avoid deleting active versions.
- Resource Identifier Matching Protections - Prevents specific Docker resources from being garbage collected by matching name patterns or unique identifiers.
- Resource Deletion - Provides configurable grace periods to ensure only resources older than a specific threshold are deleted.
- Container Utilities - Automated garbage collection for containers and images.
