1.1.0

As part of this release we had 163 commits which resulted in 5 issues being closed.

Features

• #69 Add support for configuring partition key extraction rules
• #24 Add support for pessimistic lease lock when handling sagas

Improvements

• #292 Cache partition key path and segments to reduce allocations
• #291 Cache saga and outbox metadata to reduce allocations
• #262 Add support for Microsoft.Azure.Cosmos 3.23.0

Where to get it

You can download this release from NuGet.

🛡 ClamAV virus scan results: No viruses detected

Version: ClamAV 0.103.5/26427/Wed Jan 19 10:42:43 2022
Scan Date: Thu, 20 Jan 2022 07:40:11 GMT

----------- SCAN SUMMARY -----------
Known viruses: 8604086
Engine version: 0.103.5
Scanned directories: 1
Scanned files: 3
Infected files: 0
Data scanned: 1.44 MB
Data read: 0.30 MB (ratio 4.86:1)
Time: 22.932 sec (0 m 22 s)
Start Date: 2022:01:20 07:39:31
End Date:   2022:01:20 07:39:54

1.0.0

As part of this release we had 81 commits which resulted in 1 issue being closed.

Improvement

• #199 Throw if endpoint configured for message-driven pub/sub

Where to get it

You can download this release from NuGet.

🛡 ClamAV virus scan results: No viruses detected

Version: ClamAV 0.103.2/26258/Mon Aug  9 08:18:46 2021
Scan Date: Mon, 09 Aug 2021 20:03:35 GMT

----------- SCAN SUMMARY -----------
Known viruses: 8559099
Engine version: 0.103.2
Scanned directories: 1
Scanned files: 4
Infected files: 0
Data scanned: 21.33 MB
Data read: 5.18 MB (ratio 4.12:1)
Time: 38.423 sec (0 m 38 s)
Start Date: 2021:08:09 20:02:57
End Date:   2021:08:09 20:03:35

0.2.1

As part of this release we had 7 commits which resulted in 1 issue being closed.

Bug

• #127 Outbox cleaning using Time-To-Live does not work

Where to get it

You can download this release from nuget.

0.2.0

As part of this release we had 76 commits which resulted in 1 issue being closed.

Improvement

• #123 Updated Microsoft.Azure.Cosmos package

Where to get it

You can download this release from nuget.

0.1.2

As part of this release we had 45 commits which resulted in 1 issue being closed.

Feature

• #98 Add support for Azure Table Persistence v3 in the exporter tool

Where to get it

You can download this release from nuget.

0.1.1

As part of this release 1 issue was closed.

Bug

• #86 Exception thrown for handlers that do not use synchronized storage

Where to get it

You can download this release from nuget.

0.1.0

We've just released a public preview version of NServiceBus.Persistence.CosmosDB with support for sagas and outbox, as well as a migration path from Azure Storage persistence.

Azure Cosmos DB is a great choice to persist your saga data and custom data when running in Azure with NServiceBus. As a fully managed, globally distributed, elastically scaled, pay-as-you-go service, your NServiceBus-based systems can benefit from guaranteed single-digit-millisecond latency with 99.999% availability.

The NServiceBus.Persistence.CosmosDB persistence comes with the following benefits:

• Support for the outbox with transactional guarantees for messaging and business data
• Run with SQL persistence guarantees at Cosmos DB cost
• Faster than Azure Storage persistence while transactional
• Fully partitioning aware, unlocking advanced data storage scenarios such a multi-tenancy
• Supported migration from Azure Storage persistence

Getting Started

To use NServiceBus.Persistence.CosmosDB, install the NuGet package:

nuget install-package NServiceBus.Persistence.CosmosDB

Configure NServiceBus endpoint to use Cosmos DB:

endpointConfiguration.UsePersistence<CosmosDBPersistence>()
   .CosmosClient(new CosmosClient("your-connection-string"))
   .DatabaseName("your-database-name")
   .DefaultContainer("container-name", "/partition/key/path");

Now you are ready to use sagas with Azure Cosmos DB.

For detailed configuration options see the documentation.

About the public preview

The NServiceBus.Persistence.CosmosDB package is released as a public preview. Public previews are separately licensed, production-ready packages, aiming to react more quickly to customers' needs. See the support policy for previews for more information about our support commitment. Preview packages may transition to fully supported versions after the preview period.

User adoption is crucial and helps us decide whether to make NServiceBus.Persistence.CosmosDB a permanent part of the Particular Platform. Please let us know if you are using this preview by emailing us at previews@particular.net.

We'd also love to receive your feedback about the new NServiceBus.Persistence.CosmosDB package via our support channels, the project repository, or our public previews discussion group.

Where to get it

You can install the preview from NuGet.

With thanks,
The team in Particular

Please read our release policy for more details. Follow @ParticularNews to be notified of new releases and bug fixes.