Skip to content

Commit b64e6db

Browse files
committed
buildkit: windows: add a note for managed containerd process
If you run two instanced of `containerd` one being used by the standalone `buildkitd.exe` and another one being managed by `dockerd.exe`, you end up with some conflicts and errors like: ``` hcsshim::ImportLayer failed in Win32: Cannot create a file when that file already exists. (0xb7) ``` This fix adds a note to guide the user to use only one instance of `containerd` instead, if for this purpose.
1 parent 52ac823 commit b64e6db

File tree

1 file changed

+4
-1
lines changed

1 file changed

+4
-1
lines changed

content/manuals/build/buildkit/_index.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -154,7 +154,7 @@ see [GitHub issues](https://github.com/moby/buildkit/issues?q=is%3Aissue%20state
154154
4. Download and extract the latest BuildKit release.
155155

156156
```powershell
157-
$version = "v0.13.1" # specify the release version, v0.13+
157+
$version = "v0.22.0" # specify the release version, v0.13+
158158
$arch = "amd64" # arm64 binary available too
159159
curl.exe -LO https://github.com/moby/buildkit/releases/download/$version/buildkit-$version.windows-$arch.tar.gz
160160
# there could be another `.\bin` directory from containerd instructions
@@ -184,6 +184,9 @@ see [GitHub issues](https://github.com/moby/buildkit/issues?q=is%3Aissue%20state
184184
```console
185185
> buildkitd.exe
186186
```
187+
> [!NOTE]
188+
> If you are running a _dockerd-managed_ `containerd` process, use that instead, by supplying the address:
189+
> `buildkitd.exe --containerd-worker-addr "npipe:////./pipe/docker-containerd"`
187190
188191
7. In another terminal with administrator privileges, create a remote builder that uses the local BuildKit daemon.
189192

0 commit comments

Comments
 (0)