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
βοΈ Azure Front Door hosting integration
New Aspire.Hosting.Azure.FrontDoor integration lets you add and configure Azure Front Door resources in your AppHost.
(Add Azure Front Door hosting integrationΒ #16137)
π Documentation required
β Azure Kubernetes Service (AKS) hosting support
New Aspire.Hosting.Azure.Aks integration enables deploying Aspire applications to AKS clusters.
(Add Azure Kubernetes Service (AKS) hosting supportΒ #16088)
π Documentation required
π BeforeStart pipeline steps
Pipeline steps can now run before the application starts, enabling pre-launch resource setup and validation.
(Add support for BeforeStart Pipeline stepsΒ #13780)
π Documentation required
π Endpoint filtering from default reference sets
New API to exclude specific endpoints when WithReference is called, giving finer control over service connections.
(Allow filtering endpoints from the default reference setΒ #15558) β οΈBreaking change
π Documentation required
β Java polyglot AppHost support
TypeScript AppHosts now support Java application resources with feature parity to other supported languages.
(Add Java polyglot AppHost parityΒ #15470)
π Documentation required
π Polyglot ACA custom domain support
TypeScript AppHosts can now configure custom domains for Azure Container Apps resources.
(Add polyglot ACA custom domain supportΒ #15811)
π Documentation required
β±οΈ Configurable Azure credential process timeout
The timeout for Azure credential acquisition can now be configured, useful in slow or restricted network environments.
(Make Azure credential process timeout configurableΒ #16175)
π¦ Export remaining ATS Aspire.Hosting APIs
Additional Aspire Hosting APIs are now exported through the ATS type system for TypeScript AppHosts.
(Export remaining ATS Aspire.Hosting APIsΒ #16227)
πΌοΈ Image push options for polyglot apps
TypeScript AppHosts now support withImagePushOptions for configuring container image push behavior.
(Add polyglot withImagePushOptions supportΒ #15809)
π Logger in ExecuteCommandContext ExecuteCommandContext now exposes a Logger property, making it easier to emit structured logs from resource command handlers.
(Add Logger property to ExecuteCommandContextΒ #15678)
π TryGetByName on IResourceCollection IResourceCollection now has a TryGetByName method for safe, non-throwing resource lookups by name.
(Add TryGetByName to IResourceCollectionΒ #16389)
π₯οΈ aspire dashboard command
New aspire dashboard command opens the Aspire Dashboard in the browser without starting the full AppHost.
(Add aspire dashboard CLI commandΒ #15607)
π Documentation required
ποΈ Remove MCP server and UI from dashboard
The MCP (Model Context Protocol) server and its UI panel have been removed from the Aspire Dashboard.
(Remove MCP server and UI from the dashboardΒ #15528) β οΈBreaking change
π‘οΈ Azure Network Security Perimeter (NSP) support
Aspire resource provisioning now supports Azure Network Security Perimeter for securing Azure resources within a network boundary.
(Add Azure Network Security Perimeter (NSP) supportΒ #15711)
π Documentation required
Improvements
π RabbitMQ v7 tracing support
The RabbitMQ component now enables distributed tracing support for RabbitMQ.Client v7.
(Enable tracing for RabbitMQ Component (v7)Β #15659)
π 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").
test
ποΈ AppHost
New features
π AddNextJsApp and JavaScript YARP integration
Adds
AddNextJsAppto host Next.js applications with YARP reverse proxy support, including publish methods.(Add JavaScript publish methods, AddNextJsApp, and switch to YARPΒ #15736)
π Documentation required
βοΈ Azure Front Door hosting integration
New
Aspire.Hosting.Azure.FrontDoorintegration lets you add and configure Azure Front Door resources in your AppHost.(Add Azure Front Door hosting integrationΒ #16137)
π Documentation required
β Azure Kubernetes Service (AKS) hosting support
New
Aspire.Hosting.Azure.Aksintegration enables deploying Aspire applications to AKS clusters.(Add Azure Kubernetes Service (AKS) hosting supportΒ #16088)
π Documentation required
π BeforeStart pipeline steps
Pipeline steps can now run before the application starts, enabling pre-launch resource setup and validation.
(Add support for BeforeStart Pipeline stepsΒ #13780)
π Documentation required
π Docker Compose deploy with Podman support
β οΈ Breaking change
Adds Podman as a supported container runtime for Docker Compose deployments, unifying the container runtime abstraction.
(Add Podman support for Docker Compose deploy and unify container runtime abstractionΒ #16074)
π Documentation required
π Dockerfile builder APIs for polyglot AppHosts
Exposes Dockerfile builder APIs to TypeScript/polyglot AppHosts, enabling custom image definitions from non-C# app hosts.
(Expose Dockerfile builder APIs to polyglot apphostsΒ #15867)
π Documentation required
ποΈ Durable Task Scheduler resources for Azure Functions
Adds Azure Durable Task Scheduler resource definitions to the Azure Functions hosting library.
(Addition of Durable Task Scheduler resources to Azure Functions host libraryΒ #13711)
π Documentation required
π§ EF Core hosting integration for migration management
New
Aspire.Hosting.EntityFrameworkCorepackage provides orchestration support for Entity Framework Core database migrations.(Add Aspire.Hosting.EntityFrameworkCore hosting integration for EF Core migration managementΒ #13481)
π Documentation required
π Endpoint filtering from default reference sets
β οΈ Breaking change
New API to exclude specific endpoints when
WithReferenceis called, giving finer control over service connections.(Allow filtering endpoints from the default reference setΒ #15558)
π Documentation required
β Java polyglot AppHost support
TypeScript AppHosts now support Java application resources with feature parity to other supported languages.
(Add Java polyglot AppHost parityΒ #15470)
π Documentation required
π Polyglot ACA custom domain support
TypeScript AppHosts can now configure custom domains for Azure Container Apps resources.
(Add polyglot ACA custom domain supportΒ #15811)
π Documentation required
π€ Polyglot endpoint callback exports
TypeScript AppHosts can now export endpoint callbacks to consumer applications.
(Add polyglot endpoint callback exportsΒ #15856)
π Python AppHost code generator
New code generator for Python-based AppHosts, enabling Python project orchestration from TypeScript app hosts.
(PythonAppHost Code GeneratorΒ #13947)
π Documentation required
π Private endpoints for Azure Container Registry
Azure Container Registry resources can now be configured with private endpoints for secure access.
(Support private endpoints for Azure Container RegistryΒ #16132)
π Documentation required
π‘οΈ Privileged container flag for Docker Compose
Docker Compose publishing now supports the
privilegedflag for containers that require elevated permissions.(Add 'privileged' flag for docker-compose publishingΒ #16075)
π― Resource command results
Resource commands can now return structured results, enabling the CLI and dashboard to display command outputs including HTTP responses.
Changes Add command result support for resource commandsΒ #15622, Add HTTP command result support for AppHost HTTP commandsΒ #15664
β Container runtime health check pipeline step
A new orphan pipeline step verifies the container runtime is available before deployment begins, improving error messages.
(Add container runtime health check as orphan pipeline stepΒ #16196)
π Subscribe to application-level events
New extension methods on
IDistributedApplicationBuilderenable subscribing to application lifecycle events.(Extension methods on
IDistributedApplicationBuilderfor subscribing to application level events.Β #14119)Improvements
π ASPIRE_ENVIRONMENT support
DistributedApplicationBuildernow reads theASPIRE_ENVIRONMENTenvironment variable to set the hosting environment.(Read ASPIRE_ENVIRONMENT in DistributedApplicationBuilderΒ #16098)
π Documentation required
π Alternative TypeScript AppHost toolchains
TypeScript AppHosts can now be configured to use alternative package manager toolchains.
(Support alternative TypeScript AppHost toolchainsΒ #16162)
β±οΈ Configurable Azure credential process timeout
The timeout for Azure credential acquisition can now be configured, useful in slow or restricted network environments.
(Make Azure credential process timeout configurableΒ #16175)
π³ Expose Docker Compose polyglot APIs
Previously missing Docker Compose resource APIs are now available to TypeScript/polyglot AppHosts.
(Expose missing Docker Compose polyglot APIsΒ #16364)
π¦ Export remaining ATS Aspire.Hosting APIs
Additional Aspire Hosting APIs are now exported through the ATS type system for TypeScript AppHosts.
(Export remaining ATS Aspire.Hosting APIsΒ #16227)
π Ignore
β οΈ Breaking change
engines.nodewhen generating Node.js DockerfilesThe Dockerfile generator now ignores
package.jsonengines.nodeconstraints, using a consistent Node.js base image.(Ignore package.json engines.node when generating DockerfilesΒ #16295)
πΌοΈ Image push options for polyglot apps
TypeScript AppHosts now support
withImagePushOptionsfor configuring container image push behavior.(Add polyglot withImagePushOptions supportΒ #15809)
π Logger in ExecuteCommandContext
ExecuteCommandContextnow exposes aLoggerproperty, making it easier to emit structured logs from resource command handlers.(Add Logger property to ExecuteCommandContextΒ #15678)
β‘ Pipeline failure isolation
Failed pipeline steps no longer cancel unrelated parallel steps, reducing unnecessary cascading failures.
(Pipeline: only cancel dependent steps on failure, not all stepsΒ #16299)
π Pre-exported dev certificate cache
Dev certificates are now pre-exported to the Aspire cache on startup, avoiding interactive macOS Keychain prompts.
(Pre-export dev certificate to Aspire cache to avoid macOS keychain promptsΒ #16282)
π TryGetByName on IResourceCollection
IResourceCollectionnow has aTryGetByNamemethod for safe, non-throwing resource lookups by name.(Add TryGetByName to IResourceCollectionΒ #16389)
π WithEndpoint updates existing endpoints
WithEndpointnow updates an existing endpoint if one with the same name exists, instead of throwing an exception.(Make WithEndpoint update existing endpoints instead of throwingΒ #16039)
Bug fixes
Corrects the order in which events fire and callbacks are invoked during container resource creation.
(Fix event order and callback calling during container creationΒ #15503)
β¨οΈ CLI
New features
π₯οΈ aspire dashboard command
New
aspire dashboardcommand opens the Aspire Dashboard in the browser without starting the full AppHost.(Add
aspire dashboardCLI commandΒ #15607)π Documentation required
π₯ aspire destroy command
New
aspire destroycommand tears down previously deployed environments, deleting provisioned Azure resources.(Add aspire destroy command for tearing down deployed environmentsΒ #16097)
π Documentation required
π aspire docs api sub-commands
New
aspire docs api *commands surface aspire.dev API reference documentation directly in the terminal.(Add
aspire docs api *sub-commands to exposeaspire.devreference materialΒ #15814)π Documentation required
π API key and dashboard URL flags for aspire agent and otel
aspire agent mcpandaspire otelcommands now accept--dashboard-urland--api-keyfor connecting to remote dashboards.(Add --dashboard-url and --api-key options to aspire agent mcp and aspire otel commandsΒ #15595)
π --list-steps flag for aspire do
aspire do --list-stepslists the available pipeline steps without executing them.(Add --list-steps flag to aspire do commandΒ #16085)
Improvements
π Auto-enable staging update channel
Setting the update channel to staging now automatically enables the staging feature flag.
(Auto-enable staging channel when channel is set to stagingΒ #15422)
π Clickable dashboard hyperlinks in telemetry commands
aspire oteland similar telemetry commands now output clickable hyperlinks to open dashboard views directly.(Add clickable dashboard hyperlinks to CLI telemetry commandsΒ #16079)
π‘ Dashboard telemetry API enabled by default
The Aspire Dashboard telemetry API is now enabled by default with API key authentication, improving debuggability.
(Enable dashboard telemetry API by default with ApiKey auth and login token exchangeΒ #16326)
π Documentation required
π Detect CLI at default install paths
The Aspire CLI is now automatically located at known default install paths even when it is not on
PATH.(Detect CLI at default install paths when not on PATHΒ #14545)
π½ Hide hidden resources by default
aspire describe,aspire logs, andaspire exportnow hide internal resources by default. Use--include-hiddento show them.(CLI: Hide hidden resources by default in describe/logs/export, add --include-hidden optionΒ #16146)
π¨ Improved deployment rendering
CLI deployment output uses consistent symbols, improved log levels, and better scenario rendering.
(Improve CLI deployment rendering: symbol fixes, log level helper, render scenariosΒ #16080)
π Markdig rendering for aspire docs
The
aspire docscommand now uses Markdig for rich Markdown rendering in the terminal.(Use Markdig for Aspire CLI docs renderingΒ #16342)
ποΈ Non-interactive CLI with PromptBinding
New
PromptBindinginfrastructure allows CLI commands to run non-interactively by resolving prompts from configuration or flags.(Add PromptBinding infrastructure for non-interactive CLI modeΒ #16235)
π§Ή Remove obsolete Docker Engine tunnel warning
aspire doctorno longer shows an outdated warning about Docker Engine tunneling.(Remove obsolete Docker Engine tunnel warning from
aspire doctorΒ #16343)π Show dashboard URL in aspire ps
aspire psoutput now includes the Aspire Dashboard URL as a clickable token.(Add token for Dashboard url when running
aspire psΒ #16165)β Use [Y/n] convention for confirmation prompts
CLI confirmation prompts now use the
[Y/n]format to indicate the default choice clearly.(Update CLI confirmation prompts to use [Y/n] conventionΒ #15663)
aspire updatenow warns instead of failing when a package version is absent from the update channel.(Warn instead of failing when a package is missing from the channel during
aspire updateΒ #16337)Bug fixes
ποΈ Disambiguate duplicate paths in aspire ps
aspire psno longer shows ambiguous entries when multiple apps share a working directory.(Disambiguate duplicate paths in aspire ps outputΒ #16199)
πΊ Fix ANSI escapes in plain output
Plain (non-ANSI) log and telemetry output no longer contains stray ANSI escape codes.
(Fix ANSI leaks in plain logs and telemetry outputΒ #16225)
βοΈ Fix aspire config list --all with empty config
aspire config list --allno longer incorrectly shows "no features" when the configuration file does not exist.(Fix
aspire config list --allshowing no features when no config existsΒ #15821)π Fix aspire stop not cleaning up containers
aspire stopnow correctly terminates and removes all application containers.(Fix issue 15806 ("aspire stop" is not cleaning up application containers)Β #16006)
π Handle describe --follow disconnects gracefully
aspire describe --follownow handles server disconnects without crashing.(Handle describe --follow disconnectsΒ #16271)
π Dashboard
New features
The dashboard now includes a notification center that displays command response messages with Markdown formatting support.
(Add notification center, command response message, and markdown support to DashboardΒ #15906)
π Documentation required
Improvements
π‘ Dashboard telemetry API enabled by default
The dashboard telemetry API is now enabled with API key authentication by default, enabling secure remote programmatic access.
(Enable dashboard telemetry API by default with ApiKey auth and login token exchangeΒ #16326)
π Documentation required
βοΈ Parameters page enhancements
Dashboard parameters page now supports clickable set-value links, warning badges, and filtering by resource.
(Dashboard: Parameters page follow-ups - clickable set value, warning badge, filter by resourceΒ #16117)
ποΈ Remove MCP server and UI from dashboard
β οΈ Breaking change
The MCP (Model Context Protocol) server and its UI panel have been removed from the Aspire Dashboard.
(Remove MCP server and UI from the dashboardΒ #15528)
π User secrets as checkbox inputs
User secret descriptions in the dashboard are now displayed alongside checkbox inputs for improved usability.
(Move user secrets descriptions to checkbox inputsΒ #16293)
Bug fixes
π Disable autocomplete on dashboard inputs
Search boxes and form inputs in the dashboard now have browser autocomplete disabled to avoid unwanted suggestions.
(Disable browser autocomplete on dashboard search and input fieldsΒ #16297)
π Fix dashboard language dropdown issues
Fixes arrow-key navigation in the language dropdown and removes a duplicate zh-CN locale entry.
(Fix language dropdown arrow-key behavior and duplicate zh-CN entry in dashboard settingsΒ #16094)
β‘ Fix FluentSelect and FluentCombobox value binding
FluentSelect and FluentCombobox controls now correctly update their bound values when the available options change.
(Fix FluentSelect/FluentCombobox value binding when options changeΒ #16315)
π Fix OTLP histogram bucket count deserialization
Histogram metrics exported via OTLP with numeric
bucketCountsnow parse correctly in the dashboard.(Fix OTLP JSON deserialization of numeric histogram bucketCountsΒ #16376)
π Fix open redirect vulnerability
Resolved an open redirect security vulnerability in the Aspire Dashboard.
(Fix open redirect vulnerabilityΒ #15952)
π§© Extensions
New features
π Open Aspire Dashboard in Command Palette
Adds an "Open Aspire Dashboard" command to the VS Code Command Palette for quick dashboard access.
(Add 'Open Aspire Dashboard' to Command PaletteΒ #15499)
π Open AppHost source in VS Code
VS Code extension now provides an action to open the AppHost source code directly from the resource view.
(Add open AppHost source action to VS Code extensionΒ #15668)
π Simple Browser dashboard launch option
The VS Code extension can now open the Aspire Dashboard in the embedded Simple Browser panel.
(Add Simple Browser option for dashboard launchΒ #15896)
Improvements
π Auto-restore on workspace open and config change
The VS Code extension now automatically restores the Aspire AppHost when the workspace is opened or the configuration changes.
(VS Code extension: Auto-restore on workspace open and config changeΒ #15546)
π¨ Improved resource state indicators
Gutter icons, code lens overlays, and tree view entries now show richer resource state information.
(VS Code extension: Improve gutter, code lens, and tree view resource state indicatorsΒ #15688)
Bug fixes
aspire startno longer fails when invoked from the VS Code integrated terminal.(Fix aspire start failing in VS Code integrated terminalΒ #15980)
π Integrations
New features
Aspire resource provisioning now supports Azure Network Security Perimeter for securing Azure resources within a network boundary.
(Add Azure Network Security Perimeter (NSP) supportΒ #15711)
π Documentation required
Improvements
The RabbitMQ component now enables distributed tracing support for RabbitMQ.Client v7.
(Enable tracing for RabbitMQ Component (v7)Β #15659)
π Documentation required
π Templates
Improvements
The Python starter template now uses a TypeScript AppHost for improved polyglot support and consistency with other templates.
(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").