images.go RawHistoryFolder

1package domain
2
3import "time"
4
5const DefaultImagePruneKeepLast = 3
6
7// ImagePruneOptions controls which prune subsystems are activated.
8type ImagePruneOptions struct {
9	// KeepLast is the number of most-recent non-latest tags to retain per repository.
10	KeepLast int
11	// PruneDangling enables runtime dangling image cleanup.
12	PruneDangling bool
13	// PruneRegistry enables registry tag retention and blob garbage collection.
14	PruneRegistry bool
15}
16
17// DefaultImagePruneOptions returns options that prune both scopes with the default retention.
18func DefaultImagePruneOptions() ImagePruneOptions {
19	return ImagePruneOptions{
20		KeepLast:      DefaultImagePruneKeepLast,
21		PruneDangling: true,
22		PruneRegistry: true,
23	}
24}
25
26// ImagePruneConfig defines scheduled image cleanup behavior.
27type ImagePruneConfig struct {
28	Enabled  bool
29	Schedule BackupSchedule
30	// KeepLast is the number of most-recent non-latest tags to retain per repository.
31	// The latest tag is retained separately when present.
32	KeepLast int
33}
34
35// RuntimePruneResult reports runtime image cleanup results.
36type RuntimePruneResult struct {
37	DeletedCount int
38	// SpaceReclaimed is reported in bytes.
39	SpaceReclaimed int64
40}
41
42// RegistryPruneResult reports registry cleanup results.
43type RegistryPruneResult struct {
44	TagsRemoved  int
45	BlobsRemoved int
46	// SpaceReclaimed is reported in bytes.
47	SpaceReclaimed int64
48	// UploadsRemoved is the number of stale upload files removed.
49	UploadsRemoved int
50	// UploadSpaceReclaimed is bytes recovered from stale uploads.
51	UploadSpaceReclaimed int64
52}
53
54// ImagePruneReport aggregates runtime and registry cleanup results.
55type ImagePruneReport struct {
56	Runtime  RuntimePruneResult
57	Registry RegistryPruneResult
58}
59
60// ImageInfo describes an image/tag visible from runtime and registry data.
61type ImageInfo struct {
62	Repository string
63	Tag        string
64	// Size is reported in bytes.
65	Size    int64
66	Created time.Time
67	// ID is the runtime image identifier (for example, image ID/digest).
68	ID       string
69	Dangling bool
70}