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

Open
wants to merge 53 commits into
base: main
Choose a base branch
from
Open

Content for .NET Aspire 9.1 #2566

wants to merge 53 commits into from

Conversation

IEvangelist
Copy link
Member

@IEvangelist IEvangelist commented Feb 11, 2025

Summary

Content for .NET Aspire 9.1 - link to What's new in .NET Aspire 9.1.


Internal previews

Toggle expand/collapse
📄 File 🔗 Preview link
docs/app-host/configuration.md App host configuration
docs/authentication/keycloak-integration.md .NET Aspire Keycloak integration (Preview)
docs/azure/integrations-overview.md Azure integrations overview
docs/azureai/azureai-openai-integration.md .NET Aspire Azure OpenAI integration (Preview)
docs/compatibility/9.0/index.md docs/compatibility/9.0/index
docs/compatibility/categories.md How code changes can affect compatibility
docs/compatibility/toc.yml docs/compatibility/toc
docs/database/azure-cosmos-db-entity-framework-integration.md .NET Aspire Cosmos DB Entity Framework Core integration
docs/database/azure-cosmos-db-integration.md .NET Aspire Azure Cosmos DB integration
docs/database/milvus-integration.md .NET Aspire Milvus database integration
docs/database/mongodb-integration.md docs/database/mongodb-integration
docs/diagnostics/overview.md .NET Aspire diagnostics overview
docs/fundamentals/app-host-overview.md .NET Aspire orchestration overview
docs/fundamentals/dashboard/configuration.md .NET Aspire dashboard configuration
docs/fundamentals/dotnet-aspire-sdk.md .NET Aspire SDK
docs/fundamentals/setup-tooling.md .NET Aspire setup and tooling
docs/get-started/upgrade-to-aspire-9.md docs/get-started/upgrade-to-aspire-9
docs/messaging/azure-event-hubs-integration.md .NET Aspire Azure Event Hubs integration
docs/messaging/azure-service-bus-integration.md .NET Aspire Azure Service Bus integration
docs/messaging/nats-integration.md .NET Aspire NATS integration
docs/messaging/rabbitmq-integration.md .NET Aspire RabbitMQ integration
docs/search/elasticsearch-integration.md docs/search/elasticsearch-integration
docs/security/azure-security-key-vault-integration.md .NET Aspire Azure Key Vault integration
docs/serverless/functions.md .NET Aspire Azure Functions integration (Preview)
docs/testing/accessing-resources.md Access resources in .NET Aspire tests
docs/testing/manage-app-host.md docs/testing/manage-app-host
docs/testing/write-your-first-test.md Write your first .NET Aspire test
docs/toc.yml docs/toc
docs/whats-new/index.yml .NET Aspire — what's new?
docs/whats-new/toc.yml docs/whats-new/toc

Note

This table shows preview links for the 30 files with the most changes. For preview links for other files in this PR, select OpenPublishing.Build Details within checks.

@dotnetrepoman dotnetrepoman bot added the messaging Content related to messaging. label Feb 11, 2025
@dotnet-policy-service dotnet-policy-service bot added okr-freshness OKR: Freshness of content okr-quality Content-health KR: Concerns article defects/freshness or build warnings. labels Feb 13, 2025
captainsafia and others added 14 commits February 19, 2025 14:33
* 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
* Document DistributedApplication.ResourceNotifications and WaitForResourceHealthyAsync

* Minor edit pass, and bump ms.date

---------

Co-authored-by: Reuben Bond <[email protected]>
* Fixes breaking changes doc issues

* Fix links

* Correct front-matter

* Add index
* Wip

* Rewrite of Azure Event Hubs, looks like 9.1 target

* Minor edit

* Fix broken links

* Correct link again
* Upgrade NuGet packages, and corrected preview headings

* Revert one incorrect change

* Bump version

* Correct Dapr version
* [9.1] Add WithExplicitStart

* Update docs/fundamentals/app-host-overview.md
* Add resource relationship docs

* Fix linter

* Update

* Update

* Update

* Update

* Apply suggestions from code review

---------

Co-authored-by: David Pine <[email protected]>
* scaffolding pt 1

* adding the scaffold from pine

* first full pass

* wow copilot is helpful

Co-authored-by: Copilot <[email protected]>

* erics edits (ty!)

Co-authored-by: Eric Erhardt <[email protected]>

* Good finds from James

Co-authored-by: James Newton-King <[email protected]>

* moving console logs downloads to its own section in dashboard

* Apply suggestions from code review

Co-authored-by: James Newton-King <[email protected]>

* Update docs/whats-new/dotnet-aspire-9.1.md

* Apply suggestions from code review

Co-authored-by: Eric Erhardt <[email protected]>

* Edit pass on the what's new content (#2636)

---------

Co-authored-by: Copilot <[email protected]>
Co-authored-by: Eric Erhardt <[email protected]>
Co-authored-by: James Newton-King <[email protected]>
Co-authored-by: David Pine <[email protected]>
Co-authored-by: David Fowler <[email protected]>
IEvangelist and others added 4 commits February 20, 2025 08:22
* Add details about client integrations with version-suffix. Fixes #2360

* Feedback
* Adds the NATS 9.1 API and fixes obsolete API. Closes #1817

* Fix link
eerhardt and others added 6 commits February 21, 2025 10:30
* Update breaking changes docs

* Update breaking changes index

* Fix copy paste errors

* Update SB to include subscription

* update TOC
* Rework PR

* Apply suggestions from code review

Co-authored-by: Eric Erhardt <[email protected]>

* Correct phrasing for local containers

* Apply suggestions from code review

Co-authored-by: Eric Erhardt <[email protected]>

* Re-generate Bicep and manifest. Also, more feedback

* Fix MD lint

---------

Co-authored-by: Eric Erhardt <[email protected]>
Co-authored-by: James Newton-King <[email protected]>
@davidfowl
Copy link
Member

@ReubenBond it seems we only added a single doc for testing. We should audit and revamp the testing doc (and add as much information as possible based on what we learnt and feedback).

sebastienros and others added 11 commits February 24, 2025 07:45
* 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 <[email protected]>
* Local Devcontainers.

* Remove Azure features from devcontainer.

* Apply suggestions from code review

* Apply suggestions from code review

---------

Co-authored-by: David Pine <[email protected]>
ReubenBond and others added 8 commits February 24, 2025 14:18
* 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 <[email protected]>
Add code snippet for using new Azure emulators
@IEvangelist IEvangelist marked this pull request as ready for review February 25, 2025 04:41
@@ -135,6 +135,25 @@ var apiservice = builder.AddProject<Projects.AspireApp_ApiService>("apiservice")

The preceding code adds three replicas of the "apiservice" project resource to the app model. For more information, see [.NET Aspire dashboard: Resource replicas](dashboard/explore.md#resource-replicas).

## Configure explicit resource start

Project, executable and container resources are automatically started with your distributed application by default. A resource can be configured to wait for an explicit startup instruction with the `WithExplicitStart()` method. A resource configured with `WithExplicitStart()` is initialized with `KnownResourceStates.NotStarted`.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: WithExplicitStart can be changed to an xref to API docs once they're available.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same with NotStarted

- <xref:Aspire.Hosting.ResourceBuilderExtensions.WaitFor*> adds a relationship to the target resource with the type `WaitFor`.
- Adding a database to a DB container creates a relationship from the database to the container with the type `Parent`.

Relationships can also be explicitly added to the app model using `WithRelationship` and `WithParentRelationship`.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: WithRelationship and WithParentRelationship can be changed to an xref to API docs once they're available.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment