NServiceBus.Gateway.RavenDB

NServiceBus.Gateway.RavenDB is the official NServiceBus Gateway persistence implementation for RavenDB.

It is part of the Particular Service Platform, which includes NServiceBus and tools to build, monitor, and debug distributed systems.

For more details, see the RavenDB Gateway Storage documentation.

Running tests locally

Running the tests requires RavenDB 5.2 and the following two environment variables:

1. CommaSeparatedRavenClusterUrls: contains the URLs, separated by commas, to connect to a RavenDB cluster to run cluster-wide transaction tests
2. RavenSingleNodeUrl: contains the URL of a single node RavenDB instance to run non-cluster-wide tests

The tests can be run with RavenDB servers hosted on a Docker container.

Spinning up the necessary infrastructure

This assumes docker and docker-compose are properly setup. It works currently on Windows with Docker Desktop but not on docker hosted in WSL2 only.

1. Acquire a RavenDB developer license.
2. Convert the multi-line license JSON to a single-line JSON and set the LICENSE variable. Alternatively, the license can be set using an .env file.
3. Inside the root directory of the repository, issue the following command: docker-compose up -d.

The single-node server can be reached at http://localhost:8080. The cluster leader can be reached at http://localhost:8081.