From 438ec770a80107b558399072563d233b3878013a Mon Sep 17 00:00:00 2001 From: "aspire-repo-bot[bot]" <268009190+aspire-repo-bot[bot]@users.noreply.github.com> Date: Mon, 24 Aug 2026 17:53:49 +0000 Subject: [PATCH 01/13] docs: add troubleshooting note for DevTunnel URL publication fix Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- .../content/docs/integrations/devtools/dev-tunnels.mdx | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx b/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx index f028fe4b2..6c4d58416 100644 --- a/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx +++ b/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx @@ -299,6 +299,15 @@ Verify that: - You're using the correct tunnel URL - Anonymous access is configured correctly if accessing without authentication +#### Dashboard doesn't show a tunnel URL + +In Aspire 13.5, dev tunnel resources could reach the *Running* and *Healthy* +states in the dashboard without ever publishing a public URL. This was fixed +in Aspire 13.6: dev tunnel endpoints stay unallocated until the integration +publishes the real tunnel endpoint, so the dashboard and MCP resource +snapshots now show the tunnel URL as expected. If you still don't see a URL, +update to Aspire 13.6 or later. + ## See also - [Dev tunnels overview](https://learn.microsoft.com/azure/developer/dev-tunnels/overview) From 9ca28f5a73911b5286c38f60093e515278b7cdc3 Mon Sep 17 00:00:00 2001 From: Karol Zadora-Przylecki Date: Mon, 28 Sep 2026 15:14:11 -0700 Subject: [PATCH 02/13] Apply suggestion from @alistairmatthews Co-authored-by: Alistair Matthews --- .../src/content/docs/integrations/devtools/dev-tunnels.mdx | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx b/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx index 6c4d58416..51db7bb31 100644 --- a/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx +++ b/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx @@ -29,7 +29,9 @@ Dev tunnels are useful for: - Sharing a running local service (for example, a Web API) with teammates, mobile devices, or webhooks - Testing incoming callbacks from external SaaS systems (GitHub / Stripe / etc.) without deploying -- Quickly publishing a temporary, TLS-terminated endpoint during development +- Sharing a running local service (for example, a Web API) with teammates, mobile devices, or webhooks. +- Testing incoming callbacks from external SaaS systems (GitHub / Stripe / etc.) without deploying. +- Quickly publishing a temporary, TLS-terminated endpoint during development. ## Configuration - +Use the following properties to configure you dev tunnels: ### Dev tunnel options The `DevTunnelOptions` class provides several configuration options: From 7b1f335e093bd73af58025ff60bc880ab3290eac Mon Sep 17 00:00:00 2001 From: Karol Zadora-Przylecki Date: Mon, 28 Sep 2026 15:16:23 -0700 Subject: [PATCH 06/13] Apply suggestion from @alistairmatthews Co-authored-by: Alistair Matthews --- .../src/content/docs/integrations/devtools/dev-tunnels.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx b/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx index 4574d3323..ef8d3e688 100644 --- a/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx +++ b/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx @@ -262,7 +262,7 @@ The `DevTunnelPortOptions` class provides configuration for individual tunnel po | `Labels` | Labels to apply to this port | | `AllowAnonymous` | Whether to allow anonymous access to this specific port | -### Security considerations +## Security recommendations - Prefer authenticated tunnels during normal development - Only enable anonymous access for endpoints that are safe to expose publicly From 9b230805fd88b684f0940dd4caf38fcc5b1d14fb Mon Sep 17 00:00:00 2001 From: Karol Zadora-Przylecki Date: Mon, 28 Sep 2026 15:16:34 -0700 Subject: [PATCH 07/13] Apply suggestion from @alistairmatthews Co-authored-by: Alistair Matthews --- .../src/content/docs/integrations/devtools/dev-tunnels.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx b/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx index ef8d3e688..e9e5be32a 100644 --- a/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx +++ b/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx @@ -268,7 +268,7 @@ The `DevTunnelPortOptions` class provides configuration for individual tunnel po - Only enable anonymous access for endpoints that are safe to expose publicly - Treat public tunnel URLs as temporary & untrusted (rate limit / validate input server-side) -### Tunnel lifecycle +## Tunnel lifecycle Dev tunnels automatically: From 00b84188df4f37fdf32dea371dae0b3df0ae1cb6 Mon Sep 17 00:00:00 2001 From: Karol Zadora-Przylecki Date: Mon, 28 Sep 2026 15:16:47 -0700 Subject: [PATCH 08/13] Apply suggestion from @alistairmatthews Co-authored-by: Alistair Matthews --- .../src/content/docs/integrations/devtools/dev-tunnels.mdx | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx b/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx index e9e5be32a..c52c173bc 100644 --- a/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx +++ b/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx @@ -276,7 +276,11 @@ Dev tunnels automatically: - Ensure the user is logged in to the dev tunnels service - Create and manage tunnel lifecycle - Clean up unmodeled ports from previous runs -- Provide detailed logging and diagnostics +- Install the devtunnel CLI if not already available. +- Ensure the user is logged in to the dev tunnels service. +- Create and manage tunnel lifecycle. +- Clean up unmodeled ports from previous runs. +- Provide detailed logging and diagnostics. Tunnels will expire after not being hosted for 30 days by default, so they won't be forcibly deleted when the resource or AppHost is stopped. From 3a25aae7a4ccf015fba662d23870f939550f2636 Mon Sep 17 00:00:00 2001 From: Karol Zadora-Przylecki Date: Mon, 28 Sep 2026 15:17:00 -0700 Subject: [PATCH 09/13] Apply suggestion from @alistairmatthews Co-authored-by: Alistair Matthews --- .../src/content/docs/integrations/devtools/dev-tunnels.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx b/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx index c52c173bc..56eab8989 100644 --- a/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx +++ b/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx @@ -284,7 +284,7 @@ Dev tunnels automatically: Tunnels will expire after not being hosted for 30 days by default, so they won't be forcibly deleted when the resource or AppHost is stopped. -### Troubleshooting +## Troubleshooting #### Authentication required From 5de512618a2cdf41e81460315e2e5da5a9239df1 Mon Sep 17 00:00:00 2001 From: Karol Zadora-Przylecki Date: Mon, 28 Sep 2026 15:17:08 -0700 Subject: [PATCH 10/13] Apply suggestion from @alistairmatthews Co-authored-by: Alistair Matthews --- .../src/content/docs/integrations/devtools/dev-tunnels.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx b/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx index 56eab8989..405090add 100644 --- a/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx +++ b/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx @@ -286,7 +286,7 @@ Tunnels will expire after not being hosted for 30 days by default, so they won't ## Troubleshooting -#### Authentication required +### Authentication required If you see authentication errors, ensure you're logged in to the dev tunnels service: From 34b0bbf263ac79ef15c198c914a58cd55dfa83ad Mon Sep 17 00:00:00 2001 From: Karol Zadora-Przylecki Date: Mon, 28 Sep 2026 15:17:19 -0700 Subject: [PATCH 11/13] Apply suggestion from @alistairmatthews Co-authored-by: Alistair Matthews --- .../src/content/docs/integrations/devtools/dev-tunnels.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx b/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx index 405090add..0d164c883 100644 --- a/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx +++ b/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx @@ -294,7 +294,7 @@ If you see authentication errors, ensure you're logged in to the dev tunnels ser devtunnel user login ``` -#### Port conflicts +### Port conflicts If you encounter port binding issues, check that no other processes are using the same ports, or configure different ports for your endpoints. From 065695d584ceeb5256fad3baa48e36694271defe Mon Sep 17 00:00:00 2001 From: Karol Zadora-Przylecki Date: Mon, 28 Sep 2026 15:17:28 -0700 Subject: [PATCH 12/13] Apply suggestion from @alistairmatthews Co-authored-by: Alistair Matthews --- .../src/content/docs/integrations/devtools/dev-tunnels.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx b/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx index 0d164c883..982b1528c 100644 --- a/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx +++ b/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx @@ -298,7 +298,7 @@ devtunnel user login If you encounter port binding issues, check that no other processes are using the same ports, or configure different ports for your endpoints. -#### Tunnel not accessible +### Tunnel not accessible Verify that: From fe756e591ca059cefa5eb874eb132cf7e5efce71 Mon Sep 17 00:00:00 2001 From: Karol Zadora-Przylecki Date: Mon, 28 Sep 2026 15:17:39 -0700 Subject: [PATCH 13/13] Apply suggestion from @alistairmatthews Co-authored-by: Alistair Matthews --- .../src/content/docs/integrations/devtools/dev-tunnels.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx b/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx index 982b1528c..18506ac35 100644 --- a/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx +++ b/src/frontend/src/content/docs/integrations/devtools/dev-tunnels.mdx @@ -306,7 +306,7 @@ Verify that: - You're using the correct tunnel URL - Anonymous access is configured correctly if accessing without authentication -#### Dashboard doesn't show a tunnel URL +### Dashboard doesn't show a tunnel URL In Aspire 13.5, dev tunnel resources could reach the *Running* and *Healthy* states in the dashboard without ever publishing a public URL. This was fixed