Skip to content

docs: clarify local container builds and OS requirements for aspire deploy - #1702

Draft
David Pine (IEvangelist) with Copilot wants to merge 2 commits into
mainfrom
copilot/update-cl1-documentation
Draft

David Pine (IEvangelist) with Copilot wants to merge 2 commits into
mainfrom
copilot/update-cl1-documentation

Conversation

Copilot AI commented Sep 19, 2026 •

Copy link
Copy Markdown
Contributor

The CLI docs omit that .NET container images are built locally during deployment. On Windows, Docker Desktop’s container mode can therefore cause Linux image builds to fail before deployment.

  • Local builds: Explain that .NET images are built on the machine running aspire deploy, before image push or deployment.
  • Container OS: Clarify that the local runtime’s Linux/Windows mode must match the AppHost image—not necessarily the host OS.
  • Windows guidance: Direct Docker Desktop users targeting Linux images to Switch to Linux containers.

Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>
Copilot AI changed the title [WIP] Update CLI documentation for local dotnet container steps docs: clarify local container builds and OS requirements for aspire deploy Sep 19, 2026
@aspire-repo-bot

Copy link
Copy Markdown
Contributor

Frontend HTML artifact ready

The latest frontend build uploaded the frontend-dist artifact for PR #1702. Use the VS Code button below to open this PR with GitHub Artifacts Explorer and browse the built HTML locally.

VS Code: Open PR #1702 artifacts

This comment updates automatically when a new frontend build artifact is uploaded.

Copy link
Copy Markdown
Member

docs-pr-reviewer report — [partial — phase A: key claims evaluated; phase B: not run (docs site was not served in this automated run)]

Recommendation: approve

Source used: microsoft/aspire main (CLI deploy behavior)
PR status: draft, mergeable, Copilot-agent authored, opened 2026-09-19 — STALE (~45 days); 2 files incl. a unit test.

Phase A — claims

  • ⚠️ nuance: claim that .NET images are built locally on the machine running aspire deploy and that Docker Desktop container mode must match the AppHost image OS is plausible and low-risk but was not traced to source.
  • Draft: mark ready after confirming wording.

Phase B — doc-tester

Not run; rendering of the changed pages is not browser-checked.

🤖 Posted by aspire.dev - squad (AI Agent)

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.

[docs] Missing information about the dotnet container steps around image being built locally

2 participants