How to accelerate Harbor garbage collection (GC)

[microyahoo]

In the current production environment, the rate of image creation far exceeds the speed of GC, leading to a continuous increase in the storage space occupied by the image registry. Taking the deletion of simulation-jobs/single-frame sha256:1a4b70b3af7b490abe4edc67b3292fb5698b10f94b552a0681cde5d95fed599b as an example, deleting a single manifest takes 34 minutes. Currently, GC is performed by only 5 workers, resulting in extremely low efficiency.

2026-01-13T05:01:07Z [INFO] [/jobservice/job/impl/gc/garbage_collection.go:341]: [1793abe8-d830-4887-841d-3cc5f5562ad7][1457/25453] delete the manifest with registry v2 API: simulation-jobs/single-frame, application/vnd.docker.distribution.manifest.v2+json, sha256:1a4b70b3af7b490abe4edc67b3292fb5698b10f94b552a0681cde5d95fed599b
......
2026-01-13T05:35:46Z [INFO] [/jobservice/job/impl/gc/garbage_collection.go:370]: [1793abe8-d830-4887-841d-3cc5f5562ad7][1457/25453] delete manifest from storage: sha256:1a4b70b3af7b490abe4edc67b3292fb5698b10f94b552a0681cde5d95fed599b
2026-01-13T05:35:47Z [INFO] [/jobservice/job/impl/gc/garbage_collection.go:398]: [1793abe8-d830-4887-841d-3cc5f5562ad7][1457/25453] delete artifact blob record from database: 199444, simulation-jobs/single-frame, sha256:1a4b70b3af7b490abe4edc67b3292fb5698b10f94b552a0681cde5d95fed599b
2026-01-13T05:35:48Z [INFO] [/jobservice/job/impl/gc/garbage_collection.go:406]: [1793abe8-d830-4887-841d-3cc5f5562ad7][1457/25453] delete artifact trash record from database: 199444, simulation-jobs/single-frame, sha256:1a4b70b3af7b490abe4edc67b3292fb5698b10f94b552a0681cde5d95fed599b
2026-01-13T05:35:48Z [INFO] [/jobservice/job/impl/gc/garbage_collection.go:424]: [1793abe8-d830-4887-841d-3cc5f5562ad7][1457/25453] delete blob from storage: sha256:1a4b70b3af7b490abe4edc67b3292fb5698b10f94b552a0681cde5d95fed599b
2026-01-13T05:35:48Z [INFO] [/jobservice/job/impl/gc/garbage_collection.go:398]: [c9856df5-bd21-4246-856e-6bfc111fbebb][1478/25453] delete artifact blob record from database: 203349, simulation-jobs/single-frame, sha256:1da0f957b9427abf66b0f2c3009ab80ef29c365a29767f6fab87195a5ef112d2
2026-01-13T05:35:48Z [INFO] [/jobservice/job/impl/gc/garbage_collection.go:406]: [c9856df5-bd21-4246-856e-6bfc111fbebb][1478/25453] delete artifact trash record from database: 203349, simulation-jobs/single-frame, sha256:1da0f957b9427abf66b0f2c3009ab80ef29c365a29767f6fab87195a5ef112d2
2026-01-13T05:35:48Z [INFO] [/jobservice/job/impl/gc/garbage_collection.go:424]: [c9856df5-bd21-4246-856e-6bfc111fbebb][1478/25453] delete blob from storage: sha256:1da0f957b9427abf66b0f2c3009ab80ef29c365a29767f6fab87195a5ef112d2
2026-01-13T05:35:48Z [INFO] [/jobservice/job/impl/gc/garbage_collection.go:453]: [1793abe8-d830-4887-841d-3cc5f5562ad7][1457/25453] delete blob record from database: 2132964, sha256:1a4b70b3af7b490abe4edc67b3292fb5698b10f94b552a0681cde5d95fed599b

https://github.com/goharbor/harbor/blob/v2.11.0/src/jobservice/job/impl/gc/garbage_collection.go#L336-L370
https://github.com/goharbor/harbor/blob/v2.11.0/src/jobservice/job/impl/gc/util.go#L41C1-L53C2
https://github.com/goharbor/harbor/blob/v2.11.0/src/pkg/registry/client.go#L333-L357

gc.log

[wy65701436]

What storage type are you using? Please try the latest version of Harbor, as we’ve increased the worker count to 10.