Skip to content

[docs] Document proxyless container endpoint on-demand allocation (Aspire 13.5)#1199

Draft
aspire-repo-bot[bot] wants to merge 1 commit into
release/13.4from
docs/proxyless-on-demand-allocation-26f4fee58172e063
Draft

[docs] Document proxyless container endpoint on-demand allocation (Aspire 13.5)#1199
aspire-repo-bot[bot] wants to merge 1 commit into
release/13.4from
docs/proxyless-on-demand-allocation-26f4fee58172e063

Conversation

@aspire-repo-bot
Copy link
Copy Markdown
Contributor

Documents changes from microsoft/aspire#17851 by @danegsta.

Targeting release/13.4 — the latest release branch on microsoft/aspire.dev — because release/13.5 (from the source PR milestone 13.5) does not exist there.

Why this PR is needed

Aspire 13.5 adds on-demand port allocation for dynamic proxyless container endpoints (microsoft/aspire#17851). Before this change, referencing a proxyless container endpoint before container creation — for example, to inject the container’s own port as an environment variable — could deadlock or fail because the host port is normally assigned by DCP only after the container is created.

The existing networking-overview page documents proxyless endpoints but does not cover this new resolution behavior.

What changed

Updated src/frontend/src/content/docs/fundamentals/networking-overview.mdx to add a new subsection “Resolving proxyless container endpoints before container creation” under the existing ### Proxyless endpoints section. The new subsection:

  • Explains the problem (deferred host port assignment causing deadlocks).
  • Describes the on-demand allocation behavior added in Aspire 13.5.
  • Provides a C# code example matching the one in the source PR.
  • Notes that if the endpoint is not resolved before container creation, DCP still assigns the host port dynamically.

Files modified

  • src/frontend/src/content/docs/fundamentals/networking-overview.mdx — updated (new subsection added)

Generated by PR Documentation Check for issue #17851 · sonnet46 3.3M ·

Documents the on-demand port allocation behavior for dynamic proxyless
container endpoints introduced in Aspire 13.5 (microsoft/aspire#17851).

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@aspire-repo-bot aspire-repo-bot Bot added the docs-from-code Copilot initiated issue from dotnet/aspire repo label Jun 3, 2026
@aspire-repo-bot aspire-repo-bot Bot requested a review from karolz-ms June 3, 2026 00:11
@aspire-repo-bot
Copy link
Copy Markdown
Contributor Author

Frontend HTML artifact ready

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

VS Code: Open PR #1199 artifacts

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs-from-code Copilot initiated issue from dotnet/aspire repo

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants