What's new in .NET Aspire 9.2 #2877

IEvangelist · 2025-03-20T20:21:25Z

Summary

What is new in 9.2 - layout...

Internal previews

📄 File	🔗 Preview link
docs/toc.yml	docs/toc
docs/whats-new/dotnet-aspire-9.2.md	What's new in .NET Aspire 9.2
docs/whats-new/index.yml	.NET Aspire — what's new?
docs/whats-new/toc.yml	docs/whats-new/toc

adegeo

A lot of feedback for this one 😁 Did you acro it? You told me to review the draft.. so that's your fault 😆

Approved to unblock.

One other feedback I had was around the TOC for this whole section. It repeats the "what's new" text for two items back-to-back and that looks ugly.

Unfortunately I can't suggest a change here because it's out of the scope GitHub is giving me 😆

docs/whats-new/dotnet-aspire-9.2.md

Co-authored-by: Andy (Steve) De George <67293991+adegeo@users.noreply.github.com>

davidfowl · 2025-04-06T20:32:30Z

AppModel

New connection string resource types - Enhance resource management for connection strings aspire#7826
Resource can now customize the URLs - Support specifying custom URLs for resources aspire#8229
Added WithHttpCommand - Add WithHttpCommand aspire#7962
Expose Image Pull Policy on Container resources - Expose Image Pull Policy on Containers aspire#7350
Support for creating files with docker/podman cp - Add support for creating files and folders in a container via docker/podman cp aspire#8121

Integrations

Redis/Valkey/Garnet now has password support (by default) - Reapply Redis password aspire#7599
Support named configuration providers for Aspire resources - Support named configuration providers for Aspire resources aspire#5826
Support deep linking of various resources - Support deep-linking to child resources in CosmosDB, EventHubs, ServiceBus aspire#7907, Add Cosmos database builder pattern for child containers aspire#8266, Configure OpenAI models in the app host aspire#6577
Support creating databases (and with custom script) for Postgres and SqlServer - (Create an empty database for AddDatabase calls aspire#7101), Create database for Postgres resource aspire#8085, Create database for Sql Server resource aspire#8022

Dashboard

Testing

Updated unit test template to xunit 3 - Update xUnit.net testing template to support xUnit.net v3 aspire#7225

Tooling

Introduction of the aspire CLI (preview)

Deployment

Introduction of publishers (preview)
- Docker compose (preview) - Docker Compose publishing aspire#7963
- Kubernetes (preview) - k8s first pass aspire#8260
- Azure (preview) - Introduce the azure publisher aspire#8050

Azure

Improve Azure Managed Identity Defaults - Improve Azure Managed Identity Defaults aspire#6161
First class Azure Postgres integration (Managed Identity etc) - Consider building an Azure Postgres client integration aspire#6669
Added AddAzureContainerAppEnvironment() to Aspire.Hosting.Azure.AppContainers - Move remaining ACA infrastructure generation to Aspire.Hosting.Azure.AppContainers aspire#7076
Deprecate BicepSecretOutput and build a first class AzureKeyVaultSecretReference - Introduce AzureKeyVaultSecretReference aspire#8171, Deprecate BicepSecretOutput and build a first class AzureKeyVaultSecretReference aspire#8134
Make the default role for KeyVault references to Key Vault Secrets User - Make the default role for KeyVault references to Key Vault Secrets User aspire#8218

Bug Fixes

API Diff

dotnet/aspire#7811

cc @DamianEdwards @JamesNK @mitchdenny @eerhardt @maddymontaquila @sebastienros @captainsafia

docs/whats-new/dotnet-aspire-9.2.md

maddymontaquila · 2025-04-08T15:18:48Z

docs/whats-new/dotnet-aspire-9.2.md

+
+## 💔 Breaking changes
+
+With every release, we strive to make .NET Aspire better. However, some changes may break existing functionality. The following breaking changes are introduced in .NET Aspire 9.2:


We need to make sure we call out #2914 as a breaking change at the top if we dont get a workaround for it merged

docs/whats-new/dotnet-aspire-9.2.md

JamesNK · 2025-04-10T01:08:03Z

There are lots of dashboard features missing. I added details about all of the major changes to a channel.

Or you can look at my twitter/bluesky and copy from there 😄

Co-authored-by: Maddy Montaquila (Leger) <maddyleger1@gmail.com>

docs/whats-new/dotnet-aspire-9.2.md

Co-authored-by: David Fowler <davidfowl@gmail.com>

davidfowl · 2025-04-10T14:14:41Z

docs/whats-new/dotnet-aspire-9.2.md

+
+The Redis, Valkey, and Garnet containers enable password authentication by default. This is part of our goal to be secure by default—protecting development environments with sensible defaults while still making them easy to configure. Passwords can be set explicitly or generated automatically if not provided.
+
+### Automatic database creation support for Postgres and SQL Server


@sebastienros

davidfowl · 2025-04-10T14:16:45Z

docs/whats-new/dotnet-aspire-9.2.md

+
+The .NET Aspire app host project file no longer requires the `IsAspireHost` property. This property was moved to the `Aspire.AppHost.Sdk` SDK, therefore, you can remove it from your project file. For more information, see [dotnet/aspire issue #8144](https://github.com/dotnet/aspire/pull/8144).
+
+### 🔗 Define custom resource URLs


@DamianEdwards

docs/whats-new/dotnet-aspire-9.2.md

davidfowl · 2025-04-10T14:23:17Z

docs/whats-new/dotnet-aspire-9.2.md

+
+This makes it easy and convenient to use the SDKs to interact with specific resources directly—without extra wiring or manual configuration. It's especially useful in apps that deal with multiple containers or Azure services.
+
+### 🛡️ Improved Managed Identity defaults


davidfowl · 2025-04-10T14:23:25Z

docs/whats-new/dotnet-aspire-9.2.md

+
+This new identity model is an important step toward more secure and maintainable applications in Aspire. While it introduces some setup considerations, especially for database integrations, it lays the groundwork for better default security across the board.
+
+### 🔑 WithRoleAssignments


docs/whats-new/dotnet-aspire-9.2.md

davidfowl · 2025-04-10T14:30:52Z

docs/whats-new/dotnet-aspire-9.2.md

+
+The following publishers are available:
+
+- [📦 Aspire.Hosting.Azure](https://www.nuget.org/packages/Aspire.Hosting.Azure)


Suggested change

- [📦 Aspire.Hosting.Azure](https://www.nuget.org/packages/Aspire.Hosting.Azure)

- [📦 Aspire.Hosting.Azure](https://www.nuget.org/packages/Aspire.Hosting.Azure) (The azure publisher is a preview feature)

docs/whats-new/dotnet-aspire-9.2.md

Co-authored-by: David Fowler <davidfowl@gmail.com>

docs/whats-new/dotnet-aspire-9.2.md

IEvangelist · 2025-04-10T14:40:41Z

docs/whats-new/dotnet-aspire-9.2.md

+For more information, see [Custom HTTP commands in .NET Aspire](../fundamentals/http-commands.md).
+### 🗂️ Connection string resource type
+
+We've introduced a new ConnectionStringResource type that makes it easier to build dynamic connection strings without defining a separate resource


Suggested change

We've introduced a new ConnectionStringResource type that makes it easier to build dynamic connection strings without defining a separate resource

We've introduced a new `ConnectionStringResource` type that makes it easier to build dynamic connection strings without defining a separate resource

docs/whats-new/dotnet-aspire-9.2.md

Co-authored-by: David Fowler <davidfowl@gmail.com>

eerhardt · 2025-04-10T15:34:46Z

docs/whats-new/dotnet-aspire-9.2.md

+| [📦 Aspire.Hosting.SqlServer](https://www.nuget.org/packages/Aspire.Hosting.SqlServer) | <xref:Aspire.Hosting.SqlServerBuilderExtensions.AddDatabase*> |
+| [📦 Aspire.Hosting.PostgreSql](https://www.nuget.org/packages/Aspire.Hosting.PostgreSql) | <xref:Aspire.Hosting.PostgresBuilderExtensions.AddDatabase*> |
+
+The Azure SQL and Azure PostgreSQL hosting integrations both expose an `AddDatabase` API, but they don't create a database—unless you call their respective `RunAsContainer` methods. For more information, see [Understand Azure integration APIs](../azure/integrations-overview.md#understand-azure-integration-apis).


@davidfowl @sebastienros - what does this line mean exactly?

Azure SQL And Azure PostgreSQL will create the database in Azure via bicep.

Correct, the database is created. The script won't run though so if it has more than CREATE DATABASE people might get confused.

We could imagine implementing it as part of a deployment script too to seed even and Azure database when it's deployed. Migration scripts.

I tweaked the wording here in #3066. If it needs to be adjusted, can you create a PR to change it?

* Remove IsAspireHost bits. Fixes #2847 * New dashboard config to disable resource graph (#2874) * Fixes #2842 * Update configuration.md Co-authored-by: James Newton-King <james@newtonking.com> --------- Co-authored-by: James Newton-King <james@newtonking.com> * Position VS Code first * Add clarifying details about updates to `AddDatabase` APIs (#2878) * Contributes to #2789 * Added PostgreSQL and links to eventing * Quick edit pass * Apply suggestions from code review Co-authored-by: Andy (Steve) De George <67293991+adegeo@users.noreply.github.com> --------- Co-authored-by: Andy (Steve) De George <67293991+adegeo@users.noreply.github.com> * Adding GitHub Copilot prompts (#2896) * Initial prompts * Update prompts * Adding content for `WithHttpCommand` (#2875) * Initial setup * Rework HTTP command content with an example * Add images and more details. * Edit pass * Added playground sample * Update HTTP command content with updated source * Remove duplicated code snippet * Correct member over parameter * Fix name * Correct postgres connection command * Update kafka-integration.md (#2712) Change links von provectuslabs to Kafbat * Add role assignments with .NET Aspire (#2891) * Getting closer on adding roles details * Apply suggestions from code review Co-authored-by: Andy (Steve) De George <67293991+adegeo@users.noreply.github.com> * Address feedback and update content * Add to TOC * Edit pass * Add link * Fix a few issues * Remove absolute URL --------- Co-authored-by: Andy (Steve) De George <67293991+adegeo@users.noreply.github.com> * Breaking changes for .NET Aspire 9.2 (#2892) * Added breaking changes for 9.2, fixes #2888 and fixes #2889 * Correct TOC * Add clarifying type name * Fixes #2899 * Added new breaking changes docs * Remove link * Correct MD lint error/warnings * Bump bicep bits (#2930) * Update docs to use `EndpointProperty.HostAndPort` where appropriate (#2934) Fixes #2646 * Reorganize the order of the Azure storage content (#2937) * Fixes #2935 * Tweak table style * Apply suggestions from code review Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com> --------- Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com> * Add content on customizing resource URLs (#2940) * Fixes #2936 * Correct TOC * Minor tweaks * Apply suggestions from code review Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: Damian Edwards <damian@damianedwards.com> * Apply suggestions from code review * Apply suggestions from code review * Apply suggestions from code review * Apply suggestions from code review --------- Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Co-authored-by: Damian Edwards <damian@damianedwards.com> * Add CosmosDB parent-child relationship bits. (#2912) * Add CosmosDB parent-child relationship bits. Part of #2907 * A few fixes * Update docs/database/azure-cosmos-db-integration.md Co-authored-by: Safia Abdalla <safia@safia.rocks> * Update docs/database/azure-cosmos-db-integration.md Co-authored-by: Safia Abdalla <safia@safia.rocks> * A few updates based on feedback * Add a few more bits * Add more details about the web pubsub. * Apply suggestions from code review Co-authored-by: Safia Abdalla <safia@safia.rocks> --------- Co-authored-by: Safia Abdalla <safia@safia.rocks> * Add new Azure PostgreSQL client integrations. (#2905) * Replace manual identity code with new package. Fixes #2883 * Add xref reminders. * Replace standard clients * Correct leading para * Apply suggestions from code review * Adjustment from peer reviews * Correct terminology * .NET Aspire 💜 Playwright (#2904) * WIP * Initial bits in place * Yeah, now we're cookin'! * OMG, I'm having too much fun! * Add a few more bits * Encapsulate selector. * Even more images automated, and better coverage. * More coverage... * Added more coverage. * More images and coverage. * A bit more clean up * Added a few more bits and updated. * Fixed link issue * Fix last issue * Tracing and structured log pages * Apply suggestions from code review * Update docs/fundamentals/dashboard/automation/aspire-dashboard/Aspire.Dashboard.ScreenCapture/README.md * Add "Configure Azure Container App environments" article (#3058) * Yuck, too rough of a draft but need to context switch. * Tweaks * Let's go, this fixes #2938 * Apply suggestions from code review Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com> --------- Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com> * What's new in .NET Aspire 9.2 (#2877) * Add initial bits for #2869. What's new in .NET Aspire 9.2 * Add a few more what's new bits * Add dashboard config * Add initial details about HTTP commands * Apply suggestions from code review Co-authored-by: Andy (Steve) De George <67293991+adegeo@users.noreply.github.com> * Edit pass * Add link to breaking changes * Removed MS-collected telemetry * Try toying with TOC * Expand product updates * Apply suggestions from code review Co-authored-by: Maddy Montaquila (Leger) <maddyleger1@gmail.com> * Delete section * Update .NET Aspire 9.2 documentation * Update docs/whats-new/dotnet-aspire-9.2.md * Update connection string and deployment section * Added testing updates * Update docs/whats-new/dotnet-aspire-9.2.md Co-authored-by: James Newton-King <james@newtonking.com> * Clean up * Minor updates * Apply suggestions from code review Co-authored-by: David Fowler <davidfowl@gmail.com> * Apply suggestions from code review Co-authored-by: David Fowler <davidfowl@gmail.com> * Apply suggestions from code review Co-authored-by: David Fowler <davidfowl@gmail.com> * Apply suggestions from code review Co-authored-by: David Fowler <davidfowl@gmail.com> * Add images * Final tweaks before release branch --------- Co-authored-by: Andy (Steve) De George <67293991+adegeo@users.noreply.github.com> Co-authored-by: Maddy Montaquila (Leger) <maddyleger1@gmail.com> Co-authored-by: David Fowler <davidfowl@gmail.com> Co-authored-by: Mitch Denny <midenn@microsoft.com> Co-authored-by: James Newton-King <james@newtonking.com> * Bump versions * nits (#3064) * Fix build issues * More fixes * Move things * Move even more things * Point to 9.2 * Fix bookmakrs --------- Co-authored-by: James Newton-King <james@newtonking.com> Co-authored-by: Andy (Steve) De George <67293991+adegeo@users.noreply.github.com> Co-authored-by: Stefan Nikolei <stefan@nikolei.eu> Co-authored-by: Alex Crome <afscrome@users.noreply.github.com> Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Co-authored-by: Damian Edwards <damian@damianedwards.com> Co-authored-by: Safia Abdalla <safia@safia.rocks> Co-authored-by: Maddy Montaquila (Leger) <maddyleger1@gmail.com> Co-authored-by: David Fowler <davidfowl@gmail.com> Co-authored-by: Mitch Denny <midenn@microsoft.com>

IEvangelist changed the title ~~Add initial bits for #2869. What's new in .NET Aspire 9.2~~ What's new in .NET Aspire 9.2 Mar 21, 2025

adegeo reviewed Mar 25, 2025

View reviewed changes

adegeo approved these changes Mar 25, 2025

View reviewed changes

IEvangelist and others added 10 commits April 3, 2025 10:53

Add initial bits for dotnet#2869. What's new in .NET Aspire 9.2

6da1ca2

Add a few more what's new bits

89a0809

Add dashboard config

dd178bd

Add initial details about HTTP commands

6169908

Apply suggestions from code review

29ff8d8

Co-authored-by: Andy (Steve) De George <67293991+adegeo@users.noreply.github.com>

Edit pass

9280279

Add link to breaking changes

e2b7e03

Removed MS-collected telemetry

e303adf

Try toying with TOC

12f2023

Expand product updates

3726a5d

IEvangelist force-pushed the what-is-new-in-9.2 branch from 4b09393 to 3726a5d Compare April 3, 2025 15:54

afscrome mentioned this pull request Apr 8, 2025

Remove <IsAspireHost>true</IsAspireHost> in this repo dotnet/aspire#8630

Closed

maddymontaquila reviewed Apr 8, 2025

View reviewed changes

DamianEdwards reviewed Apr 9, 2025

View reviewed changes