Skip to content

cmd/docker: Add guidance for unavailable cloud plugins - #7358

Merged
vvoland merged 1 commit into
docker:masterfrom
nico1510:cloud-plugin-guidance
Oct 7, 2026
Merged

vvoland merged 1 commit into
docker:masterfrom
nico1510:cloud-plugin-guidance

Conversation

@nico1510

@nico1510 nico1510 commented Oct 7, 2026 •

Copy link
Copy Markdown
Member

Follow up to #7343.

Summary

When docker --cloud cannot find the Offload plugin, tell users: "to use --cloud, install Docker Desktop. See https://docs.docker.com/go/cloud-flag/". Invalid plugins and plugins without --cloud support retain their diagnostic details and include the same guidance.

Keep Docker Desktop guidance specific to the Offload plugin so configured providers receive accurate errors. Use standard default-value handling in the resolution tests to keep their complexity within the lint limit while preserving every test case.

Validation: all 90 CLI unit-test packages pass with Go 1.27.1, and the repository's pinned docker buildx bake lint check passes.

Documentation prerequisite: docker/docs#26303 adds https://docs.docker.com/go/cloud-flag/. Publish the redirect before merging.

@codecov-commenter

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 75.00000% with 2 lines in your changes missing coverage. Please review.

Files with missing lines Patch % Lines
cmd/docker/cloud.go 75.00% 1 Missing and 1 partial ⚠️

📢 Thoughts on this report? Let us know!

@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

@nico1510
nico1510 marked this pull request as ready for review October 7, 2026 12:40

@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.

This review covers only the commits since 216e638.

Assessment: 🟢 APPROVE

Comment thread cmd/docker/cloud.go Outdated
// the __resolve-context contract.
const cloudResolverFeature = "cloud-context-resolver"

const cloudPluginHelp = "Docker Desktop is required to use --cloud.\n" +

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.

nit: could simplify with `To use --cloud, install Docker Desktop. See [docs])

@vvoland vvoland added this to the 29.9.0 milestone Oct 7, 2026
Comment thread cmd/docker/cloud.go Outdated
Explain how to install the Offload plugin when --cloud cannot find it,
and link to the cloud flag documentation. Preserve diagnostic details
for invalid or incompatible plugins and limit installation guidance
to Offload.

Use standard default-value handling in the resolution tests to satisfy
the lint complexity limit without changing test coverage.

Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com>
Signed-off-by: Nicolas Beck <nicolas.beck@docker.com>
@nico1510
nico1510 force-pushed the cloud-plugin-guidance branch from 78ad450 to 374636f Compare October 7, 2026 16:48
@vvoland
vvoland force-pushed the cloud-plugin-guidance branch 3 times, most recently from 31a8ac8 to 374636f Compare October 7, 2026 16:51
@vvoland vvoland closed this Oct 7, 2026
@vvoland vvoland reopened this Oct 7, 2026
@vvoland
vvoland merged commit e8c098c into docker:master Oct 7, 2026
122 of 209 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants