Skip to content

docs: restart BuildKit after worker configuration - #5280

Open
git-jxj wants to merge 1 commit into
containerd:mainfrom
git-jxj:docs/buildkit-worker-reload
Open

git-jxj wants to merge 1 commit into
containerd:mainfrom
git-jxj:docs/buildkit-worker-reload

Conversation

@git-jxj

@git-jxj git-jxj commented Oct 20, 2026

Copy link
Copy Markdown
Contributor

Write the rootful containerd-worker configuration before enabling BuildKit, then restart the service so an already running daemon uses the new worker settings. The previous sequence started the service before editing its configuration and left it running with the old settings.

Validated with a private BuildKit 0.34.0 daemon and empty task-owned containerd namespaces: replaying the old command order leaves the worker on its original namespace, while the corrected order switches it to the configured namespace. Service actions were mapped to the private daemon; host systemd and configuration were not changed. The daemon, socket, state directory and namespaces were removed afterward. Codespell, make lint-commits and git diff --check passed.

AI assistance was used in preparing this contribution.

Save the containerd-worker configuration before enabling BuildKit, then
restart the service to load the new settings even if it is already
running. Starting the daemon before editing its configuration leaves
the old worker configuration active.

Signed-off-by: xinjun.jiang <xinjun.jiang@daocloud.io>
Comment thread docs/build.md
After saving the configuration, enable and restart BuildKit so a running daemon uses the updated worker settings:

```
$ sudo systemctl enable buildkit

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

enable --now does not work?

Comment thread docs/build.md
```

Then add the following configuration to `/etc/buildkit/buildkitd.toml` to enable containerd worker.
Add the following configuration to `/etc/buildkit/buildkitd.toml` to enable containerd worker.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is not needed for OCI worker mode.

@AkihiroSuda AkihiroSuda added the documentation Improvements or additions to documentation label Oct 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants