Skip to content

Commit b440c0f

Browse files
authored
Version-suffixed NuGet client integrations (#2643)
* Add details about client integrations with version-suffix. Fixes #2360 * Feedback
1 parent ca2baf7 commit b440c0f

File tree

2 files changed

+8
-2
lines changed

2 files changed

+8
-2
lines changed

docs/database/mongodb-integration.md

+4-1
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: .NET Aspire MongoDB database integration
33
description: Learn how to use the .NET Aspire MongoDB database integration, which includes both hosting and client integrations.
4-
ms.date: 12/03/2024
4+
ms.date: 02/19/2025
55
uid: database/mongodb-integration
66
---
77

@@ -221,6 +221,9 @@ dotnet add package Aspire.MongoDB.Driver
221221

222222
---
223223

224+
> [!IMPORTANT]
225+
> The `Aspire.MongoDB.Driver` NuGet package depends on the `MongoDB.Driver` NuGet package. With the release of version 3.0.0 of `MongoDB.Driver`, a binary breaking change was introduced. To address this, a new client integration package, `Aspire.MongoDB.Driver.v3`, was created. The original `Aspire.MongoDB.Driver` package continues to reference `MongoDB.Driver` version 2.30.0, ensuring compatibility with previous versions of the RabbitMQ client integration. The new `Aspire.MongoDB.Driver.v3` package references `MongoDB.Driver` version 3.0.0. In a future version of .NET Aspire, the `Aspire.MongoDB.Driver` will be updated to version `3.x` and the `Aspire.MongoDB.Driver.v3` package will be deprecated. For more information, see [Upgrade to version 3.0](https://www.mongodb.com/docs/drivers/csharp/v3.0/upgrade/v3/).
226+
224227
### Add MongoDB client
225228

226229
In the _:::no-loc text="Program.cs":::_ file of your client-consuming project, call the <xref:Microsoft.Extensions.Hosting.AspireMongoDBDriverExtensions.AddMongoDBClient*> extension method on any <xref:Microsoft.Extensions.Hosting.IHostApplicationBuilder> to register a `IMongoClient` for use via the dependency injection container. The method takes a connection name parameter.

docs/messaging/rabbitmq-integration.md

+4-1
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: .NET Aspire RabbitMQ integration
33
description: Learn how to use the .NET Aspire RabbitMQ message-broker integration, which includes both hosting and client integrations.
4-
ms.date: 10/11/2024
4+
ms.date: 02/19/2025
55
uid: messaging/rabbitmq-integration
66
---
77

@@ -165,6 +165,9 @@ dotnet add package Aspire.RabbitMQ.Client
165165

166166
---
167167

168+
> [!IMPORTANT]
169+
> The `Aspire.RabbitMQ.Client` NuGet package depends on the `RabbitMQ.Client` NuGet package. With the release of version 7.0.0 of `RabbitMQ.Client`, a binary breaking change was introduced. To address this, a new client integration package, `Aspire.RabbitMQ.Client.v7`, was created. The original `Aspire.RabbitMQ.Client` package continues to reference `RabbitMQ.Client` version 6.8.1, ensuring compatibility with previous versions of the RabbitMQ client integration. The new `Aspire.RabbitMQ.Client.v7` package references `RabbitMQ.Client` version 7.0.0. In a future version of .NET Aspire, the `Aspire.RabbitMQ.Client` will be updated to version `7.x` and the `Aspire.RabbitMQ.Client.v7` package will be deprecated. For more information, see [Migrating to RabbitMQ .NET Client 7.x](https://github.com/rabbitmq/rabbitmq-dotnet-client/blob/main/v7-MIGRATION.md).
170+
168171
### Add RabbitMQ client
169172

170173
In the _:::no-loc text="Program.cs":::_ file of your client-consuming project, call the <xref:Microsoft.Extensions.Hosting.AspireRabbitMQExtensions.AddRabbitMQClient%2A> extension method on any <xref:Microsoft.Extensions.Hosting.IHostApplicationBuilder> to register an `IConnection` for use via the dependency injection container. The method takes a connection name parameter.

0 commit comments

Comments
 (0)