You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
π§° Alternative TypeScript AppHost Toolchains (a id="alternative-typescript-apphost-toolchains")(/a)
TypeScript AppHosts now support Bun, Yarn, and pnpm as alternatives to npm/npx. The CLI auto-detects the active toolchain from project metadata and adjusts install, run, and watch behavior accordingly.
Changes: Support alternative TypeScript AppHost toolchainsΒ #16162
π Documentation required
π BeforeStart Pipeline Steps (a id="beforestart-pipeline-steps")(/a)
New BeforeStart pipeline step support enables ordered execution of BeforeStartEvent subscriptions. This resolves race conditions in complex scenarios such as adding role assignments before the AzureResourcePreparer runs.
Changes: Add support for BeforeStart Pipeline stepsΒ #13780
π Documentation required
π Browser Logs and Network Capture (a id="browser-logs-and-network-capture")(/a)
New WithBrowserLogs(...) API in Aspire.Hosting attaches a child resource to endpoint-capable resources that launches a tracked Chromium browser and streams browser console logs and network activity into Aspire's resource log stream.
Changes: Add tracked browser logs and network captureΒ #16310
π Documentation required
π Docker Compose Polyglot APIs (a id="docker-compose-polyglot-apis")(/a)
TypeScript, Python, and Java AppHosts now have access to the full Docker Compose customization API surface, including ConfigureComposeFile(...) and GetHostAddressExpression(...), previously only available from C# AppHosts.
Changes: Expose missing Docker Compose polyglot APIsΒ #16364
π Documentation required
π Privileged Container Support in Docker Compose (a id="privileged-container-support-in-docker-compose")(/a)
Docker Compose publishing now supports the privileged: true flag for containers that require elevated OS privileges, enabling scenarios such as accessing hardware devices from containerized services.
Changes: Add 'privileged' flag for docker-compose publishingΒ #16075
π Documentation required
App Host improvements
π macOS Dev Certificate Pre-Export (a id="macos-dev-certificate-pre-export")(/a)
On macOS, the developer certificate is now pre-exported to the Aspire cache when created or trusted, eliminating repeated Keychain access prompts when running Aspire applications locally.
Changes: Pre-export dev certificate to Aspire cache to avoid macOS keychain promptsΒ #16282
π TryGetByName for Resource Lookup (a id="trygetbyname-for-resource-lookup")(/a)
Added TryGetByName<T>() as a default interface method on IResourceCollection with a dictionary-backed O(1) implementation, replacing verbose O(n) SingleOrDefault patterns scattered across the codebase.
Changes: Add TryGetByName to IResourceCollectionΒ #16389
π Documentation required
App Host bug fixes
π‘ Fix OTLP Endpoint in Isolated Mode (a id="fix-otlp-endpoint-in-isolated-mode")(/a)
Fixed OTLP endpoint resolution when running with aspire start --isolated (randomized ports). Telemetry data is now correctly routed to the dashboard when DCP assigns dynamic port numbers.
Changes: Fix OTLP endpoint resolution in isolated modeΒ #16367
β¨οΈ CLI
1 new feature, 2 improvements, 3 bug fixes
CLI new features
π€ Non-Interactive CLI Mode (a id="non-interactive-cli-mode")(/a)
New PromptBinding infrastructure in IInteractionService allows CLI commands to resolve prompts directly from flags instead of asking the user interactively. This enables reliable use of aspire commands in scripts and automation pipelines.
Changes: Add PromptBinding infrastructure for non-interactive CLI modeΒ #16235
π Documentation required
CLI improvements
π· F# and VB Support in aspire update (a id="f-and-vb-support-in-aspire-update")(/a) aspire update now upgrades F# (.fsproj) and VB (.vbproj) AppHost projects in addition to C# (.csproj), removing a gap that left non-C# projects unable to use the update command.
Changes: Support upgrading F# and VB projectsΒ #15799
π Richer Markdown Docs Rendering (a id="richer-markdown-docs-rendering")(/a)
The aspire docs command now uses the Markdig library for Markdown rendering, supporting a wider range of formatting elements in documentation output.
Changes: Use Markdig for Aspire CLI docs renderingΒ #16342
CLI bug fixes
π Fix aspire describe Follow Mode Disconnects (a id="fix-aspire-describe-follow-mode-disconnects")(/a) aspire describe --follow now handles graceful disconnects when the AppHost stops or restarts, rather than crashing or hanging indefinitely.
Changes: Handle describe --follow disconnectsΒ #16271
π Fix aspire stop Container Cleanup (a id="fix-aspire-stop-container-cleanup")(/a) aspire stop now correctly terminates all application containers. Previously it killed the entire CLI process tree including DCP, preventing DCP from completing its own container cleanup.
Changes: Fix issue 15806 ("aspire stop" is not cleaning up application containers)Β #16006
π’ Fix Redundant Version Prompt in aspire add (a id="fix-redundant-version-prompt-in-aspire-add")(/a)
When --version is supplied to aspire add, the CLI no longer prompts interactively for the version. The specified version is used directly if found in any available package channel.
Changes: don't prompt for version when --version was suppliedΒ #15527
π Dashboard
1 new feature, 2 improvements, 1 bug fix
Dashboard new features
π Dashboard Telemetry API with Authentication (a id="dashboard-telemetry-api-with-authentication")(/a)
The dashboard's OTLP ingestion API is now enabled by default with API key authentication and automatic login token exchange, significantly improving the standalone aspire otel experience without requiring manual configuration.
Changes: Enable dashboard telemetry API by default with ApiKey auth and login token exchangeΒ #16326
π Documentation required
π¬ Interactive State Column Popover (a id="interactive-state-column-popover")(/a)
The resource state column in the dashboard now shows an interactive popover with clickable links instead of a plain tooltip, making error details and related documentation directly accessible.
Changes: Dashboard: Add InfoPopover for state column with clickable linksΒ #15996
Dashboard bug fixes
π Fix OTLP Histogram Metrics Parsing (a id="fix-otlp-histogram-metrics-parsing")(/a)
Fixed deserialization of OTLP histogram metrics from exporters that send bucketCounts as JSON numbers instead of strings (e.g., VS Code Copilot Chat). These metrics are now correctly parsed and displayed.
Changes: Fix OTLP JSON deserialization of numeric histogram bucketCountsΒ #16376
This changelog is automatically generated. To provide feedback, comment on the Changelog feedback issue
(e.g., "Exclude PR #1234", "Rename: X β Y", "Merge PRs #1234 and #5678").
Table of Contents
What's New
π§ AppHost
5 new features, 2 improvements, 1 bug fix
App Host new features
π§° Alternative TypeScript AppHost Toolchains (a id="alternative-typescript-apphost-toolchains")(/a)
TypeScript AppHosts now support Bun, Yarn, and pnpm as alternatives to npm/npx. The CLI auto-detects the active toolchain from project metadata and adjusts install, run, and watch behavior accordingly.
Changes: Support alternative TypeScript AppHost toolchainsΒ #16162
π Documentation required
π BeforeStart Pipeline Steps (a id="beforestart-pipeline-steps")(/a)
New
BeforeStartpipeline step support enables ordered execution ofBeforeStartEventsubscriptions. This resolves race conditions in complex scenarios such as adding role assignments before theAzureResourcePreparerruns.Changes: Add support for BeforeStart Pipeline stepsΒ #13780
π Documentation required
π Browser Logs and Network Capture (a id="browser-logs-and-network-capture")(/a)
New
WithBrowserLogs(...)API inAspire.Hostingattaches a child resource to endpoint-capable resources that launches a tracked Chromium browser and streams browser console logs and network activity into Aspire's resource log stream.Changes: Add tracked browser logs and network captureΒ #16310
π Documentation required
π Docker Compose Polyglot APIs (a id="docker-compose-polyglot-apis")(/a)
TypeScript, Python, and Java AppHosts now have access to the full Docker Compose customization API surface, including
ConfigureComposeFile(...)andGetHostAddressExpression(...), previously only available from C# AppHosts.Changes: Expose missing Docker Compose polyglot APIsΒ #16364
π Documentation required
π Privileged Container Support in Docker Compose (a id="privileged-container-support-in-docker-compose")(/a)
Docker Compose publishing now supports the
privileged: trueflag for containers that require elevated OS privileges, enabling scenarios such as accessing hardware devices from containerized services.Changes: Add 'privileged' flag for docker-compose publishingΒ #16075
π Documentation required
App Host improvements
π macOS Dev Certificate Pre-Export (a id="macos-dev-certificate-pre-export")(/a)
On macOS, the developer certificate is now pre-exported to the Aspire cache when created or trusted, eliminating repeated Keychain access prompts when running Aspire applications locally.
Changes: Pre-export dev certificate to Aspire cache to avoid macOS keychain promptsΒ #16282
π TryGetByName for Resource Lookup (a id="trygetbyname-for-resource-lookup")(/a)
Added
TryGetByName<T>()as a default interface method onIResourceCollectionwith a dictionary-backed O(1) implementation, replacing verbose O(n)SingleOrDefaultpatterns scattered across the codebase.Changes: Add TryGetByName to IResourceCollectionΒ #16389
π Documentation required
App Host bug fixes
Fixed OTLP endpoint resolution when running with
aspire start --isolated(randomized ports). Telemetry data is now correctly routed to the dashboard when DCP assigns dynamic port numbers.Changes: Fix OTLP endpoint resolution in isolated modeΒ #16367
β¨οΈ CLI
1 new feature, 2 improvements, 3 bug fixes
CLI new features
New
PromptBindinginfrastructure inIInteractionServiceallows CLI commands to resolve prompts directly from flags instead of asking the user interactively. This enables reliable use ofaspirecommands in scripts and automation pipelines.Changes: Add PromptBinding infrastructure for non-interactive CLI modeΒ #16235
π Documentation required
CLI improvements
π· F# and VB Support in aspire update (a id="f-and-vb-support-in-aspire-update")(/a)
aspire updatenow upgrades F# (.fsproj) and VB (.vbproj) AppHost projects in addition to C# (.csproj), removing a gap that left non-C# projects unable to use the update command.Changes: Support upgrading F# and VB projectsΒ #15799
π Richer Markdown Docs Rendering (a id="richer-markdown-docs-rendering")(/a)
The
aspire docscommand now uses the Markdig library for Markdown rendering, supporting a wider range of formatting elements in documentation output.Changes: Use Markdig for Aspire CLI docs renderingΒ #16342
CLI bug fixes
π Fix aspire describe Follow Mode Disconnects (a id="fix-aspire-describe-follow-mode-disconnects")(/a)
aspire describe --follownow handles graceful disconnects when the AppHost stops or restarts, rather than crashing or hanging indefinitely.Changes: Handle describe --follow disconnectsΒ #16271
π Fix aspire stop Container Cleanup (a id="fix-aspire-stop-container-cleanup")(/a)
aspire stopnow correctly terminates all application containers. Previously it killed the entire CLI process tree including DCP, preventing DCP from completing its own container cleanup.Changes: Fix issue 15806 ("aspire stop" is not cleaning up application containers)Β #16006
π’ Fix Redundant Version Prompt in aspire add (a id="fix-redundant-version-prompt-in-aspire-add")(/a)
When
--versionis supplied toaspire add, the CLI no longer prompts interactively for the version. The specified version is used directly if found in any available package channel.Changes: don't prompt for version when
--versionwas suppliedΒ #15527π Dashboard
1 new feature, 2 improvements, 1 bug fix
Dashboard new features
The dashboard's OTLP ingestion API is now enabled by default with API key authentication and automatic login token exchange, significantly improving the standalone
aspire otelexperience without requiring manual configuration.Changes: Enable dashboard telemetry API by default with ApiKey auth and login token exchangeΒ #16326
π Documentation required
Dashboard improvements
π Parameters Page Improvements (a id="parameters-page-improvements")(/a)
The dashboard's Parameters page now includes clickable "set value" links for unset parameters, warning badges highlighting required parameters, and the ability to filter parameters by resource name.
Changes: Dashboard: Parameters page follow-ups - clickable set value, warning badge, filter by resourceΒ #16117
π¬ Interactive State Column Popover (a id="interactive-state-column-popover")(/a)
The resource state column in the dashboard now shows an interactive popover with clickable links instead of a plain tooltip, making error details and related documentation directly accessible.
Changes: Dashboard: Add InfoPopover for state column with clickable linksΒ #15996
Dashboard bug fixes
Fixed deserialization of OTLP histogram metrics from exporters that send
bucketCountsas JSON numbers instead of strings (e.g., VS Code Copilot Chat). These metrics are now correctly parsed and displayed.Changes: Fix OTLP JSON deserialization of numeric histogram bucketCountsΒ #16376
This changelog is automatically generated. To provide feedback, comment on the
Changelog feedback issue
(e.g., "Exclude PR #1234", "Rename: X β Y", "Merge PRs #1234 and #5678").