Skip to content

build: error messages name the real remedy, not a removed builder - #14133

Merged
glours merged 1 commit into
docker:mainfrom
ndeloof:a5-build-error-messages
Aug 27, 2026
Merged

build: error messages name the real remedy, not a removed builder#14133
glours merged 1 commit into
docker:mainfrom
ndeloof:a5-build-error-messages

Conversation

@ndeloof

@ndeloof ndeloof commented Aug 27, 2026

Copy link
Copy Markdown
Contributor

Five classic-builder rejections advertised DOCKER_BUILDKIT=1, a remedy tied to the internal BuildKit builder removed long ago. They now name the actual requirement (buildx plugin installed, DOCKER_BUILDKIT not forced to 0), and the silent buildx-missing fallback warning states its consequences. Only user-visible wording changes (e2e assertions updated).

Epic #14074, section A — split out of #14075 for focused review.

🤖 Generated with Claude Code

The classic-builder rejections said 'set DOCKER_BUILDKIT=1 to use
BuildKit', a leftover from the internal BuildKit builder removed in
af579eb. Since then BuildKit builds go through the buildx plugin:
compose falls back to the classic builder when BuildKit is disabled
(DOCKER_BUILDKIT=0) OR when buildx is not installed — so the advertised
fix does nothing for users who are simply missing buildx.

The five messages now state the actual requirement (buildx installed,
DOCKER_BUILDKIT not forced to 0), and the silent-fallback warning when
buildx is missing now says what the fallback implies instead of a bare
'requires buildx plugin to be installed'.

Part of docker#14074 (A: the code misdescribes its own structure).

Signed-off-by: Nicolas De Loof <nicolas.deloof@gmail.com>

@docker-agent docker-agent left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Assessment: 🟢 APPROVE

The PR is a pure wording-only update: five classic-builder feature-gate errors replaced a stale remedy (DOCKER_BUILDKIT=1) with accurate guidance (install buildx, don't force DOCKER_BUILDKIT=0), and the silent buildx-missing fallback warning now explains its consequences. No logic, control flow, or data handling is changed. The new messages are substantively more accurate than the old ones.

@codecov

codecov Bot commented Aug 27, 2026

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 28.57143% with 5 lines in your changes missing coverage. Please review.

Files with missing lines Patch % Lines
pkg/compose/build_classic.go 40.00% 3 Missing ⚠️
pkg/compose/build_bake.go 0.00% 2 Missing ⚠️

📢 Thoughts on this report? Let us know!

@glours glours left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

LGTM

@glours
glours merged commit 8fbda26 into docker:main Aug 27, 2026
50 of 51 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants