[13.3] Change log

[github-actions]

Last updated: 2026-04-25 00:36:52 UTC
PRs analyzed through: 2026-04-25 00:36:52 UTC

Table of Contents

• 🏗️ AppHost
• ⌨️ CLI
• 📊 Dashboard
• 🧩 Extensions
• 🔌 Integrations
• 📄 Templates

What's New

• 2026-4-24 - Dashboard - InfoPopover for resource state column with clickable links
• 2026-4-24 - Dashboard - Parameters page clickable set-value and warning badges
• 2026-4-24 - CLI - Markdig-based documentation rendering
• 2026-4-24 - Extensions - Environment variable support in debug launch configuration
• 2026-4-23 - AppHost - TryGetByName on IResourceCollection
• 2026-4-22 - AppHost - Docker Compose APIs for polyglot AppHosts
• 2026-4-22 - Dashboard - Tracked browser logs and network capture
• 2026-4-22 - CLI - Non-interactive CLI mode with PromptBinding
• 2026-4-21 - Dashboard - Dashboard telemetry API with ApiKey auth enabled by default
• 2026-4-20 - AppHost - Azure Front Door hosting integration
• 2026-4-20 - AppHost - Private endpoints for Azure Container Registry
• 2026-4-20 - AppHost - AKS system node pool customization

🏗️ AppHost

17 new features, 8 improvements, 3 bug fixes

New features

• 🐳 AKS system node pool customization
  New WithSystemNodePool() method to configure the VM size and settings of the AKS system node pool when deploying to Azure Kubernetes Service.
  Changes: Add WithSystemNodePool() to customize AKS system node pool VM size #16312
  📝 Documentation required

• ⏱️ BeforeStart pipeline steps (a id="13780")(/a)
  Support for adding pipeline steps that execute before the application starts, enabling pre-start validation, migrations, and other setup tasks.
  Changes: Add support for BeforeStart Pipeline steps #13780
  📝 Documentation required

• 📟 Command result support for resource commands (a id="15664")(/a)
  Resource commands can now return structured results—including HTTP responses—that are displayed in the Aspire dashboard.
  Changes: Add command result support for resource commands #15622, Add HTTP command result support for AppHost HTTP commands #15664
  📝 Documentation required

• 📂 Detect system-assigned managed identities (a id="15885")(/a)
  AzureCredentialHelper now detects and uses system-assigned managed identities in Azure-hosted environments.
  Changes: Detect system-assigned managed identities in AzureCredentialHelper #15885

• 🔌 Docker Compose APIs for polyglot AppHosts (a id="16364")(/a)
  Docker Compose publishing APIs are now available in polyglot (TypeScript, Python, Java) AppHosts, enabling Docker Compose deployments from non-C# AppHosts.
  Changes: Expose missing Docker Compose polyglot APIs #16364
  📝 Documentation required

• 🗄️ Entity Framework Core hosting integration (a id="13481")(/a)
  New Aspire.Hosting.EntityFrameworkCore hosting integration that runs EF Core database migrations as part of the AppHost startup pipeline.
  Changes: Add Aspire.Hosting.EntityFrameworkCore hosting integration for EF Core migration management #13481
  📝 Documentation required

• ✂️ Filter endpoints from the default reference set (a id="15558")(/a)
  New API allows filtering which endpoints are included when a resource is referenced by another project, giving finer control over service discovery exposure.
  Changes: Allow filtering endpoints from the default reference set #15558
  ⚠️ Breaking change
  📝 Documentation required

• 🔧 Durable Task Scheduler for Azure Functions (a id="13711")(/a)
  New hosting resources for Azure Durable Task Scheduler in Azure Functions applications.
  Changes: Addition of Durable Task Scheduler resources to Azure Functions host library #13711
  📝 Documentation required

• ☕ Java polyglot AppHost parity (a id="15470")(/a)
  Java polyglot AppHosts now have full feature parity with TypeScript and Python AppHosts including endpoint callbacks and environment exports.
  Changes: Add Java polyglot AppHost parity #15470
  📝 Documentation required

• 🐍 Python AppHost code generator (a id="13947")(/a)
  New Python code generator produces typed AppHost configuration files for Python-based distributed applications participating in the Aspire model.
  Changes: PythonAppHost Code Generator #13947
  📝 Documentation required

• 🚪 Azure Front Door hosting integration (a id="16137")(/a)
  New Aspire.Hosting.Azure.FrontDoor integration for adding Azure Front Door CDN and load balancing to Aspire applications.
  Changes: Add Azure Front Door hosting integration #16137
  📝 Documentation required

• ☸️ Azure Kubernetes Service (AKS) hosting support (a id="16088")(/a)
  New Aspire.Hosting.Kubernetes package with full AKS provisioning, Helm-based deployment, and a Kubernetes deployment pipeline.
  Changes: Add Kubernetes deploy pipeline with Helm engine #15723, Add Azure Kubernetes Service (AKS) hosting support #16088
  📝 Documentation required

• 🔒 Azure Network Security Perimeter support (a id="15711")(/a)
  Aspire resources can now be placed inside an Azure Network Security Perimeter, enabling network isolation for Azure-hosted applications.
  Changes: Add Azure Network Security Perimeter (NSP) support #15711
  📝 Documentation required

• 🔐 Private endpoints for Azure Container Registry (a id="16132")(/a)
  Azure Container Registry resources can now be configured with private endpoints for secure container image access.
  Changes: Support private endpoints for Azure Container Registry #16132
  📝 Documentation required

• 📦 Subscribe to resource lifecycle events (a id="14119")(/a)
  New extension methods on IDistributedApplicationBuilder make it easier to subscribe to resource lifecycle events such as startup and shutdown.
  Changes: Extension methods on IDistributedApplicationBuilder for subscribing to application level events. #14119
  📝 Documentation required

• 🔍 TryGetByName on IResourceCollection (a id="16389")(/a)
  New TryGetByName method on IResourceCollection for safely looking up resources by name without throwing when a resource is not found.
  Changes: Add TryGetByName to IResourceCollection #16389

• 🚀 JavaScript/Next.js app support with YARP (a id="15736")(/a)
  New AddNextJsApp method and JavaScript publish helpers for hosting Next.js applications in Aspire with integrated YARP reverse proxy routing.
  Changes: Add JavaScript publish methods, AddNextJsApp, and switch to YARP #15736
  📝 Documentation required

Improvements

• 🔗 ATS pipeline parity for polyglot AppHosts (a id="15826")(/a)
  The IDistributedApplicationPipeline API is now exported for polyglot (TypeScript, Python, Java) AppHosts via ATS.
  Changes: Add ATS pipeline parity for polyglot AppHosts #15826

• 🐋 Container tunnel enabled by default (a id="14557")(/a)
  The container tunnel is now enabled by default, improving container network connectivity across development environments.
  Changes: Enable container tunnel by default #14557

• 🌍 Custom domain support for polyglot ACA (a id="15811")(/a)
  Polyglot AppHosts can now configure Azure Container Apps custom domains.
  Changes: Add polyglot ACA custom domain support #15811

• 🐳 Docker .env file support for polyglot AppHosts (a id="15819")(/a)
  Polyglot Docker app hosts now support ConfigureEnvFile for loading environment variables from a .env file.
  Changes: Add ConfigureEnvFile support to polyglot Docker app hosts #15819

• 🔁 Endpoint callbacks for polyglot AppHosts (a id="15856")(/a)
  Polyglot AppHosts now support endpoint callback exports for dynamic endpoint configuration.
  Changes: Add polyglot endpoint callback exports #15856

• 📤 Image push options for polyglot AppHosts (a id="15809")(/a)
  Added withImagePushOptions support so polyglot AppHosts can control container image publishing settings.
  Changes: Add polyglot withImagePushOptions support #15809

• 📊 Logger property on ExecuteCommandContext (a id="15678")(/a)
  ExecuteCommandContext now exposes a Logger property for structured logging within resource command handlers.
  Changes: Add Logger property to ExecuteCommandContext #15678

• 🔄 WithEndpoint updates existing endpoints (a id="16039")(/a)
  WithEndpoint now updates an existing endpoint with the same name rather than throwing, making endpoint configuration more composable.
  Changes: Make WithEndpoint update existing endpoints instead of throwing #16039

Bug fixes

• 🔧 Fix OTLP endpoint resolution in isolated mode (a id="16367")(/a)
  Fixed OTLP endpoint resolution when AppHost runs in isolated process mode with a backchannel.
  Changes: Fix OTLP endpoint resolution in isolated mode #16367

• 🔧 Fix aspire stop not cleaning up containers (a id="16006")(/a)
  The aspire stop command now properly stops and removes application containers.
  Changes: Fix issue 15806 ("aspire stop" is not cleaning up application containers) #16006

• 🔧 Fix container creation event ordering (a id="15503")(/a)
  Fixed the order of events and callbacks invoked during container resource creation.
  Changes: Fix event order and callback calling during container creation #15503

⌨️ CLI

11 new features, 10 improvements, 6 bug fixes

New features

• 💥 aspire destroy command (a id="16097")(/a)
  New aspire destroy command tears down a previously deployed Aspire environment, removing all provisioned Azure resources.
  Changes: Add aspire destroy command for tearing down deployed environments #16097
  📝 Documentation required

• 📊 aspire dashboard command (a id="15607")(/a)
  New aspire dashboard command opens the Aspire dashboard in a browser directly from the command line, without starting the full app host.
  Changes: Add aspire dashboard CLI command #15607
  📝 Documentation required

• 🚢 aspire docs API sub-commands (a id="15814")(/a)
  New aspire docs api * sub-commands display aspire.dev API reference documentation directly in the terminal.
  Changes: Add aspire docs api * sub-commands to expose aspire.dev reference material #15814

• 🌳 Hide hidden resources by default (a id="16146")(/a)
  CLI commands (describe, logs, export) now hide internal hidden resources by default. Use the new --include-hidden flag to show them.
  Changes: CLI: Hide hidden resources by default in describe/logs/export, add --include-hidden option #16146
  ⚠️ Breaking change

• 📝 Markdig-based documentation rendering (a id="16342")(/a)
  The CLI now uses Markdig for rendering Markdown content in documentation output, producing better-formatted tables, code blocks, and links.
  Changes: Use Markdig for Aspire CLI docs rendering #16342

• 🔇 Non-interactive CLI mode with PromptBinding (a id="16235")(/a)
  New PromptBinding infrastructure allows CLI commands to run in non-interactive mode, supplying prompt answers via configuration or flags.
  Changes: Add PromptBinding infrastructure for non-interactive CLI mode #16235
  📝 Documentation required

• 🐙 Podman support for Docker Compose deployment (a id="16074")(/a)
  The aspire deploy docker-compose command now supports Podman as an alternative to Docker for building and running containers.
  Changes: Add Podman support for Docker Compose deploy and unify container runtime abstraction #16074
  ⚠️ Breaking change

• 📋 List steps for aspire do (a id="16085")(/a)
  New --list-steps flag for aspire do lists all available pipeline steps without executing them.
  Changes: Add --list-steps flag to aspire do command #16085

• 🔑 Dashboard URL and API key flags (a id="15595")(/a)
  New --dashboard-url and --api-key flags for aspire agent mcp and aspire describe allow connecting to an already-running dashboard.
  Changes: Add --dashboard-url and --api-key options to aspire agent mcp and aspire otel commands #15595
  📝 Documentation required

• 📍 Disambiguate duplicate paths in aspire ps (a id="16199")(/a)
  aspire ps now shows additional path context when multiple AppHosts share the same name, making it easier to identify the right process.
  Changes: Disambiguate duplicate paths in aspire ps output #16199

• 🌿 Environment variables in VS Code debug launch config (a id="16449")(/a)
  The Aspire VS Code debug launch configuration now supports setting environment variables for the app host process.
  Changes: Add env support to Aspire debug launch configuration #16449
  📝 Documentation required

Improvements

• 🎨 ANSI colors for CLI emojis (a id="16089")(/a)
  CLI emojis now include ANSI color codes so they render correctly on monochrome and legacy terminals.
  Changes: Add ANSI text colors to CLI emoji for monochrome terminal rendering #16089

• 🏷️ Rename endpoints column to URLs in describe (a id="16144")(/a)
  The endpoints column in aspire describe output has been renamed to URLs for clarity.
  Changes: Rename describe endpoints column to URLs #16144

• 📋 Surface build output on failure (a id="16303")(/a)
  Build errors from Docker, Podman, and dotnet publish are now surfaced to the user when a build step fails.
  Changes: Surface build output on failure for Docker, Podman, and dotnet publish #16093, Surface process output on failure #16303

• 📊 F# and VB project upgrade support (a id="15799")(/a)
  aspire upgrade now supports F# (.fsproj) and VB (.vbproj) projects in addition to C# projects.
  Changes: Support upgrading F# and VB projects #15799

• 🔒 Pre-export dev certificate to Aspire cache (a id="16282")(/a)
  The development TLS certificate is now pre-exported to the Aspire cache directory on macOS, avoiding repeated keychain access prompts.
  Changes: Pre-export dev certificate to Aspire cache to avoid macOS keychain prompts #16282

• 😀 Emoji and localization in deployment activity log (a id="16084")(/a)
  The CLI deployment activity log now uses contextual emojis and localized strings for clearer progress reporting.
  Changes: Use emoji in ConsoleActivityLogger summary and localize strings #16084

• 📊 OpenTelemetry activity for app host execution (a id="16346")(/a)
  The CLI now records an OpenTelemetry activity span covering the full app host run, enabling CLI performance tracing.
  Changes: Add telemetry activity for running app host in CLI #16346

• 🔗 Clickable dashboard hyperlinks in telemetry commands (a id="16079")(/a)
  Dashboard URLs shown by aspire otel, aspire traces, and related commands are now rendered as clickable hyperlinks in terminals that support them.
  Changes: Add clickable dashboard hyperlinks to CLI telemetry commands #16079

• 🖇️ Trace IDs as clickable links (a id="16345")(/a)
  Trace IDs in the CLI are now rendered as clickable hyperlinks that open the trace detail view in the dashboard.
  Changes: Make trace ID a clickable link in trace detail view #16345

• 🔄 Improved aspire start --format json restart output (a id="16228")(/a)
  The restart event in aspire start --format json output now includes correct resource state information.
  Changes: Fix aspire start --format json restart output #16228

Bug fixes

• 🔧 Fix ANSI leaks in plain log output (a id="16225")(/a)
  ANSI escape sequences no longer appear in plain text log output when running without a color-capable terminal.
  Changes: Fix ANSI leaks in plain logs and telemetry output #16225

• 🔧 Fix aspire docs cache and rendering (a id="16304")(/a)
  Fixed issues where cached documentation would not render correctly and stale cached entries were not invalidated.
  Changes: Fix aspire docs cache and output rendering #16304

• 🔧 Fix aspire start in VS Code integrated terminal (a id="15980")(/a)
  Fixed a failure when running aspire start from within the VS Code integrated terminal.
  Changes: Fix aspire start failing in VS Code integrated terminal #15980

• 🔧 Fix aspire wait for JSON-emitted resource names (a id="16224")(/a)
  aspire wait now correctly resolves resource names emitted in JSON format from the app host.
  Changes: Fix aspire wait for JSON-emitted resource names #16224

• 🔧 Remove Docker Engine tunnel warning from aspire doctor (a id="16343")(/a)
  Removed an obsolete Docker Engine tunneling warning from aspire doctor output.
  Changes: Remove obsolete Docker Engine tunnel warning from aspire doctor #16343

• 🔧 Warn instead of failing on missing channel package (a id="16337")(/a)
  The CLI now issues a warning instead of failing when a package is missing from the update channel.
  Changes: Warn instead of failing when a package is missing from the channel during aspire update #16337

📊 Dashboard

5 new features, 3 improvements, 3 bug fixes

New features

• 🌐 Tracked browser logs and network capture (a id="16310")(/a)
  The Aspire dashboard now captures and displays browser console logs and network requests from monitored applications for easier debugging.
  Changes: Add tracked browser logs and network capture #16310
  📝 Documentation required

• 🔑 Dashboard telemetry API enabled by default with ApiKey auth (a id="16326")(/a)
  The dashboard's telemetry API is now enabled by default and secured with API key authentication and login token support.
  Changes: Enable dashboard telemetry API by default with ApiKey auth and login token exchange #16326
  📝 Documentation required

• i️ InfoPopover for resource state column (a id="15996")(/a)
  The dashboard resource list now shows an info popover on the state column with clickable links to related resources and documentation.
  Changes: Dashboard: Add InfoPopover for state column with clickable links #15996

• 🔔 Notification center and markdown command responses (a id="15906")(/a)
  A new notification center in the dashboard surfaces command results and system messages, with full Markdown rendering support for rich content.
  Changes: Add notification center, command response message, and markdown support to Dashboard #15906
  📝 Documentation required

• 📊 Parameters page improvements (a id="16117")(/a)
  The dashboard Parameters page now supports clickable set-value links and shows warning badges when parameter values are in an unexpected state.
  Changes: Dashboard: Parameters page follow-ups - clickable set value, warning badge, filter by resource #16117

Improvements

• 🏷️ Display names in lifecycle command responses (a id="16143")(/a)
  Lifecycle command response messages (start, stop, restart) now use the resource's display name for clarity.
  Changes: Use display name in lifecycle command response messages #16143

• 🔒 Disable autocomplete on dashboard search and inputs (a id="16297")(/a)
  Browser autocomplete is now disabled on dashboard search fields and inputs to prevent unintended autofill.
  Changes: Disable browser autocomplete on dashboard search and input fields #16297

• 📋 Move user secrets descriptions to checkbox inputs (a id="16293")(/a)
  User secrets checkbox descriptions are now positioned adjacent to their inputs for better layout and accessibility.
  Changes: Move user secrets descriptions to checkbox inputs #16293

Bug fixes

• 🔧 Fix dropdown value binding when options change (a id="16315")(/a)
  Fixed a data binding issue in FluentSelect/FluentCombobox components where the selected value was lost when the options list changed.
  Changes: Fix FluentSelect/FluentCombobox value binding when options change #16315

• 🔧 Fix OTLP JSON histogram deserialization (a id="16376")(/a)
  Fixed parsing of OTLP JSON payloads where numeric (non-string) histogram bucketCounts caused a deserialization error.
  Changes: Fix OTLP JSON deserialization of numeric histogram bucketCounts #16376

• 🔒 Fix open redirect vulnerability (a id="15952")(/a)
  Fixed a security vulnerability in the dashboard that allowed crafted URLs to redirect users to external sites.
  Changes: Fix open redirect vulnerability #15952

🧩 Extensions

3 new features, 4 improvements

New features

• 🌐 Open AppHost source action (a id="15668")(/a)
  A new VS Code action lets developers quickly navigate to the AppHost source file from the Aspire extension panel.
  Changes: Add open AppHost source action to VS Code extension #15668

• 🖥️ Open Aspire Dashboard in Command Palette (a id="15499")(/a)
  A new "Open Aspire Dashboard" command is now available in the VS Code Command Palette for quick access to the dashboard.
  Changes: Add 'Open Aspire Dashboard' to Command Palette #15499

• 🪟 Simple Browser option for dashboard launch (a id="15896")(/a)
  The VS Code extension can now open the Aspire dashboard in VS Code's built-in Simple Browser instead of an external browser.
  Changes: Add Simple Browser option for dashboard launch #15896

Improvements

• 🔍 Auto-detect CLI at default install paths (a id="14545")(/a)
  The VS Code extension now finds the Aspire CLI at standard installation paths (e.g., ~/.dotnet/tools) even when it is not on the system PATH.
  Changes: Detect CLI at default install paths when not on PATH #14545

• 🔄 Auto-restore on workspace open and config change (a id="15546")(/a)
  The VS Code extension automatically runs aspire restore when a workspace is opened or the Aspire configuration changes, keeping TypeScript modules up to date.
  Changes: VS Code extension: Auto-restore on workspace open and config change #15546

• 📊 Improved gutter decorations, code lens, and tree view (a id="15688")(/a)
  Resource status is now reflected more accurately in the editor gutter, code lens annotations, and the extension's tree view.
  Changes: VS Code extension: Improve gutter, code lens, and tree view resource state indicators #15688

• 🔍 Improved VS Code extension discoverability (a id="15760")(/a)
  Updates to the extension marketplace listing improve its discoverability for developers searching for Aspire tooling.
  Changes: Improve Aspire VS Code extension discoverability #15760

🔌 Integrations

2 improvements, 1 bug fix

Improvements

• 📊 Enable RabbitMQ tracing by default (a id="15659")(/a)
  RabbitMQ client integration (v7) now enables OpenTelemetry distributed tracing by default.
  Changes: Enable tracing for RabbitMQ Component (v7) #15659
  📝 Documentation required

• 🧹 Use official OpenTelemetry.SqlClient package (a id="14621")(/a)
  The vendored OpenTelemetry.Instrumentation.SqlClient code has been replaced with the official NuGet package, keeping SQL Server instrumentation up to date.
  Changes: Remove vendored OpenTelemetry.Instrumentation.SqlClient code #14621

Bug fixes

• 🔧 Fix Npgsql custom histogram view on .NET 10+ (a id="16044")(/a)
  The custom Npgsql histogram metric view is no longer registered on .NET 10 and later, where it caused a conflict with the built-in view.
  Changes: Remove custom Npgsql histogram view on .NET 10+ #16044

📄 Templates

1 new feature

New features

• 🐍 Python template migrated to TypeScript AppHost (a id="15574")(/a)
  The aspire new python starter template now uses a TypeScript AppHost instead of a C# AppHost, aligning it with the polyglot-first direction for non-.NET languages.
  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").

Generated by Milestone Changelog Generator · ● 2M · ◷