.NET Aspire release 9.3 content by IEvangelist · Pull Request #3368 · dotnet/docs-aspire

IEvangelist · 2025-05-07T17:22:48Z

Summary

.NET Aspire release 9.3 content

In this PR:

Internal previews

Toggle expand/collapse

📄 File	🔗 Preview link
docs/app-host/configuration.md	App host configuration
docs/app-host/eventing.md	Eventing in .NET Aspire
docs/architecture/overview.md	.NET Aspire architecture overview
docs/azure/azure-app-configuration-integration.md	docs/azure/azure-app-configuration-integration
docs/azure/container-registry-integration.md	.NET Aspire Azure Container Registry integration (Preview)
docs/azure/integrations-overview.md	Azure integrations overview
docs/azure/user-assigned-managed-identity.md	User-assigned managed identities in .NET Aspire
docs/azureai/azureai-inference-integration.md	docs/azureai/azureai-inference-integration
docs/community-toolkit/dapr.md	.NET Aspire Dapr integration
docs/compatibility/9.3/azure-sql-server-default-sku-changes.md	Change the default SKU used for creating a new Azure SQL database
docs/compatibility/9.3/azure-sql-server-default-uami-admin.md	"Breaking change - AddAzureSqlServer assigns a dedicated user-assigned managed identity as the administrator"
docs/compatibility/9.3/index.md	Breaking changes in .NET Aspire 9.3
docs/compatibility/9.3/remove-publisher-apis.md	Removal of DockerComposePublisher, KubernetesPublisher, and AzurePublisher
docs/compatibility/9.3/with-health-checks-changes.md	docs/compatibility/9.3/with-health-checks-changes
docs/compatibility/toc.yml	docs/compatibility/toc
docs/database/azure-cosmos-db-integration.md	.NET Aspire Azure Cosmos DB integration
docs/fundamentals/app-host-overview.md	.NET Aspire orchestration overview
docs/fundamentals/custom-resource-urls.md	Define custom resource URLs
docs/fundamentals/dashboard/copilot.md	docs/fundamentals/dashboard/copilot
docs/fundamentals/dashboard/microsoft-collected-dashboard-telemetry.md	Microsoft-collected dashboard telemetry
docs/fundamentals/dashboard/overview.md	.NET Aspire dashboard overview
docs/fundamentals/dashboard/standalone.md	Standalone .NET Aspire dashboard
docs/index.yml	docs/index
docs/reference/aspire-faq.yml	Frequently asked questions about .NET Aspire
docs/storage/azure-storage-queues-integration.md	.NET Aspire Azure Queue Storage integration
docs/toc.yml	docs/toc
docs/whats-new/dotnet-aspire-9.3.md	What's new in .NET Aspire 9.3
docs/whats-new/index.yml	.NET Aspire — what's new?
docs/whats-new/toc.yml	docs/whats-new/toc

* wip * wip * update * add image * Revision based on suggestions, add to TOC * Apply suggestions from code review * Clarify command/resource type names not sent --------- Co-authored-by: Adam Ratzman <adamratzman@microsoft.com> Co-authored-by: David Pine <david.pine@microsoft.com>

* Clean up * Fix icon

* Initial draft of new user-assigned managed ids. * Edit pass and TOC reposition. * Fix issue with backticks * Minor updates

* Fixes #3373, removal of publisher APIs. * Minor tweaks * Edit pass * Sort table * Apply suggestions from code review Co-authored-by: David Fowler <davidfowl@gmail.com> * Address feedback --------- Co-authored-by: David Fowler <davidfowl@gmail.com>

* Add ACR hosting integration content. Fixes #3222 * Fix code ref * Address feedback * Add TOC preview * Adjust code bit

… user-assigned managed id. (#3391)

* Fixes #3372. Adds new eventing APIs. * Minor edit for constistency * Fix output * Fix build * Try to fix highlighting

davidfowl · 2025-05-13T15:52:11Z

Dump before polish

App Model

Made it easier set the ports, passwords, and usernames on various containers resources (Add ability to configure Port and Password for Redis and Postgres and SqlServer when they configured to run by RunAsContainer aspire#8439)
Improvements to adding custom urls to resources (streamlined!) (Custom URLs improvements aspire#8743) (More URL fixes aspire#8749)
- Easier apis, you can control where urls show up (summary , details)
Resources can be hidden without setting the state (using the IsHidden bool) (Add hidden to protocol, support in dashboard aspire#9069)
New resource events
- InitializeResourceEvent - Custom resources can use event this to start their lifecycle
- ResourceEndpointsAllocatedEvent - Use this event to know when a resource has allocated its endpoints.

Integrations

Added preview of Yarp integration (Add YARP container support aspire#8856) - Need code sample
MySQL integration creates database (MySql.AddDatabase creates database for resource aspire#8912)

Dashboard

Remember resource filter states (Remember resource filter states aspire#8593)
Treat uninstrumented outgoing peers are instrumented resources in dashboard UI (Treat uninstrumented outgoing peers are instrumented resources in dashboard UI aspire#8883)
Add URLs to console logs actions and context menu (Add URLs to console logs actions and context menu aspire#8759)
Add context menu to resource graph, improve console logs actions (Add context menu to resource graph, improve console logs actions aspire#8691)
Add pause warning to metrics Add pause warning to metrics aspire#9207
Use friendly name in console logs with single replica Use friendly name in console logs with single replica aspire#8470

Deployment

Reworked publisher model to support multiple resources (Implement new "default" publisher aspire#9096)
```
AddDockerComposeEnvironment
AddKubernetesEnviroment
AddAzureEnvironment
```
Added support for compute environment resources
```
WithComputeEnvironment
```

Docker Compose

Added support for modifying docker compose file and services part of publish flow via C# (Model Docker Compose as compute environment aspire#8828)
Added ability to map parameters and other expressions to docker compose values (Add method to emitting env placeholders aspire#9187)
Added ability to disable image building.
We no longer clobber .env files on subsequent generation (Don't clobber env files aspire#9161)

Kubernetes

Added support for manipulating k8s manifests as part of publish flow via C#.

Azure

Create and connect to blob containers directly in the app model (AzureStorage auto create blob containers aspire#9008)

Hosting
```
AddBlobContainer
```
Client
```
AddAzureBlobContainerClient
AddKeyedAzureBlobContainerClient
```
Added more keyvault client integration apis (Add CertificateClient and KeyClient support to Aspire.Azure.Security.KeyVault aspire#8408)
```
AddAzureKeyVaultKeyClient
AddAzureKeyVaultCertificateClient
```
Added overload of WithEnvironment that takes a IAzureKeyVaultSecretReference. (Added WithEnvironment overload supporting Keyvault secret refs aspire#8821)
Added support for modeling a User Assigned Identity (Add support for creating and using user-assigned identities aspire#9130)
Alpha support for Azure App Service (Preview) (Added initial support for app service as a compute environment aspire#9090)
- Public endpoints only
- Single HTTP endpoint
- .NET projects only
- Single app service plan
- Default Tier P0V3, Premium
- Linux containers based AppService
Added an AzureContainerRegistryResource. This allows you to model and deploy your applications to an existing ACR resource. (Add hosting integration for Azure Container Registry aspire#9059)
Added support for Azure.AI.Inference client integration (Preview) (Integration for Azure.AI.Inference aspire#9103)
Added Azure App Configuration client integration (Azure App Configuration client integration aspire#8945)
Changed how managed identity works for SQL server resources (Improve managed identity for sql server aspire#9041)
- Enable executing role assignments to managed identities by executing SQL queries
Changed default SQL SKU to the free SQU (Make it easier to choose Azure SQL SKU aspire#8887)

Azure Developer CLI (azd)

Revamped parameter handling in CI/CD scenarios
- Update pipeline config - provider parameters Azure/azure-dev#5143
- handle existing ci variables and secrets Azure/azure-dev#5190

Aspire CLI

Lots of stability fixes, better error handling and changes to publish
Searches for apphost project recursively and writes a .aspire folder to remember it (Improve apphost discovery. aspire#8892)
Waits for dashboard to be healthy before showing the link (Wait for dashboard to be healthy before returning URL via RPC (revert-revert) aspire#9044)

API Diff

dotnet/aspire#8736

* WIP * Early draft * Getting closer, still needs more refinement * Minor tweak * More updates * Added app topology examples * Add note about eventual consistency * Edit pass * Fix link * Apply suggestions from code review Co-authored-by: Andy (Steve) De George <67293991+adegeo@users.noreply.github.com> * Address feedback * Address feedback * Fix up TOC * TOC adjustment * Clean up image * Add upgrade content to welcome * Adjust TOC * TOC tweak --------- Co-authored-by: Andy (Steve) De George <67293991+adegeo@users.noreply.github.com>

* Initial draft of Azure AI Inference content * Tweak text * Tweak include text * Remove framework * Added logging and tracing sections. * Correct MD warning * Remove icon usage for alt-text * Trying something slightly different * Fix text * Apply suggestions from code review Co-authored-by: Andy (Steve) De George <67293991+adegeo@users.noreply.github.com> * Update docs/azureai/azureai-inference-integration.md --------- Co-authored-by: Andy (Steve) De George <67293991+adegeo@users.noreply.github.com>

* Fixes #3395, adds Azure App Configuration. * Fix include link

docs/fundamentals/dashboard/microsoft-collected-dashboard-telemetry.md

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

docs/compatibility/9.3/index.md

Co-authored-by: Alex Crome <afscrome@users.noreply.github.com>

maddymontaquila

noice

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

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

Tweaking some wording to make the doc more correct.

Aspire 9.3 What's New Feedback

* Add GHCP dashboard documentation * Update * Update what's new * Fixes --------- Co-authored-by: James Newton-King <james@newtonking.com>

We need to ship - fix in post

IEvangelist force-pushed the release-9.3 branch 2 times, most recently from 9a1c457 to 94bab3c Compare May 8, 2025 13:28

IEvangelist and others added 17 commits May 9, 2025 11:12

Update existing content to address changes mentioned in #3078.

ec61daf

Add conditional nuget.config for release branch

e903c07

Add breaking change to fix #3326

0c19b2b

Added a step to print the trigger context

f48860a

Fix default expanded state

87189af

Remove text

8b32ab4

Tweak TOC

37f28a2

Fix MD warings

1a18613

Added SKU changes, fixed #3144

a7ab240

Remove workflows and let main handle it

b04a24a

Sync with main

6e2bc1f

Sync with main

cfa46b8

Clean up (#3378)

d4c13ec

* Clean up * Fix icon

Add content for user-assigned managed ids (#3377)

0c8fe4f

* Initial draft of new user-assigned managed ids. * Edit pass and TOC reposition. * Fix issue with backticks * Minor updates

Correct URL to JSON config schema. (#3381)

954502b

Fix build warnings/errors (#3382)

e36694f

IEvangelist force-pushed the release-9.3 branch from 6f0c594 to e36694f Compare May 9, 2025 16:12

IEvangelist and others added 5 commits May 12, 2025 10:10

Remove publisher APIs (#3389)

a4f2cfa

* Fixes #3373, removal of publisher APIs. * Minor tweaks * Edit pass * Sort table * Apply suggestions from code review Co-authored-by: David Fowler <davidfowl@gmail.com> * Address feedback --------- Co-authored-by: David Fowler <davidfowl@gmail.com>

Add ACR hosting integration content. (#3383)

535bef6

* Add ACR hosting integration content. Fixes #3222 * Fix code ref * Address feedback * Add TOC preview * Adjust code bit

Fixes #3386, adds breaking changes content for Azure SQL Server admin…

66248ac

… user-assigned managed id. (#3391)

Fixes #3224. Move Dapr to community toolkit (#3393)

56e9b0a

Adds new eventing APIs. (#3392)

ec4e705

* Fixes #3372. Adds new eventing APIs. * Minor edit for constistency * Fix output * Fix build * Try to fix highlighting

IEvangelist and others added 3 commits May 14, 2025 10:41

Adds Azure App Configuration integration (#3500)

48f9f61

* Fixes #3395, adds Azure App Configuration. * Fix include link

JamesNK reviewed May 16, 2025

View reviewed changes

davidfowl added 5 commits May 17, 2025 12:10

Update dotnet-aspire-9.3.md

1633231

Update dotnet-aspire-9.3.md

a0b0fb5

Update dotnet-aspire-9.3.md

09ed788

Update dotnet-aspire-9.3.md

b5adefa

Update dotnet-aspire-9.3.md

4c3af54

JamesNK reviewed May 17, 2025

View reviewed changes

docs/whats-new/dotnet-aspire-9.3.md Outdated Show resolved Hide resolved

davidfowl and others added 7 commits May 17, 2025 17:19

Update dotnet-aspire-9.3.md

8df5abb

Update dotnet-aspire-9.3.md

326a5bf

Update dotnet-aspire-9.3.md

f0d15d3

Update dotnet-aspire-9.3.md

5efd7d1

Update dotnet-aspire-9.3.md

60fa185

Update dotnet-aspire-9.3.md

8fb6517

Add dashboard screenshots

a5d74ad

afscrome reviewed May 18, 2025

View reviewed changes

docs/compatibility/9.3/index.md Outdated Show resolved Hide resolved

IEvangelist and others added 3 commits May 18, 2025 18:50

Apply suggestions from code review

5671f02

Co-authored-by: Alex Crome <afscrome@users.noreply.github.com>

A bit of clean up

e92da02

Fix more links

3583a08

maddymontaquila previously requested changes May 19, 2025

View reviewed changes

davidfowl reviewed May 19, 2025

View reviewed changes

docs/whats-new/dotnet-aspire-9.3.md Outdated Show resolved Hide resolved

Apply suggestions from code review

8091a13

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

IEvangelist marked this pull request as ready for review May 19, 2025 14:18

eerhardt and others added 4 commits May 19, 2025 10:08

Aspire 9.3 What's New Feedback

bf3124d

Tweaking some wording to make the doc more correct.

Merge pull request #3504 from dotnet/eerhardt/whatsnewfeedback9.3

42f0529

Aspire 9.3 What's New Feedback

Fun times... (#3505)

b9224a6

* Add GHCP dashboard documentation * Update * Update what's new * Fixes --------- Co-authored-by: James Newton-King <james@newtonking.com>

alerts

b0f2c79

IEvangelist requested a review from maddymontaquila May 19, 2025 16:00

davidfowl approved these changes May 19, 2025

View reviewed changes

IEvangelist merged commit 77c03c3 into main May 19, 2025
9 checks passed

IEvangelist deleted the release-9.3 branch May 19, 2025 16:03

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

.NET Aspire release 9.3 content#3368

.NET Aspire release 9.3 content#3368
IEvangelist merged 48 commits intomainfrom
release-9.3

IEvangelist commented May 7, 2025 •

edited by github-actions bot

Loading

Uh oh!

davidfowl commented May 13, 2025 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

maddymontaquila left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

8 participants

Conversation

IEvangelist commented May 7, 2025 • edited by github-actions bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Internal previews

Uh oh!

davidfowl commented May 13, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Dump before polish

App Model

Integrations

Dashboard

Deployment

Docker Compose

Kubernetes

Azure

Azure Developer CLI (azd)

Aspire CLI

API Diff

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

maddymontaquila left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

8 participants

IEvangelist commented May 7, 2025 •

edited by github-actions bot

Loading

davidfowl commented May 13, 2025 •

edited

Loading