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
TypeScript AppHosts can now use alternative package managers and runtimes (such as bun) beyond the default npm/node toolchain.
Changes: Support alternative TypeScript AppHost toolchainsΒ #16162
π― Azure Kubernetes Service (AKS) Hosting Support
New Aspire.Hosting.Azure.Kubernetes package with AddAzureKubernetesEnvironment() β provisions AKS clusters and configures workload identity, monitoring, and networking via Bicep.
Changes: Add Azure Kubernetes Service (AKS) hosting supportΒ #16088
π Documentation required
π± ASPIRE_ENVIRONMENT Environment Variable DistributedApplicationBuilder now reads the ASPIRE_ENVIRONMENT environment variable to configure the environment name, enabling environment-specific behaviors without code changes.
Changes: Read ASPIRE_ENVIRONMENT in DistributedApplicationBuilderΒ #16098
ποΈ BeforeStart Pipeline Steps
Support for dependency-ordered BeforeStart pipeline steps lets you reliably control initialization order (e.g., run custom steps before Azure resource provisioning).
Changes: Add support for BeforeStart Pipeline stepsΒ #13780
π Documentation required
π³ Docker Compose Podman Support
First-class Podman support for Docker Compose deploy and a new unified IContainerRuntimeResolver that auto-detects the best available container runtime. aspire doctor now shows all runtimes with status and explains which is active.
Changes: Add Podman support for Docker Compose deploy and unify container runtime abstractionΒ #16074 β οΈBreaking change
π Documentation required
π Endpoint Filtering from Default Reference Set
New IsDefaultReferenceEndpoint property on EndpointAnnotation excludes management/health endpoints from the default WithReference set. Keycloak management, CosmosDB emulator health, EventHubs emulator health, and ServiceBus emulator health endpoints are now excluded by default.
Changes: Allow filtering endpoints from the default reference setΒ #15558 β οΈBreaking change
π Documentation required
β Java Polyglot AppHost Parity
Java language support for polyglot AppHosts, bringing Java AppHost capabilities in line with TypeScript and other supported languages.
Changes: Add Java polyglot AppHost parityΒ #15470
π Documentation required
π‘ JavaScript Publish Methods and AddNextJsApp
New publish methods for JavaScript apps: AddNextJsApp (with standalone Next.js Dockerfile validation), PublishAsStaticWebsite (YARP-based static hosting with optional API proxy), PublishAsNodeServer, and PublishAsNpmScript. All are marked [Experimental].
Changes: Add JavaScript publish methods, AddNextJsApp, and switch to YARPΒ #15736
π Documentation required
β Kubernetes Deployment with Helm Engine
End-to-end aspire deploy support for Kubernetes via an annotation-driven engine with Helm as the default. Configure namespace, release name, and chart version on AddKubernetesEnvironment().
Changes: Add Kubernetes deploy pipeline with Helm engineΒ #15723
π Documentation required
π§ F# and VB Project Upgrade Support aspire add now supports upgrading F# and Visual Basic projects to include Aspire service defaults.
Changes: Support upgrading F# and VB projectsΒ #15799
App Host improvements
π ACA Custom Domain Support for Polyglot
TypeScript AppHosts can now configure custom domains for Azure Container Apps resources.
Changes: Add polyglot ACA custom domain supportΒ #15811
πΌοΈ Polyglot withImagePushOptions
TypeScript AppHosts can now configure container registry push options (e.g., registry authentication) via withImagePushOptions.
Changes: Add polyglot withImagePushOptions supportΒ #15809
π Polyglot withEnvironment Unified
TypeScript withEnvironment exports are consolidated to provide a consistent API surface across polyglot AppHosts.
Changes: Unify ATS withEnvironment exportsΒ #15649
π Service Reference Endpoint Callbacks
Endpoint callback exports are now available for TypeScript AppHosts, enabling custom service wiring based on endpoint information.
Changes: Add polyglot endpoint callback exportsΒ #15856
π¦ Ignore Node Engines Field in Dockerfiles package.jsonengines.node fields are now ignored when generating Dockerfiles, preferring explicit Node.js version configuration.
Changes: Ignore package.json engines.node when generating DockerfilesΒ #16295 β οΈBreaking change
π₯οΈ aspire dashboard Command
New aspire dashboard command launches the standalone Aspire Dashboard for use with any OTLP-sending application, not just Aspire-managed AppHosts.
Changes: Add aspire dashboard CLI commandΒ #15607
π Documentation required
π£ aspire destroy Command
New aspire destroy tears down previously deployed Aspire environments. Supports Azure (ACA/App Service), Docker Compose, and Kubernetes (Helm). Use --yes/-y to skip confirmation prompts.
Changes: Add aspire destroy command for tearing down deployed environmentsΒ #16097
π Documentation required
π aspire do --list-steps Flag aspire do --list-steps lists all available pipeline steps without executing them, useful for understanding what a deployment would do.
Changes: Add --list-steps flag to aspire do commandΒ #16085
π€« Non-interactive CLI Mode (PromptBinding)
Infrastructure for PromptBinding enables the CLI to run in fully non-interactive mode, with answers to prompts provided programmatically β useful for scripting and CI automation.
Changes: Add PromptBinding infrastructure for non-interactive CLI modeΒ #16235
π Documentation required
π Dashboard Telemetry API by Default
The Dashboard telemetry API is now enabled by default with auto-generated API key authentication. When using aspire otel commands, paste the dashboard login URL and the CLI automatically exchanges the browser token for an API key.
Changes: Enable dashboard telemetry API by default with ApiKey auth and login token exchangeΒ #16326
π Documentation required
π Fix Open Redirect Vulnerability
An open redirect vulnerability in the Dashboard's authentication flow has been fixed.
Changes: Fix open redirect vulnerabilityΒ #15952
π§ Launch Configuration Environment Support
Aspire debug launch configurations now support environment variable overrides, enabling per-launch environment customization without modifying the AppHost.
Changes: Add env support to Aspire debug launch configurationΒ #16449
π Documentation required
π Open Aspire Dashboard in Command Palette
A new "Open Aspire Dashboard" command is available in the VS Code Command Palette for quick dashboard access.
Changes: Add 'Open Aspire Dashboard' to Command PaletteΒ #15499
π Simple Browser for Dashboard Launch
The VS Code extension can now open the Aspire Dashboard in the embedded VS Code Simple Browser panel instead of the system browser.
Changes: Add Simple Browser option for dashboard launchΒ #15896
π Azure Front Door Hosting Integration
New Aspire.Hosting.Azure.FrontDoor package provisions an Azure Front Door (Standard SKU) CDN profile, endpoint, origin group, origins, and a default route via Bicep. API: builder.AddAzureFrontDoor("frontdoor").WithOrigin(api.GetEndpoint("https")).
Changes: Add Azure Front Door hosting integrationΒ #16137
π Documentation required
π Private Endpoints for Azure Container Registry
Azure Container Registry resources can now be configured with private endpoints to restrict registry access to your virtual network.
Changes: Support private endpoints for Azure Container RegistryΒ #16132
π Documentation required
Integrations improvements
π Npgsql Histogram View Removed on .NET 10+
The custom Npgsql histogram view registration is removed on .NET 10+, which has built-in support, reducing configuration overhead.
Changes: Remove custom Npgsql histogram view on .NET 10+Β #16044
β±οΈ Configurable Azure Credential Timeout
The timeout for the Azure credential acquisition process is now configurable, helping in environments where credential retrieval is slow.
Changes: Make Azure credential process timeout configurableΒ #16175
π Service Discovery
1 improvement
Service Discovery improvements
π§ Service Discovery Environment Variable Handling
Improved handling of HTTP/HTTPS endpoint name and scheme mismatches; non-HTTP endpoints can now be referenced using DNS-style service discovery notation.
Changes: Update service discovery environment variablesΒ #16210
π Templates
1 new feature, 1 bug fix
Templates new features
π Python AppHost Code Generator
A code generator for Python AppHosts automatically produces the Python-side AppHost code, reducing boilerplate when integrating Python services into Aspire.
Changes: PythonAppHost Code GeneratorΒ #13947
π Documentation required
Templates bug fixes
π§ Python Starter Template Uses TypeScript AppHost
The aspire-py-starter template now uses a TypeScript AppHost instead of a C# AppHost, eliminating the .NET SDK requirement for the AppHost project. Use aspire new aspire-py-starter instead of dotnet new aspire-py-starter.
Changes: Move Python starter template to TypeScript AppHost and CLI template factoryΒ #15574 β οΈBreaking change
π Documentation required
This changelog is automatically generated. Add a comment to this issue to provide
feedback (e.g., "Exclude PR #1234", "Rename: X β Y", "Merge PRs #1234 and #5678").
Table of Contents
What's New
π§ AppHost
16 new features, 12 improvements, 7 bug fixes
App Host new features
π Application-level Event Subscription Helpers
Extension methods on
IDistributedApplicationBuilderfor subscribing to application lifecycle events, making event wiring more concise alongside the existingIDistributedApplicationEventingSubscriberpattern.Changes: Extension methods on
IDistributedApplicationBuilderfor subscribing to application level events.Β #14119π Documentation required
β AKS System Node Pool Customization
WithSystemNodePool()onAzureKubernetesEnvironmentResourcelets you customize the VM size for the AKS system node pool.Changes: Add WithSystemNodePool() to customize AKS system node pool VM sizeΒ #16312
βοΈ Alternative TypeScript AppHost Toolchains
TypeScript AppHosts can now use alternative package managers and runtimes (such as bun) beyond the default npm/node toolchain.
Changes: Support alternative TypeScript AppHost toolchainsΒ #16162
π― Azure Kubernetes Service (AKS) Hosting Support
New
Aspire.Hosting.Azure.Kubernetespackage withAddAzureKubernetesEnvironment()β provisions AKS clusters and configures workload identity, monitoring, and networking via Bicep.Changes: Add Azure Kubernetes Service (AKS) hosting supportΒ #16088
π Documentation required
π± ASPIRE_ENVIRONMENT Environment Variable
DistributedApplicationBuildernow reads theASPIRE_ENVIRONMENTenvironment variable to configure the environment name, enabling environment-specific behaviors without code changes.Changes: Read ASPIRE_ENVIRONMENT in DistributedApplicationBuilderΒ #16098
ποΈ BeforeStart Pipeline Steps
Support for dependency-ordered BeforeStart pipeline steps lets you reliably control initialization order (e.g., run custom steps before Azure resource provisioning).
Changes: Add support for BeforeStart Pipeline stepsΒ #13780
π Documentation required
π³ Docker Compose Podman Support
β οΈ Breaking change
First-class Podman support for Docker Compose deploy and a new unified
IContainerRuntimeResolverthat auto-detects the best available container runtime.aspire doctornow shows all runtimes with status and explains which is active.Changes: Add Podman support for Docker Compose deploy and unify container runtime abstractionΒ #16074
π Documentation required
π© Docker Compose Polyglot API Exposure
Previously internal Docker Compose APIs are now exported to TypeScript AppHosts, enabling polyglot AppHosts to leverage the full Docker Compose deployment feature set.
Changes: Expose missing Docker Compose polyglot APIsΒ #16364
π Endpoint Filtering from Default Reference Set
β οΈ Breaking change
New
IsDefaultReferenceEndpointproperty onEndpointAnnotationexcludes management/health endpoints from the defaultWithReferenceset. Keycloak management, CosmosDB emulator health, EventHubs emulator health, and ServiceBus emulator health endpoints are now excluded by default.Changes: Allow filtering endpoints from the default reference setΒ #15558
π Documentation required
β Java Polyglot AppHost Parity
Java language support for polyglot AppHosts, bringing Java AppHost capabilities in line with TypeScript and other supported languages.
Changes: Add Java polyglot AppHost parityΒ #15470
π Documentation required
π‘ JavaScript Publish Methods and AddNextJsApp
New publish methods for JavaScript apps:
AddNextJsApp(with standalone Next.js Dockerfile validation),PublishAsStaticWebsite(YARP-based static hosting with optional API proxy),PublishAsNodeServer, andPublishAsNpmScript. All are marked[Experimental].Changes: Add JavaScript publish methods, AddNextJsApp, and switch to YARPΒ #15736
π Documentation required
β Kubernetes Deployment with Helm Engine
End-to-end
aspire deploysupport for Kubernetes via an annotation-driven engine with Helm as the default. Configure namespace, release name, and chart version onAddKubernetesEnvironment().Changes: Add Kubernetes deploy pipeline with Helm engineΒ #15723
π Documentation required
π Logger in ExecuteCommandContext
ExecuteCommandContextnow exposes anILoggerso resource command handlers can write diagnostic output.Changes: Add Logger property to ExecuteCommandContextΒ #15678
π³ Privileged Docker Compose Publishing
Adds a 'privileged' flag to Docker Compose publish resources for containers that require elevated permissions.
Changes: Add 'privileged' flag for docker-compose publishingΒ #16075
π Resource Command Result Support
Resource commands can now return structured result data (text, JSON, or markdown). Results are displayed in the Dashboard's text visualizer and written to stdout in the CLI, enabling clean piping (e.g.,
aspire resource myResource generate-token | jq .token).Changes: Add command result support for resource commandsΒ #15622, Add HTTP command result support for AppHost HTTP commandsΒ #15664
π Documentation required
π§ F# and VB Project Upgrade Support
aspire addnow supports upgrading F# and Visual Basic projects to include Aspire service defaults.Changes: Support upgrading F# and VB projectsΒ #15799
App Host improvements
π ACA Custom Domain Support for Polyglot
TypeScript AppHosts can now configure custom domains for Azure Container Apps resources.
Changes: Add polyglot ACA custom domain supportΒ #15811
π ATS Pipeline Parity for Polyglot
TypeScript AppHosts now support the same ATS pipeline capabilities as C# AppHosts, ensuring feature parity.
Changes: Add ATS pipeline parity for polyglot AppHostsΒ #15826
π§ Dockerfile Builder APIs for Polyglot
Exposes Dockerfile builder APIs to TypeScript AppHosts for custom container image configuration.
Changes: Expose Dockerfile builder APIs to polyglot apphostsΒ #15867
π Export Remaining ATS Aspire.Hosting APIs
Additional
Aspire.HostingAPIs are now exported for TypeScript ATS AppHosts.Changes: Export remaining ATS Aspire.Hosting APIsΒ #16227
π HTTPS Upgrade for Azure App Service
HTTP endpoints are automatically upgraded to HTTPS when publishing to Azure App Service.
Changes: Upgrade HTTP endpoints to HTTPS in Azure App ServiceΒ #16060
π macOS Dev Certificate Pre-export
The development certificate is pre-exported to the Aspire cache on macOS, avoiding repeated keychain access prompts.
Changes: Pre-export dev certificate to Aspire cache to avoid macOS keychain promptsΒ #16282
πΊοΈ AKS VM Size Region Coverage
GenVmSizesnow queries all Azure regions to provide a comprehensive list of available VM sizes for AKS node pools.Changes: Update GenVmSizes to query all Azure regions for comprehensive VM size listΒ #16313
πΌοΈ Polyglot withImagePushOptions
TypeScript AppHosts can now configure container registry push options (e.g., registry authentication) via
withImagePushOptions.Changes: Add polyglot withImagePushOptions supportΒ #15809
π Polyglot withEnvironment Unified
TypeScript
withEnvironmentexports are consolidated to provide a consistent API surface across polyglot AppHosts.Changes: Unify ATS withEnvironment exportsΒ #15649
π Service Reference Endpoint Callbacks
Endpoint callback exports are now available for TypeScript AppHosts, enabling custom service wiring based on endpoint information.
Changes: Add polyglot endpoint callback exportsΒ #15856
π WithEndpoint Updates Instead of Throwing
WithEndpointnow updates an existing endpoint with the same name instead of throwing, making it easier to customize endpoints defined by resources.Changes: Make WithEndpoint update existing endpoints instead of throwingΒ #16039
π¦ Ignore Node Engines Field in Dockerfiles
β οΈ Breaking change
package.jsonengines.nodefields are now ignored when generating Dockerfiles, preferring explicit Node.js version configuration.Changes: Ignore package.json engines.node when generating DockerfilesΒ #16295
App Host bug fixes
π Fix Azure Functions / Class Library Regressions
Fixes 13.2 regressions affecting IDE execution for Azure Functions and class library projects.
Changes: Fix 13.2 IDE execution regressions for Azure Functions and class library projectsΒ #15714
π Fix Durable Task Scheduler ATS Export Annotations
Corrects annotation handling for Durable Task Scheduler TypeScript exports.
Changes: Fix Durable Task Scheduler ATS export annotationsΒ #15684
π Fix Foundry Hosted Agent HTTP Endpoints
Fixes HTTP endpoint configuration for Foundry hosted agents.
Changes: Fixes Foundry Hosted Agents HTTP endpointsΒ #16130
π Fix Next.js Standalone Dockerfile Cache Permissions
Corrects file permission issues in Next.js standalone Docker image cache layers.
Changes: Fix Next.js standalone Dockerfile cache permissionsΒ #16290
π Fix OTLP Endpoint Resolution in Isolated Mode
Resolves incorrect OTLP endpoint resolution when running in isolated mode.
Changes: Fix OTLP endpoint resolution in isolated modeΒ #16367
π Fix TypeScript Codegen Promise Resolution
Auto-resolves promises in TypeScript codegen to prevent silent RPC drops in generated code.
Changes: Auto-resolve promises in TypeScript codegen to prevent silent RPC dropsΒ #15901, Fix TypeScript codegen typing for reusable packagesΒ #15631
π Fix TypeScript AppHost Publish Output Path
The default publish output path for TypeScript AppHosts is now correctly set.
Changes: Fix default publish output path for TypeScript AppHostsΒ #16157
β¨οΈ CLI
7 new features, 17 improvements, 7 bug fixes
CLI new features
π API Key and Dashboard URL Options
--dashboard-urland--api-keyoptions added toaspire otelandaspire agent mcp. Pass the dashboard login URL and the CLI will automatically exchange the browser token for an API key.Changes: Add --dashboard-url and --api-key options to aspire agent mcp and aspire otel commandsΒ #15595
π Documentation required
π₯οΈ aspire dashboard Command
New
aspire dashboardcommand launches the standalone Aspire Dashboard for use with any OTLP-sending application, not just Aspire-managed AppHosts.Changes: Add
aspire dashboardCLI commandΒ #15607π Documentation required
π aspire docs api Sub-commands
aspire docs api <member>exposes the aspire.dev API reference material directly from the CLI for quick lookup during development.Changes: Add
aspire docs api *sub-commands to exposeaspire.devreference materialΒ #15814π£ aspire destroy Command
New
aspire destroytears down previously deployed Aspire environments. Supports Azure (ACA/App Service), Docker Compose, and Kubernetes (Helm). Use--yes/-yto skip confirmation prompts.Changes: Add aspire destroy command for tearing down deployed environmentsΒ #16097
π Documentation required
π aspire do --list-steps Flag
aspire do --list-stepslists all available pipeline steps without executing them, useful for understanding what a deployment would do.Changes: Add --list-steps flag to aspire do commandΒ #16085
π CLI Default Path Detection
The CLI is now automatically found at default install paths even when not on
PATH, improving discoverability on fresh installations.Changes: Detect CLI at default install paths when not on PATHΒ #14545
π€« Non-interactive CLI Mode (PromptBinding)
Infrastructure for
PromptBindingenables the CLI to run in fully non-interactive mode, with answers to prompts provided programmatically β useful for scripting and CI automation.Changes: Add PromptBinding infrastructure for non-interactive CLI modeΒ #16235
π Documentation required
CLI improvements
π¨ ANSI Colors for CLI Emoji
CLI emoji now render with appropriate ANSI text colors on color-capable terminals, with graceful fallback on monochrome terminals.
Changes: Add ANSI text colors to CLI emoji for monochrome terminal renderingΒ #16089, Use emoji in ConsoleActivityLogger summary and localize stringsΒ #16084
π Azure Portal Links in Deploy Summaries
Deployment summaries now include clickable links to the Azure portal for deployed resources.
Changes: Add Azure portal links to deploy summariesΒ #16142
π Clickable Dashboard Hyperlinks in Telemetry Commands
Dashboard URLs in
aspire otel logsandaspire otel spansoutput are rendered as clickable terminal hyperlinks.Changes: Add clickable dashboard hyperlinks to CLI telemetry commandsΒ #16079
π Deduplicate Paths in aspire ps
aspire psoutput disambiguates projects with duplicate file paths.Changes: Disambiguate duplicate paths in aspire ps outputΒ #16199
π Enhanced Deployment Rendering
Deployment progress display shows improved symbol rendering, log-level helpers, and better multi-step scenarios.
Changes: Improve CLI deployment rendering: symbol fixes, log level helper, render scenariosΒ #16080
π Hide Hidden Resources by Default
aspire describe,aspire logs, andaspire exportnow hide DCP-internal hidden resources by default. Use--include-hiddento see them.Changes: CLI: Hide hidden resources by default in describe/logs/export, add --include-hidden optionΒ #16146
π Login Token in aspire ps
aspire psnow includes the dashboard login token/URL, making it easy to access a running app's dashboard.Changes: Add token for Dashboard url when running
aspire psΒ #16165π Markdig for CLI Docs Rendering
The
aspire docscommand now uses Markdig for richer terminal markdown rendering.Changes: Use Markdig for Aspire CLI docs renderingΒ #16342
π€ NodeJs Hosting Deprecated in CLI
Aspire.Hosting.NodeJsis now marked as deprecated in CLI integration listings, directing users to the JavaScript-specific integrations.Changes: Deprecate Aspire.Hosting.NodeJs in CLI integration listingsΒ #15677
π Surface Build Output on Failure
Build output from Docker, Podman, and dotnet publish is now surfaced in the CLI when a build fails, making it easier to diagnose deployment issues.
Changes: Surface build output on failure for Docker, Podman, and dotnet publishΒ #16093, Surface process output on failureΒ #16303
π Staging Channel Auto-enable
When a channel is set to
staging, it is automatically enabled so users get preview builds without additional configuration.Changes: Auto-enable staging channel when channel is set to stagingΒ #15422
π§ Telemetry Activity for App Host Run
Telemetry activity spans are added for the app host run lifecycle in the CLI, improving observability of CLI operations.
Changes: Add telemetry activity for running app host in CLIΒ #16346
π Rename Describe Endpoints Column to URLs
The
endpointscolumn inaspire describeoutput is now labeledURLs.Changes: Rename describe endpoints column to URLsΒ #16144
π SDK Dump Cleanup
aspire sdk dumpnow filters out internalAspire.Hostingbits, showing only user-relevant SDK information.Changes: Filter
Aspire.Hostingbits out ofsdk dumpcommandΒ #15291π Improved Debug Logging Defaults
CLI debug logging defaults are improved so diagnostic output is more useful and less noisy.
Changes: Improve CLI debug logging defaultsΒ #15800, Reduce CLI diagnostic log noise and improve process loggingΒ #15956
π¦ NuGet Cache Excluded from Project Search
The project locator now skips the NuGet package cache directory, preventing false matches when finding AppHost projects.
Changes: Exclude NuGet cache from project file search in ProjectLocatorΒ #15388
π URL Output with Spectre.Console Links
URLs in CLI output are now rendered as Spectre.Console links, enabling clickable hyperlinks in supported terminals.
Changes: Use Spectre.Console link markup for CLI URL outputΒ #15573
CLI bug fixes
π Fix aspire stop Container Cleanup
aspire stopnow correctly cleans up application containers that were still running after stop.Changes: Fix issue 15806 ("aspire stop" is not cleaning up application containers)Β #16006
π Fix aspire start --format json Restart Output
Restart events are now correctly emitted in JSON format when using
aspire start --format json.Changes: Fix
aspire start --format jsonrestart outputΒ #16228π Fix aspire wait for JSON Resource Names
aspire waitnow correctly identifies resources when their names are emitted via JSON output.Changes: Fix aspire wait for JSON-emitted resource namesΒ #16224
π Fix ANSI Leaks in Plain Text Output
ANSI escape codes no longer appear in plain log output and telemetry text on non-ANSI terminals.
Changes: Fix ANSI leaks in plain logs and telemetry outputΒ #16225
π Fix aspire-managed.exe Bundle Extraction
The aspire-managed bundle no longer crashes on Windows when
aspire-managed.exeis locked by another process.Changes: Fix bundle extraction crash when aspire-managed.exe is lockedΒ #15790
π Fix Config Boolean Handling
Config reads of boolean values no longer crash; incorrect type encoding on write is also corrected.
Changes: [main] Fix config boolean handling: crash on read, wrong types on writeΒ #15638
π Fix describe --follow Disconnects
aspire describe --follownow handles server disconnects gracefully.Changes: Handle describe --follow disconnectsΒ #16271
π Dashboard
2 new features, 7 improvements, 5 bug fixes
Dashboard new features
π Notification Center
A bell icon in the Dashboard header opens a notification panel showing command execution history (start, stop, restart, rebuild results) with timestamps, intent-based styling, and "View response" actions.
Changes: Add notification center, command response message, and markdown support to DashboardΒ #15906
π Documentation required
π Dashboard Telemetry API by Default
The Dashboard telemetry API is now enabled by default with auto-generated API key authentication. When using
aspire otelcommands, paste the dashboard login URL and the CLI automatically exchanges the browser token for an API key.Changes: Enable dashboard telemetry API by default with ApiKey auth and login token exchangeΒ #16326
π Documentation required
Dashboard improvements
β‘ Remove Telemetry API Data Limits
Data limits on the Dashboard telemetry API have been removed, enabling larger payloads without truncation.
Changes: Remove telemetry API data limits and refactor URL buildersΒ #16020
π Parameters Page Improvements
The Parameters page now features clickable "set value" links, warning badges for unset required parameters, and filtering by resource.
Changes: Dashboard: Parameters page follow-ups - clickable set value, warning badge, filter by resourceΒ #16117
π Clickable Trace IDs
Trace IDs in the Dashboard are now rendered as clickable links for faster navigation.
Changes: Make trace ID a clickable link in trace detail viewΒ #16345
iοΈ State Column InfoPopover
The resource state column now shows an InfoPopover with clickable links for additional state detail.
Changes: Dashboard: Add InfoPopover for state column with clickable linksΒ #15996
π Short Trace ID Support
TelemetryApiService.GetTracenow supports short trace ID prefixes in addition to full 32-character trace IDs.Changes: Port: Simplify TelemetryApiService.GetTrace and support short trace IDsΒ #15641
ποΈ User Secrets Checkbox Descriptions
User secrets on the Dashboard now display descriptive labels directly in checkbox inputs for clearer UX.
Changes: Move user secrets descriptions to checkbox inputsΒ #16293
π Disable Browser Autocomplete on Search Fields
Browser autocomplete is disabled on dashboard search and input fields to prevent browser suggestions from interfering with filtering.
Changes: Disable browser autocomplete on dashboard search and input fieldsΒ #16297
Dashboard bug fixes
π Fix Open Redirect Vulnerability
An open redirect vulnerability in the Dashboard's authentication flow has been fixed.
Changes: Fix open redirect vulnerabilityΒ #15952
π Fix FluentSelect/FluentCombobox Value Binding
Dropdown components now correctly update their bound value when available options change dynamically.
Changes: Fix FluentSelect/FluentCombobox value binding when options changeΒ #16315
π Fix Language Dropdown in Settings
Arrow-key navigation and duplicate zh-CN entries in the Dashboard language selector are corrected.
Changes: Fix language dropdown arrow-key behavior and duplicate zh-CN entry in dashboard settingsΒ #16094
π Fix OTLP Histogram Bucket Count Deserialization
Numeric (integer)
bucketCountsin OTLP JSON payloads are now correctly deserialized instead of being dropped.Changes: Fix OTLP JSON deserialization of numeric histogram bucketCountsΒ #16376
π Fix MCP Tool Console Logs
The
list_console_logsMCP tool now correctly accepts resolved resource instance names.Changes: Fix list_console_logs MCP tool to accept resolved resource instance namesΒ #16279
π§© Extensions
4 new features, 5 improvements, 3 bug fixes
Extensions new features
π§ Launch Configuration Environment Support
Aspire debug launch configurations now support environment variable overrides, enabling per-launch environment customization without modifying the AppHost.
Changes: Add env support to Aspire debug launch configurationΒ #16449
π Documentation required
π Open Aspire Dashboard in Command Palette
A new "Open Aspire Dashboard" command is available in the VS Code Command Palette for quick dashboard access.
Changes: Add 'Open Aspire Dashboard' to Command PaletteΒ #15499
π Open AppHost Source Action
A new VS Code action lets users jump directly to the AppHost source file from any resource in the Aspire panel.
Changes: Add open AppHost source action to VS Code extensionΒ #15668
π Simple Browser for Dashboard Launch
The VS Code extension can now open the Aspire Dashboard in the embedded VS Code Simple Browser panel instead of the system browser.
Changes: Add Simple Browser option for dashboard launchΒ #15896
Extensions improvements
π Auto-restart Debug Session on AppHost Restart
The VS Code extension automatically restarts the Aspire debug session when the AppHost restarts, avoiding stale debugging sessions.
Changes: Fix JSON-RPC error on disconnect and auto-restart Aspire debug session on AppHost restartΒ #14548
π Auto-restore on Workspace Open
The extension triggers
aspire restoreautomatically when a workspace is opened or configuration changes.Changes: VS Code extension: Auto-restore on workspace open and config changeΒ #15546
π¨ Resource State Indicators
Gutter decorations, code lenses, and the tree view now display more accurate and visually clearer resource state indicators.
Changes: VS Code extension: Improve gutter, code lens, and tree view resource state indicatorsΒ #15688
π·οΈ Updated Activity Bar Icon
The VS Code activity bar icon has been refreshed to better align with the VS Code design language.
Changes: Updated the vs code activity bar icon to look slightly more cohesiveΒ #15451
π URL Deny List for Non-clickable Links
A deny list prevents endpoint URLs that should not be interactive from being rendered as clickable links.
Changes: Use deny list for non-linkable endpoint URLs in extensionΒ #15894
Extensions bug fixes
π Fix aspire start in VS Code Integrated Terminal
aspire startno longer fails when launched from the VS Code integrated terminal.Changes: Fix aspire start failing in VS Code integrated terminalΒ #15980
π Fix CodeLens Inside Code Blocks
Code lenses are no longer incorrectly positioned inside preceding code blocks in AppHost files.
Changes: Fix CodeLens positioned inside preceding code blocksΒ #15893
π Fix aspire new OpenEditor Timing
The VS Code extension now opens the editor after the agent init prompt completes.
Changes: Fix aspire new: move OpenEditor after agent init prompt in VS Code extensionΒ #15552
π Integrations
3 new features, 2 improvements
Integrations new features
π Azure Front Door Hosting Integration
New
Aspire.Hosting.Azure.FrontDoorpackage provisions an Azure Front Door (Standard SKU) CDN profile, endpoint, origin group, origins, and a default route via Bicep. API:builder.AddAzureFrontDoor("frontdoor").WithOrigin(api.GetEndpoint("https")).Changes: Add Azure Front Door hosting integrationΒ #16137
π Documentation required
π Azure Network Security Perimeter (NSP) Support
Provision Azure Network Security Perimeters to secure PaaS services (Storage, Key Vault, CosmosDB, SQL) within a logical network boundary. APIs:
AddNetworkSecurityPerimeter(),WithAccessRule(),AssociateWith().Changes: Add Azure Network Security Perimeter (NSP) supportΒ #15711
π Documentation required
π Private Endpoints for Azure Container Registry
Azure Container Registry resources can now be configured with private endpoints to restrict registry access to your virtual network.
Changes: Support private endpoints for Azure Container RegistryΒ #16132
π Documentation required
Integrations improvements
π Npgsql Histogram View Removed on .NET 10+
The custom Npgsql histogram view registration is removed on .NET 10+, which has built-in support, reducing configuration overhead.
Changes: Remove custom Npgsql histogram view on .NET 10+Β #16044
β±οΈ Configurable Azure Credential Timeout
The timeout for the Azure credential acquisition process is now configurable, helping in environments where credential retrieval is slow.
Changes: Make Azure credential process timeout configurableΒ #16175
π Service Discovery
1 improvement
Service Discovery improvements
Improved handling of HTTP/HTTPS endpoint name and scheme mismatches; non-HTTP endpoints can now be referenced using DNS-style service discovery notation.
Changes: Update service discovery environment variablesΒ #16210
π Templates
1 new feature, 1 bug fix
Templates new features
A code generator for Python AppHosts automatically produces the Python-side AppHost code, reducing boilerplate when integrating Python services into Aspire.
Changes: PythonAppHost Code GeneratorΒ #13947
π Documentation required
Templates bug fixes
The
aspire-py-startertemplate now uses a TypeScript AppHost instead of a C# AppHost, eliminating the .NET SDK requirement for the AppHost project. Useaspire new aspire-py-starterinstead ofdotnet new aspire-py-starter.Changes: Move Python starter template to TypeScript AppHost and CLI template factoryΒ #15574
π Documentation required
This changelog is automatically generated. Add a comment to this issue to provide
feedback (e.g., "Exclude PR #1234", "Rename: X β Y", "Merge PRs #1234 and #5678").