Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Content for .NET Aspire 9.1 #2566

Merged
merged 63 commits into from
Feb 25, 2025
Merged
Changes from all commits
Commits
Show all changes
63 commits
Select commit Hold shift + click to select a range
823b8e1
Update docs/serverless/functions.md
captainsafia Feb 6, 2025
2eca627
Update Azure Service Bus integration doc (#2365)
IEvangelist Feb 11, 2025
1f0c8b9
Resource notifications (#2568)
IEvangelist Feb 11, 2025
239ffb9
Fixes breaking changes doc issues (#2619)
IEvangelist Feb 13, 2025
099de3b
Shell for what's new content (#2620)
IEvangelist Feb 13, 2025
42588f9
Fixes #1659 (#2621)
IEvangelist Feb 14, 2025
714e36b
Rewritten Azure Event Hubs integration content (#2562)
IEvangelist Feb 14, 2025
8a1e2dc
Upgrade bits to 9.1 (#2627)
IEvangelist Feb 14, 2025
78c6213
[9.1] Force waiting resource to start (#2629)
JamesNK Feb 18, 2025
e494772
[9.1] Add WithExplicitStart (#2630)
JamesNK Feb 18, 2025
4526acd
Add DOTNET_DASHBOARD_CORS_ALLOWED_ORIGINS to app host configuration (…
JamesNK Feb 18, 2025
7025f43
Fix invalid file link warning (#2635)
IEvangelist Feb 18, 2025
8d2a907
[9.1] Add resource relationship docs (#2637)
JamesNK Feb 19, 2025
ca2baf7
Wat's new (#2622)
maddymontaquila Feb 19, 2025
b440c0f
Version-suffixed NuGet client integrations (#2643)
IEvangelist Feb 20, 2025
729d1f6
[9.1] Add remove logs and telemetry to what's new (#2645)
JamesNK Feb 20, 2025
aafa5b2
Adds the NATS 9.1 API and fixes obsolete API. (#2650)
IEvangelist Feb 20, 2025
18a633c
A bit of clean up
IEvangelist Feb 20, 2025
c31d324
Update breaking changes docs (#2651)
eerhardt Feb 21, 2025
ef77628
Existing Azure resources (#2653)
IEvangelist Feb 21, 2025
5699f36
Add docs for CosmosDB preview emulator (#2654)
eerhardt Feb 21, 2025
4389b22
Apply suggestions from code review
IEvangelist Feb 21, 2025
b8dd676
Fixed misc feedback
IEvangelist Feb 21, 2025
e059b8d
Merge branch 'main' into dotnet-aspire-9.1
IEvangelist Feb 21, 2025
868ab7b
Fix heading link
IEvangelist Feb 21, 2025
3334853
.NET Aspire and GitHub Codespaces/Devcontainers (#2638)
mitchdenny Feb 21, 2025
c5df5b0
Codespaces and dev containers (#2655)
IEvangelist Feb 22, 2025
73cc5e1
Update CosmosDB, EventHubs, and ServiceBus for latest APIs. (#2656)
eerhardt Feb 22, 2025
ad1f55a
Update devcontainer.
mitchdenny Feb 24, 2025
5da14ed
Bicep too.
mitchdenny Feb 24, 2025
ec1803f
Merge pull request #2664 from dotnet/remove-azure-features-from-devco…
mitchdenny Feb 24, 2025
215bf7f
Add CosmosDB container creation (#2661)
sebastienros Feb 24, 2025
49f5deb
Enhance Integrations What's New in 9.1 (#2657)
eerhardt Feb 24, 2025
a1443b9
Local-devcontainers (#2662)
mitchdenny Feb 24, 2025
4c982b6
Edit pass and clean up
IEvangelist Feb 24, 2025
e4284e1
Clean up images
IEvangelist Feb 24, 2025
c9dff1d
Add link from setup to codespaces and dev containers
IEvangelist Feb 24, 2025
7ba8543
Another edit pass
IEvangelist Feb 24, 2025
2ac133a
Remove misleading links
IEvangelist Feb 24, 2025
9fd1037
Remove details/summary HTML - usability concerns
IEvangelist Feb 24, 2025
06d196f
Fix triple : code bits
IEvangelist Feb 24, 2025
30b7b1c
Move Upgrade to 9.1 to the top (#2668)
eerhardt Feb 24, 2025
23ad1b9
Add testing overview doc (#2667)
ReubenBond Feb 24, 2025
c72b5ea
Edit pass on testing docs
IEvangelist Feb 24, 2025
5c60d51
Clean builds, except xref
IEvangelist Feb 24, 2025
cdf3d40
Add code snippet for using new Azure emulators
eerhardt Feb 24, 2025
ffca71f
fixup
eerhardt Feb 24, 2025
b45cdc5
Merge pull request #2669 from dotnet/EmulatorCode
eerhardt Feb 24, 2025
f819db2
Tweak the wording of CosmosDB databases and containers (#2670)
eerhardt Feb 25, 2025
4f73fe4
Another edit pass
IEvangelist Feb 25, 2025
eb5ad3a
Fix typo
IEvangelist Feb 25, 2025
2c47d3f
Adjust h2s
IEvangelist Feb 25, 2025
e9b7102
Fix bookmark
IEvangelist Feb 25, 2025
c5e5436
Clean up, additions, and removal of mistakenly dup'd content
IEvangelist Feb 25, 2025
f1b5914
More rewording and messaging updates
IEvangelist Feb 25, 2025
41c0d25
More rewording and messaging updates
IEvangelist Feb 25, 2025
aa8883f
Additional details
IEvangelist Feb 25, 2025
41ff3ad
Headings
IEvangelist Feb 25, 2025
546622d
Add more links, clarify text, and use ref branch
IEvangelist Feb 25, 2025
8017cd5
Add breaking changes link
IEvangelist Feb 25, 2025
a63d996
A few xref bits for fun
IEvangelist Feb 25, 2025
971aa4e
Point to .NET Aspire 9.1 API docs
IEvangelist Feb 25, 2025
bbed52e
Remove a few things
IEvangelist Feb 25, 2025
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions .openpublishing.publish.config.json
Original file line number Diff line number Diff line change
@@ -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",
19 changes: 0 additions & 19 deletions .vscode/shared.code-snippets
Original file line number Diff line number Diff line change
@@ -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",
1 change: 1 addition & 0 deletions docs/app-host/configuration.md
Original file line number Diff line number Diff line change
@@ -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
Original file line number Diff line number Diff line change
@@ -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>
Original file line number Diff line number Diff line change
@@ -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>
Original file line number Diff line number Diff line change
@@ -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" />
Original file line number Diff line number Diff line change
@@ -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>
10 changes: 0 additions & 10 deletions docs/authentication/keycloak-integration.md
Original file line number Diff line number Diff line change
@@ -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.
Original file line number Diff line number Diff line change
@@ -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>
Original file line number Diff line number Diff line change
@@ -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" />
Loading