cleanup

type CleanupHandler struct {
	// contains filtered or unexported fields
}

type CleanupService struct {
	// contains filtered or unexported fields
}

type CleanupStatusReporter struct {
	// contains filtered or unexported fields
}

type CleanupStatusSnapshot struct {
	LastRun              time.Time `json:"lastRun"`
	OldImagesRemoved     int       `json:"oldImagesRemoved"`
	SpaceImagesRemoved   int       `json:"spaceImagesRemoved"`
	BytesFreed           int64     `json:"bytesFreed"`
	BuildCacheBytesFreed int64     `json:"buildCacheBytesFreed,omitempty"`
	DiskUsedPercent      float64   `json:"diskUsedPercent"`
	Errors               []string  `json:"errors,omitempty"`
}

type Config struct {
	// CleanupInterval is required: the cleanup service does not start if this
	// is non-positive.
	CleanupInterval Duration `json:"cleanupInterval"`

	// CleanOldImages enables removal of images older than ImageMaximumAgeForGC.
	CleanOldImages       bool     `json:"cleanOldImages"`
	ImageMaximumAgeForGC Duration `json:"imageMaximumAgeForGC"`

	// CleanImagesAtStorageLimit enables disk-threshold-driven image removal.
	CleanImagesAtStorageLimit bool `json:"cleanImagesAtStorageLimit"`
	// CleanupStartHostThresholdPercent must be in (0, 100] and
	// strictly greater than CleanupEndHostThresholdPercent when CleanImagesAtStorageLimit is true.
	CleanupStartHostThresholdPercent float64 `json:"cleanupStartHostThresholdPercent"`
	// CleanupEndHostThresholdPercent must be in (0, 100) and
	// strictly less than CleanupStartHostThresholdPercent when CleanImagesAtStorageLimit is true.
	CleanupEndHostThresholdPercent float64 `json:"cleanupEndHostThresholdPercent"`

	// MinAge is the minimum image age for phase-2 candidates. 0 = any age.
	MinAge Duration `json:"minAge"`

	// MaximumImagesPerInterval caps phase-2 removals per cycle. 0 = unlimited.
	// This cap does NOT apply to phase 1.
	MaximumImagesPerInterval int `json:"maximumImagesPerInterval"`

	// ExcludedImages lists image references never removed by either phase.
	// Each entry is matched against the image's "repository:tag" reference:
	//   - An entry with ":" is an exact match (e.g. "nginx:1.25.3").
	//   - An entry without ":" matches any tag of that repository (e.g. "nginx").
	//
	// All entries are normalised before matching, so "docker.io/library/nginx"
	// and "nginx" are equivalent. To protect an image from a private registry,
	// include the registry hostname: "harbor.example.com/myorg/myapp".
	// A bare name like "nginx" does NOT protect "harbor.example.com/nginx:latest".
	ExcludedImages []string `json:"excludedImages"`

	// ClearBuildCache controls whether the Docker build cache is pruned during
	// the storage-limit cleanup phase when disk usage exceeds the start threshold.
	// Build cache pruning runs before image removal; if it brings disk usage below
	// the threshold, image removal is skipped entirely for that cycle.
	ClearBuildCache bool `json:"clearBuildCache"`
}

type Duration time.Duration

type StorageUsage struct {
	// RootDir is the path used to determine disk capacity (always dockerDataPath).
	RootDir string
	// DockerBytes is the total bytes consumed by Docker artifacts:
	// images, container writable layers, volumes, and build cache.
	// This is NOT total disk used — other processes on the same disk are excluded.
	// See sumDockerBytes for the exact accounting.
	DockerBytes uint64
	// ImageBytes is the deduplicated image layer data (LayersSize from docker system df).
	ImageBytes uint64
	// ContainerBytes is the sum of writable-layer sizes across all containers (SizeRw).
	// Image layers are excluded to avoid double-counting with ImageBytes.
	ContainerBytes uint64
	// VolumeBytes is the sum of known volume sizes. Volumes with unknown sizes
	// (e.g. non-local drivers) are excluded.
	VolumeBytes uint64
	// BuildCacheBytes is the sum of all build cache entry sizes.
	BuildCacheBytes uint64
	// TotalBytes is the total capacity of the partition hosting the Docker data directory.
	TotalBytes uint64
	// AvailableBytes is the bytes available to unprivileged processes on that partition.
	// Total non-Docker disk used = TotalBytes - AvailableBytes - DockerBytes.
	AvailableBytes uint64
}