build: garbage collection page #16032
Conversation
✅ Deploy Preview for docsdocker ready!
To edit notification comments on pull requests, go to your Netlify site settings. |
There was a problem hiding this comment.
Woo a page on buildkit gc 🎉
I wonder about page naming - maybe we could call it "Build cache garbage collection"? We have different types of gc in docker, with networks/volumes/containers/images and now build, so it might get confusing when searching for information?
I think it's good to have build cache gc information in the build cache section, but we should x-link it from wherever we talk about the other forms of cache (if that exists?).
| ``` | ||
| GC Policy rule#0: | ||
| All: false | ||
| Filters: type==source.local,type==exec.cachemount,type==source.git.checkout | ||
| Keep Duration: 48h0m0s | ||
| Keep Bytes: 512MB | ||
| GC Policy rule#1: | ||
| All: false | ||
| Keep Duration: 1440h0m0s | ||
| Keep Bytes: 26GB | ||
| GC Policy rule#2: | ||
| All: false | ||
| Keep Bytes: 26GB | ||
| GC Policy rule#3: | ||
| All: true | ||
| Keep Bytes: 26GB | ||
| ``` |
There was a problem hiding this comment.
Where does this come from, it looks like command output? (partly for curiosity, but also we should include the command used so that users can check their own policies themselves).
There was a problem hiding this comment.
I'm using buildctl to retrieve this info from a BuildKit container:
$ docker exec -it buildx_buildkit_builder20 buildctl debug workers -v
ID: vhcmyn5zy0ub763bj4thm0l6c
Platforms: linux/amd64,linux/amd64/v2,linux/amd64/v3,linux/arm64,linux/riscv64,linux/ppc64le,linux/s390x,linux/386,linux/mips64le,linux/mips64,linux/arm/v7,linux/arm/v6
BuildKit: github.com/moby/buildkit v0.10.0-607-gf394afc59.m f394afc591a578537c3242a09c8b876db14a6d7f.m
Labels:
org.mobyproject.buildkit.worker.executor: oci
org.mobyproject.buildkit.worker.hostname: docker-desktop
org.mobyproject.buildkit.worker.network: host
org.mobyproject.buildkit.worker.oci.process-mode: sandbox
org.mobyproject.buildkit.worker.snapshotter: overlayfs
GC Policy rule#0:
All: false
Filters: type==source.local,type==exec.cachemount,type==source.git.checkout
Keep Duration: 48h0m0s
Keep Bytes: 512MB
GC Policy rule#1:
All: false
Keep Duration: 1440h0m0s
Keep Bytes: 26GB
GC Policy rule#2:
All: false
Keep Bytes: 26GB
GC Policy rule#3:
All: true
Keep Bytes: 26GBMaybe we could add this in buildx when inspecting a builder? 🤔
There was a problem hiding this comment.
Default policies:
There was a problem hiding this comment.
Oh awesome, ok, let's not put that command in then, since it's a bit fiddly 😄
There was a problem hiding this comment.
Maybe we could add this in buildx when inspecting a builder? 🤔
Yes! That would be really useful info to pull through 🎉
|
Moving to draft as it needs #16036 for cross links to BuildKit config. |
crazy-max
force-pushed
the
build-cache-gc
branch
from
7b84071
to
3c1dd3f
Compare
Signed-off-by: CrazyMax <crazy-max@users.noreply.github.com>
crazy-max
force-pushed
the
build-cache-gc
branch
from
3c1dd3f
to
1947bec
Compare
needs #16036related to docker/cli#2864 and moby/buildkit#1169
Was wondering if we should split this page and add some bits to dockerd reference page and BuildKit repo but I think it's fine to have it there as we already have all kind of information about caching. We could also cross link in a follow-up.
Also adds a new
Cachesection. Let me know if that sgty.Signed-off-by: CrazyMax crazy-max@users.noreply.github.com