Content for .NET Aspire 9.1 (#2566)

* Update docs/serverless/functions.md * Update Azure Service Bus integration doc (#2365) * Fixes #2308 * Fix tabs * Fix a few more bits * Remove subscription section and correct topics * Fix port info * Apply suggestions from code review * Apply suggestions from code review * Apply suggestions from code review * Resource notifications (#2568) * Document DistributedApplication.ResourceNotifications and WaitForResourceHealthyAsync * Minor edit pass, and bump ms.date --------- Co-authored-by: Reuben Bond <reuben.bond@gmail.com> * Fixes breaking changes doc issues (#2619) * Fixes breaking changes doc issues * Fix links * Correct front-matter * Add index * Shell for what's new content (#2620) * Fixes #1659 (#2621) * Rewritten Azure Event Hubs integration content (#2562) * Wip * Rewrite of Azure Event Hubs, looks like 9.1 target * Minor edit * Fix broken links * Correct link again * Upgrade bits to 9.1 (#2627) * Upgrade NuGet packages, and corrected preview headings * Revert one incorrect change * Bump version * Correct Dapr version * [9.1] Force waiting resource to start (#2629) * [9.1] Add WithExplicitStart (#2630) * [9.1] Add WithExplicitStart * Update docs/fundamentals/app-host-overview.md * Add DOTNET_DASHBOARD_CORS_ALLOWED_ORIGINS to app host configuration (#2631) * Fix invalid file link warning (#2635) * [9.1] Add resource relationship docs (#2637) * Add resource relationship docs * Fix linter * Update * Update * Update * Update * Apply suggestions from code review --------- Co-authored-by: David Pine <david.pine@microsoft.com> * Wat's new (#2622) * scaffolding pt 1 * adding the scaffold from pine * first full pass * wow copilot is helpful Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * erics edits (ty!) Co-authored-by: Eric Erhardt <eric.erhardt@microsoft.com> * Good finds from James Co-authored-by: James Newton-King <james@newtonking.com> * moving console logs downloads to its own section in dashboard * Apply suggestions from code review Co-authored-by: James Newton-King <james@newtonking.com> * Update docs/whats-new/dotnet-aspire-9.1.md * Apply suggestions from code review Co-authored-by: Eric Erhardt <eric.erhardt@microsoft.com> * Edit pass on the what's new content (#2636) --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Co-authored-by: Eric Erhardt <eric.erhardt@microsoft.com> Co-authored-by: James Newton-King <james@newtonking.com> Co-authored-by: David Pine <david.pine@microsoft.com> Co-authored-by: David Fowler <davidfowl@gmail.com> * Version-suffixed NuGet client integrations (#2643) * Add details about client integrations with version-suffix. Fixes #2360 * Feedback * [9.1] Add remove logs and telemetry to what's new (#2645) * Adds the NATS 9.1 API and fixes obsolete API. (#2650) * Adds the NATS 9.1 API and fixes obsolete API. Closes #1817 * Fix link * A bit of clean up * Update breaking changes docs (#2651) * Update breaking changes docs * Update breaking changes index * Fix copy paste errors * Update SB to include subscription * update TOC * Existing Azure resources (#2653) * Rework PR * Apply suggestions from code review Co-authored-by: Eric Erhardt <eric.erhardt@microsoft.com> * Correct phrasing for local containers * Apply suggestions from code review Co-authored-by: Eric Erhardt <eric.erhardt@microsoft.com> * Re-generate Bicep and manifest. Also, more feedback * Fix MD lint --------- Co-authored-by: Eric Erhardt <eric.erhardt@microsoft.com> * Add docs for CosmosDB preview emulator (#2654) Fix #2376 * Apply suggestions from code review Co-authored-by: James Newton-King <james@newtonking.com> * Fixed misc feedback * Fix heading link * .NET Aspire and GitHub Codespaces/Devcontainers (#2638) * Update docs/serverless/functions.md * Update Azure Service Bus integration doc (#2365) * Fixes #2308 * Fix tabs * Fix a few more bits * Remove subscription section and correct topics * Fix port info * Apply suggestions from code review * Apply suggestions from code review * Apply suggestions from code review * Resource notifications (#2568) * Document DistributedApplication.ResourceNotifications and WaitForResourceHealthyAsync * Minor edit pass, and bump ms.date --------- Co-authored-by: Reuben Bond <reuben.bond@gmail.com> * Fixes breaking changes doc issues (#2619) * Fixes breaking changes doc issues * Fix links * Correct front-matter * Add index * Shell for what's new content (#2620) * Fixes #1659 (#2621) * Rewritten Azure Event Hubs integration content (#2562) * Wip * Rewrite of Azure Event Hubs, looks like 9.1 target * Minor edit * Fix broken links * Correct link again * Upgrade bits to 9.1 (#2627) * Upgrade NuGet packages, and corrected preview headings * Revert one incorrect change * Bump version * Correct Dapr version * [9.1] Force waiting resource to start (#2629) * [9.1] Add WithExplicitStart (#2630) * [9.1] Add WithExplicitStart * Update docs/fundamentals/app-host-overview.md * Add DOTNET_DASHBOARD_CORS_ALLOWED_ORIGINS to app host configuration (#2631) * Fix invalid file link warning (#2635) * Codespaces docs. * Remove pivot. * Pivot removal. * Update docs/fundamentals/codespaces.md Co-authored-by: David Pine <david.pine@microsoft.com> * Update docs/fundamentals/codespaces.md Co-authored-by: David Pine <david.pine@microsoft.com> * Update docs/fundamentals/codespaces.md Co-authored-by: David Pine <david.pine@microsoft.com> * Update docs/fundamentals/codespaces.md Co-authored-by: David Pine <david.pine@microsoft.com> * Update docs/fundamentals/codespaces.md Co-authored-by: David Pine <david.pine@microsoft.com> * Update docs/fundamentals/codespaces.md Co-authored-by: David Pine <david.pine@microsoft.com> * Update docs/fundamentals/codespaces.md Co-authored-by: David Pine <david.pine@microsoft.com> * Update docs/fundamentals/devcontainers.md Co-authored-by: David Pine <david.pine@microsoft.com> * Update docs/fundamentals/devcontainers.md Co-authored-by: David Pine <david.pine@microsoft.com> * Update docs/fundamentals/devcontainers.md Co-authored-by: David Pine <david.pine@microsoft.com> --------- Co-authored-by: Safia Abdalla <safia@safia.rocks> Co-authored-by: David Pine <david.pine@microsoft.com> Co-authored-by: Reuben Bond <reuben.bond@gmail.com> Co-authored-by: James Newton-King <james@newtonking.com> * Codespaces and dev containers (#2655) * Initial clean up * Edit pass * Use hardcoded JSON for now * Fix image, move it * Add links from what's new * Update CosmosDB, EventHubs, and ServiceBus for latest APIs. (#2656) * Update devcontainer. * Bicep too. * Add CosmosDB container creation (#2661) * Enhance Integrations What's New in 9.1 (#2657) * Enhance Integrations What's New in 9.1 * md lint * add disable experimental * Add ComsosDB func trigger * Apply suggestions from code review * Apply suggestions from code review --------- Co-authored-by: David Pine <david.pine@microsoft.com> * Local-devcontainers (#2662) * Local Devcontainers. * Remove Azure features from devcontainer. * Apply suggestions from code review * Apply suggestions from code review --------- Co-authored-by: David Pine <david.pine@microsoft.com> * Edit pass and clean up * Clean up images * Add link from setup to codespaces and dev containers * Another edit pass * Remove misleading links * Remove details/summary HTML - usability concerns * Fix triple : code bits * Move Upgrade to 9.1 to the top (#2668) * Add testing overview doc (#2667) * Add testing overview doc to explain how Aspire testing works, update tutorial, add detail on passing args to the app host * Update dates * Apply suggestions from code review --------- Co-authored-by: David Pine <david.pine@microsoft.com> * Edit pass on testing docs * Clean builds, except xref * Add code snippet for using new Azure emulators * fixup * Tweak the wording of CosmosDB databases and containers (#2670) * Another edit pass * Fix typo * Adjust h2s * Fix bookmark * Clean up, additions, and removal of mistakenly dup'd content * More rewording and messaging updates * More rewording and messaging updates * Additional details * Headings * Add more links, clarify text, and use ref branch * Add breaking changes link * A few xref bits for fun * Point to .NET Aspire 9.1 API docs * Remove a few things --------- Co-authored-by: Safia Abdalla <safia@safia.rocks> Co-authored-by: Reuben Bond <reuben.bond@gmail.com> Co-authored-by: James Newton-King <james@newtonking.com> Co-authored-by: Maddy Montaquila (Leger) <maddyleger1@gmail.com> Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Co-authored-by: Eric Erhardt <eric.erhardt@microsoft.com> Co-authored-by: David Fowler <davidfowl@gmail.com> Co-authored-by: Mitch Denny <midenn@microsoft.com> Co-authored-by: Sébastien Ros <sebastienros@gmail.com> Co-authored-by: Reuben Bond <203839+ReubenBond@users.noreply.github.com>
dotnet · Feb 25, 2025 · cab7881 · cab7881
1 parent aa641d5
commit cab7881
Show file tree

Hide file tree

Showing 157 changed files with 2,725 additions and 862 deletions.
diff --git a/.openpublishing.publish.config.json b/.openpublishing.publish.config.json
@@ -46,6 +46,12 @@
       "branch": "main",
       "branch_mapping": {}
     },
+    {
+      "path_to_root": "aspire-devcontainer",
+      "url": "/~https://github.com/dotnet/aspire-devcontainer",
+      "branch": "main",
+      "branch_mapping": {}
+    },
     {
       "path_to_root": "aspire-docs-samples-solution",
       "url": "/~https://github.com/MicrosoftDocs/aspire-docs-samples",

diff --git a/.vscode/shared.code-snippets b/.vscode/shared.code-snippets
@@ -1,23 +1,4 @@
 {
-	"Details and summary HTML": {
-		"scope": "markdown",
-		"prefix": "details",
-		"body": [
-			"<!-- markdownlint-disable MD033 -->",
-			"<br/>",
-			"<details>",
-			"<summary id=\"$1\"><strong>Toggle $2.</strong></summary>",
-			"<p aria-labelledby=\"$1\">",
-			"",
-			"$3",
-			"",
-			"</p>",
-			"</details>",
-			"<!-- markdownlint-enable MD033 -->",
-			"$0"
-		],
-		"description": "Details and summary HTML"
-	},
 	"Inline NuGet package reference": {
 		"scope": "markdown",
 		"prefix": "inline nuget",

diff --git a/docs/app-host/configuration.md b/docs/app-host/configuration.md
@@ -75,6 +75,7 @@ By default, the dashboard is automatically started by the app host. The dashboar
 | `ASPNETCORE_ENVIRONMENT` | `Production` | Configures the environment the dashboard runs as. For more information, see [Use multiple environments in ASP.NET Core](/aspnet/core/fundamentals/environments). |
 | `DOTNET_DASHBOARD_OTLP_ENDPOINT_URL` | `http://localhost:18889` if no gRPC endpoint is configured. | Configures the dashboard OTLP gRPC address. Used by the dashboard to receive telemetry over OTLP. Set on resources as the `OTEL_EXPORTER_OTLP_ENDPOINT` env var. The `OTEL_EXPORTER_OTLP_PROTOCOL` env var is `grpc`.  Automatically generated with _launchSettings.json_ to have a random port on localhost. |
 | `DOTNET_DASHBOARD_OTLP_HTTP_ENDPOINT_URL` | `null` | Configures the dashboard OTLP HTTP address. Used by the dashboard to receive telemetry over OTLP. If only `DOTNET_DASHBOARD_OTLP_HTTP_ENDPOINT_URL` is configured then it is set on resources as the `OTEL_EXPORTER_OTLP_ENDPOINT` env var. The `OTEL_EXPORTER_OTLP_PROTOCOL` env var is `http/protobuf`. |
+| `DOTNET_DASHBOARD_CORS_ALLOWED_ORIGINS` | `null` | Overrides the CORS allowed origins configured in the dashboard. This setting replaces the default behavior of calculating allowed origins based on resource endpoints. |
 | `DOTNET_DASHBOARD_FRONTEND_BROWSERTOKEN` | Automatically generated 128-bit entropy token. | Configures the frontend browser token. This is the value that must be entered to access the dashboard when the auth mode is BrowserToken. If no browser token is specified then a new token is generated each time the app host is launched. |
 
 ## Internal

diff --git a/docs/app-host/snippets/AspireApp/AspireApp.AppHost/AspireApp.AppHost.csproj b/docs/app-host/snippets/AspireApp/AspireApp.AppHost/AspireApp.AppHost.csproj
@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
-  <Sdk Name="Aspire.AppHost.Sdk" Version="9.0.0" />
+  <Sdk Name="Aspire.AppHost.Sdk" Version="9.1.0" />
 
   <PropertyGroup>
     <OutputType>Exe</OutputType>
@@ -17,8 +17,8 @@
   </ItemGroup>
 
   <ItemGroup>
-    <PackageReference Include="Aspire.Hosting.AppHost" Version="9.0.0" />
-    <PackageReference Include="Aspire.Hosting.Redis" Version="9.0.0" />
+    <PackageReference Include="Aspire.Hosting.AppHost" Version="9.1.0" />
+    <PackageReference Include="Aspire.Hosting.Redis" Version="9.1.0" />
   </ItemGroup>
 
 </Project>
diff --git a/docs/app-host/snippets/AspireApp/AspireApp.ResourceAppHost/AspireApp.ResourceAppHost.csproj b/docs/app-host/snippets/AspireApp/AspireApp.ResourceAppHost/AspireApp.ResourceAppHost.csproj
@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
-  <Sdk Name="Aspire.AppHost.Sdk" Version="9.0.0" />
+  <Sdk Name="Aspire.AppHost.Sdk" Version="9.1.0" />
 
   <PropertyGroup>
     <OutputType>Exe</OutputType>
@@ -17,8 +17,8 @@
   </ItemGroup>
 
   <ItemGroup>
-    <PackageReference Include="Aspire.Hosting.AppHost" Version="9.0.0" />
-    <PackageReference Include="Aspire.Hosting.Redis" Version="9.0.0" />
+    <PackageReference Include="Aspire.Hosting.AppHost" Version="9.1.0" />
+    <PackageReference Include="Aspire.Hosting.Redis" Version="9.1.0" />
   </ItemGroup>
 
 </Project>
diff --git a/docs/app-host/snippets/AspireApp/AspireApp.ServiceDefaults/AspireApp.ServiceDefaults.csproj b/docs/app-host/snippets/AspireApp/AspireApp.ServiceDefaults/AspireApp.ServiceDefaults.csproj
@@ -11,7 +11,7 @@
     <FrameworkReference Include="Microsoft.AspNetCore.App" />
 
     <PackageReference Include="Microsoft.Extensions.Http.Resilience" Version="9.2.0" />
-    <PackageReference Include="Microsoft.Extensions.ServiceDiscovery" Version="9.0.0" />
+    <PackageReference Include="Microsoft.Extensions.ServiceDiscovery" Version="9.1.0" />
     <PackageReference Include="OpenTelemetry.Exporter.OpenTelemetryProtocol" Version="1.11.1" />
     <PackageReference Include="OpenTelemetry.Extensions.Hosting" Version="1.11.1" />
     <PackageReference Include="OpenTelemetry.Instrumentation.AspNetCore" Version="1.11.0" />

diff --git a/docs/app-host/snippets/AspireApp/AspireApp.Web/AspireApp.Web.csproj b/docs/app-host/snippets/AspireApp/AspireApp.Web/AspireApp.Web.csproj
@@ -11,7 +11,7 @@
   </ItemGroup>
 
   <ItemGroup>
-    <PackageReference Include="Aspire.StackExchange.Redis.OutputCaching" Version="9.0.0" />
+    <PackageReference Include="Aspire.StackExchange.Redis.OutputCaching" Version="9.1.0" />
   </ItemGroup>
 
 </Project>
diff --git a/docs/authentication/keycloak-integration.md b/docs/authentication/keycloak-integration.md
@@ -165,18 +165,8 @@ The realm import files are mounted at `/opt/keycloak/data/import` in the Keycloa
 
 As an example, the following JSON file could be added to the app host project in a _/Realms_ folder—to serve as a source realm configuration file:
 
-<!-- markdownlint-disable MD033 -->
-<br/>
-<details>
-<summary id='realm-json'><strong>Toggle realm JSON example.</strong></summary>
-<p aria-labelledby='realm-json'>
-
 :::code language="json" source="snippets/AspireApp/AspireApp.AppHost/Realms/weathershop-realm.json":::
 
-</p>
-</details>
-<!-- markdownlint-enable MD033 -->
-
 ### Hosting integration health checks
 
 The Keycloak hosting integration doesn't currently support a health checks, nor does it automatically add them.

diff --git a/docs/authentication/snippets/AspireApp/AspireApp.AppHost/AspireApp.AppHost.csproj b/docs/authentication/snippets/AspireApp/AspireApp.AppHost/AspireApp.AppHost.csproj
@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
-  <Sdk Name="Aspire.AppHost.Sdk" Version="9.0.0" />
+  <Sdk Name="Aspire.AppHost.Sdk" Version="9.1.0" />
 
   <PropertyGroup>
     <OutputType>Exe</OutputType>
@@ -17,8 +17,8 @@
   </ItemGroup>
 
   <ItemGroup>
-    <PackageReference Include="Aspire.Hosting.AppHost" Version="9.0.0" />
-    <PackageReference Include="Aspire.Hosting.Keycloak" Version="9.0.0-preview.5.24551.3" />
+    <PackageReference Include="Aspire.Hosting.AppHost" Version="9.1.0" />
+    <PackageReference Include="Aspire.Hosting.Keycloak" Version="9.1.0-preview.1.24113.4 />
   </ItemGroup>
 
 </Project>
diff --git a/...hentication/snippets/AspireApp/AspireApp.ServiceDefaults/AspireApp.ServiceDefaults.csproj b/...hentication/snippets/AspireApp/AspireApp.ServiceDefaults/AspireApp.ServiceDefaults.csproj
@@ -11,7 +11,7 @@
     <FrameworkReference Include="Microsoft.AspNetCore.App" />
 
     <PackageReference Include="Microsoft.Extensions.Http.Resilience" Version="9.2.0" />
-    <PackageReference Include="Microsoft.Extensions.ServiceDiscovery" Version="9.0.0" />
+    <PackageReference Include="Microsoft.Extensions.ServiceDiscovery" Version="9.1.0" />
     <PackageReference Include="OpenTelemetry.Exporter.OpenTelemetryProtocol" Version="1.11.1" />
     <PackageReference Include="OpenTelemetry.Extensions.Hosting" Version="1.11.1" />
     <PackageReference Include="OpenTelemetry.Instrumentation.AspNetCore" Version="1.11.0" />