Kleaner

Kleaner - Container Registry Cleaner for Kubernetes

Kleaner is a script that cleans up a Container Registry (currently Azure only) by deleting images that are not used by any Kubernetes resources. It does this by getting a list of images in the cluster and then deleting all images in the Container Registry that are not in the list. Additionally, the deleted images must be older than the specified time. This is to prevent deleting images that are release candidates. It also deletes any repo that ends with /cache.

Usage

Prerequisites

• kubectl with read access to the Kubernetes cluster
• Azure CLI with write access to the Container Registry

./kleaner.sh REGISTRY <ONLY_OLDER_THAN>

Example

./kleaner.sh myregistry 7d

Why Kleaner?

The more images you push to a Container Registry, the more usage it will incur. Over time, this can add up to a significant amount of money. This is especially true if you are using a private Container Registry. This is why it is important to clean up the Container Registry from time to time.

Caveats

• The script only works with Azure Container Registries.
• The Container Registry must exclusively be used to host images for the Kubernetes cluster.
• The date command in the script only works on macOS.

Disclaimer

Kleaner is not responsible for any damage caused by using this script. Kleaner is provided as-is, without warranty of any kind, express or implied. Use at your own risk.

Kleaner is written by Hossam Hammady and is licensed under the MIT License.