[13.3] Change log

[github-actions]

Last updated: 2026-04-24T23:44:55Z
PRs analyzed through: 2026-04-24T23:44:55Z

test

🏗️ AppHost

New features

• 🔌 AddNextJsApp and JavaScript YARP integration
  Adds AddNextJsApp to 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.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

• 🐋 Docker Compose deploy with Podman support
  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)
  ⚠️ Breaking change
  📝 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.EntityFrameworkCore package 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
  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

• 📤 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 privileged flag 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 IDistributedApplicationBuilder enable subscribing to application lifecycle events.
  (Extension methods on IDistributedApplicationBuilder for subscribing to application level events. #14119)

Improvements

• 🌍 ASPIRE_ENVIRONMENT support
  DistributedApplicationBuilder now reads the ASPIRE_ENVIRONMENT environment 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 engines.node when generating Node.js Dockerfiles
  The Dockerfile generator now ignores package.json engines.node constraints, using a consistent Node.js base image.
  (Ignore package.json engines.node when generating Dockerfiles #16295)
  ⚠️ Breaking change

• 🖼️ 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)

• ⚡ 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
  IResourceCollection now has a TryGetByName method for safe, non-throwing resource lookups by name.
  (Add TryGetByName to IResourceCollection #16389)

• 🔗 WithEndpoint updates existing endpoints
  WithEndpoint now 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

• 🔁 Fix container creation event ordering
  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 dashboard command opens the Aspire Dashboard in the browser without starting the full AppHost.
  (Add aspire dashboard CLI command #15607)
  📝 Documentation required

• 💥 aspire destroy command
  New aspire destroy command 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 expose aspire.dev reference material #15814)
  📝 Documentation required

• 🔑 API key and dashboard URL flags for aspire agent and otel
  aspire agent mcp and aspire otel commands now accept --dashboard-url and --api-key for 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-steps lists 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 otel and 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, and aspire export now hide internal resources by default. Use --include-hidden to 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 docs command now uses Markdig for rich Markdown rendering in the terminal.
  (Use Markdig for Aspire CLI docs rendering #16342)

• 👁️ Non-interactive CLI with PromptBinding
  New PromptBinding infrastructure 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 doctor no 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 ps output 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)

• ⚠️ Warn on missing update channel package
  aspire update now 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 ps no 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 --all no longer incorrectly shows "no features" when the configuration file does not exist.
  (Fix aspire config list --all showing no features when no config exists #15821)

• 🛑 Fix aspire stop not cleaning up containers
  aspire stop now 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 --follow now handles server disconnects without crashing.
  (Handle describe --follow disconnects #16271)

📊 Dashboard

New features

• 🔔 Notification center with command responses and Markdown
  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
  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

• 🔐 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 bucketCounts now 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

• 💻 Fix aspire start in VS Code integrated terminal
  aspire start no longer fails when invoked from the VS Code integrated terminal.
  (Fix aspire start failing in VS Code integrated terminal #15980)

🔌 Integrations

New features

• 🛡️ 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

📄 Templates

Improvements

• 🐍 Python starter template migrated to TypeScript AppHost
  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)
  ⚠️ 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").

Generated by Milestone Changelog Generator · ● 1.9M · ◷