Understanding and Managing Storage in Docker Harbor

Docker Harbor is an open-source, enterprise-grade container registry that provides a secure and scalable solution for storing, managing, and distributing Docker images. As a registry, its storage consumption is a critical metric for administrators to monitor and control. Understanding how to assess and manage this storage is essential for maintaining a healthy and efficient infrastructure.

Checking Individual Image Sizes

To begin, you may need to inspect the size of specific Docker images stored within your Harbor instance. This can be done directly on the host where the Docker daemon is runing using the docker image ls command. This provides a quick overview of the storage footprint of each image.

docker image ls --format "table {{.Repository}}:{{.Tag}}\t{{.Size}}"

Checking Total Storage Consumption

For a comprehensive view of the storage used by the entire Harbor registry, you can utilize the official Harbor CLI tool. This command connects to you're Harbor instance and reports on the total storage metrics, including the amount of space used and the amount remaining.

docker run --rm harbor-cli:v2.5.0 show storage --format json

The output from this command will provide a detailed breakdown of the storage status, helping you understand the overall capacity and usage.

Strategies for Storage Management

Proactively managing storage is key to preventing issues. Here are several effective strategies:

• Periodic Cleanup: Establish a routine to identify and remove old, unused, or obsolete images. This prevents the accumulation of unnecessary data and frees up valuable disk space.
• Setting Storage Quotas: Configure project-level or user-level storage quotas within Harbor. This enforces limits and prevents any single project or user from consuming all available storage.
• Utilizing Image Replication: Leverage Harbor's replication feature to synchronize images between different registry instances. This can help reduce redundant storage by sharing a single copy of an image across multiple locations.