Add dedicated documentation for DCP container networking tunnel by Copilot · Pull Request #530 · microsoft/aspire.dev

Copilot · 2026-03-09T16:48:06Z

Create new documentation page fundamentals/container-networking.mdx
Add sidebar entry and cross-reference from networking-overview.mdx
Wrap tunnel steps in <Steps> component (review feedback)
Use OsAwareTabs with bash/PowerShell tabs for shell commands (review feedback)
Fix intro paragraph: broaden language beyond .NET, define DCP on first use with link to architecture content
Verify rendering with dev server — page and DCP link confirmed working
Run code review
Run CodeQL checker

Screenshots

Updated intro with DCP link and broader language:

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

…ixes #325) Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>

IEvangelist

This PR looks good so far, but let's double check it for accuracy by using the .github/skills/doc-tester/SKILL.md skill. Please also consider all new comments and feedback/suggestions. @copilot

src/frontend/src/content/docs/fundamentals/container-networking.mdx

IEvangelist · 2026-03-12T12:16:09Z

please also link to architecture content that contains details for DCP

Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>

Copilot · 2026-03-12T12:21:42Z

This PR looks good so far, but let's double check it for accuracy by using the .github/skills/doc-tester/SKILL.md skill. Please also consider all new comments and feedback/suggestions. @copilot

Addressed both review comments in 0bb13c3:

Wrapped the tunnel steps in a <Steps> component
Replaced the bash-only block with OsAwareTabs showing both bash and PowerShell

Ran doc-tester validation: all 5 internal links return HTTP 200, Steps component renders numbered steps correctly, and both OS tabs (bash/PowerShell) display and switch as expected.

IEvangelist

@copilot please see my comment

IEvangelist · 2026-03-13T12:15:31Z

src/frontend/src/content/docs/fundamentals/container-networking.mdx

+import { Aside, Steps } from '@astrojs/starlight/components';
+import OsAwareTabs from '@components/OsAwareTabs.astro';
+
+During local development, your Aspire app model often includes a mix of container resources and host-based services (such as .NET projects or executables). Container-to-container communication works naturally over the bridge network, but containers that need to reach services running on the host require a different approach. Aspire solves this with the **container tunnel**, a DCP capability that provides reliable, transparent container-to-host connectivity.


Instead of .NET projects or executables we should say something about C#, TypeScript, Python, as we support much more than just .NET.

Also, DCP is mentioned before it's defined in the following paragraph. We need to fix that and please also link to architecture content that contains details for DCP

Fixed in 3f8702e — broadened to "C#, Python, or TypeScript projects", moved the full "Developer Control Plane (DCP)" definition to the intro paragraph with a link to the architecture overview, and updated the next paragraph to use just "DCP" since it's already defined.

Copilot

Pull request overview

Adds a dedicated Fundamentals doc page explaining Aspire’s DCP container tunnel (container-to-host connectivity), and links it from existing networking documentation so readers can discover the feature and how to enable it.

Changes:

Added new fundamentals/container-networking.mdx page documenting the container tunnel, network identifiers, and enablement via ASPIRE_ENABLE_CONTAINER_TUNNEL.
Added a cross-reference from fundamentals/networking-overview.mdx to the new page.
Added a sidebar entry for “Container networking”.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 3 comments.

File	Description
src/frontend/src/content/docs/fundamentals/networking-overview.mdx	Adds a pointer to the new container networking/tunnel documentation.
src/frontend/src/content/docs/fundamentals/container-networking.mdx	New dedicated doc page describing the DCP container tunnel, network identifiers, and opt-in instructions.
src/frontend/config/sidebar/docs.topics.ts	Adds the new Fundamentals sidebar entry (with translated labels).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

You can also share your feedback on Copilot code review. Take the survey.

src/frontend/src/content/docs/fundamentals/networking-overview.mdx

  [service discovery](/fundamentals/service-discovery/).
 </Aside>

+When containers need to reach host-based services, Aspire can use the **container tunnel** to provide reliable connectivity. For more information, see [Container networking](/fundamentals/container-networking/).


src/frontend/src/content/docs/fundamentals/container-networking.mdx

+import { Aside, Steps } from '@astrojs/starlight/components';
+import OsAwareTabs from '@components/OsAwareTabs.astro';
+
+During local development, your Aspire app model often includes a mix of container resources and host-based services (such as .NET projects or executables). Container-to-container communication works naturally over the bridge network, but containers that need to reach services running on the host require a different approach. Aspire solves this with the **container tunnel**, a DCP capability that provides reliable, transparent container-to-host connectivity.


src/frontend/src/content/docs/fundamentals/container-networking.mdx

…e with architecture link Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>

Copilot · 2026-03-13T12:22:17Z

please also link to architecture content that contains details for DCP

Added in 3f8702e — the intro paragraph now links DCP to /architecture/overview/#developer-control-plane on first mention, and the See Also section already had that link as well.

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Initial plan

8763f8d

Copilot AI assigned Copilot and IEvangelist Mar 9, 2026

Copilot started work on behalf of IEvangelist March 9, 2026 16:48 View session

Add container networking documentation page for DCP container tunnel (f…

e083260

…ixes #325) Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>

Copilot AI changed the title ~~[WIP] Fix issue 325 using doc writer skill~~ Add dedicated documentation for DCP container networking tunnel Mar 9, 2026

Copilot finished work on behalf of IEvangelist March 9, 2026 16:59

IEvangelist approved these changes Mar 12, 2026

View reviewed changes

src/frontend/src/content/docs/fundamentals/container-networking.mdx Show resolved Hide resolved

src/frontend/src/content/docs/fundamentals/container-networking.mdx Show resolved Hide resolved

Copilot started work on behalf of IEvangelist March 12, 2026 12:15 View session

Wrap steps in Steps component and use OsAwareTabs with PowerShell option

0bb13c3

Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>

Copilot finished work on behalf of IEvangelist March 12, 2026 12:22

IEvangelist reviewed Mar 13, 2026

View reviewed changes

IEvangelist marked this pull request as ready for review March 13, 2026 12:17

Copilot AI review requested due to automatic review settings March 13, 2026 12:17

Copilot started work on behalf of IEvangelist March 13, 2026 12:17 View session

Copilot started reviewing on behalf of IEvangelist March 13, 2026 12:18 View session

Copilot AI reviewed Mar 13, 2026

View reviewed changes

Broaden intro to mention C#/Python/TypeScript, define DCP on first us…

3f8702e

…e with architecture link Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>

Copilot AI requested a review from IEvangelist March 13, 2026 12:23

Copilot finished work on behalf of IEvangelist March 13, 2026 12:23

Potential fix for pull request finding

29370b8

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add dedicated documentation for DCP container networking tunnel#530

Add dedicated documentation for DCP container networking tunnel#530
Copilot wants to merge 5 commits intomainfrom
copilot/fix-issue-325

Copilot AI commented Mar 9, 2026 •

edited

Loading

Uh oh!

IEvangelist left a comment

Uh oh!

Uh oh!

Uh oh!

IEvangelist commented Mar 12, 2026

Uh oh!

Copilot AI commented Mar 12, 2026

Uh oh!

IEvangelist left a comment

Uh oh!

IEvangelist Mar 13, 2026

Uh oh!

Copilot AI Mar 13, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Copilot AI commented Mar 13, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

Copilot AI commented Mar 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Screenshots

Uh oh!

IEvangelist left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

IEvangelist commented Mar 12, 2026

Uh oh!

Copilot AI commented Mar 12, 2026

Uh oh!

IEvangelist left a comment

Choose a reason for hiding this comment

Uh oh!

IEvangelist Mar 13, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Mar 13, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Copilot AI commented Mar 13, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Copilot AI commented Mar 9, 2026 •

edited

Loading