Database - Azure CosmosDB

Following are steps for Azure Cosmos DB deployment for integration with DecisionRules.

After navigating to Azure Cosmos DB, hit Create. Choose Azure Cosmos DB for MongoDB.

From version 1.21.0, we recommend using the vCore-based type instead of RU-based type for new environments, following Microsoft’s own recommendation.

Cosmos DB for MongoDB

vCore-based

If you use vCore-based Cosmos DB you need to specify the DB_TYPE environmental variable in your server container with value COSMOSDB_VCORE. More information here: Environment Variables

RU-based

Assign your resource group, give the account a name, choose a location and choose the Serverless capacity mode.

Serverless Capacity mode has much lower operating costs compared to the Provisioned Throughput option. If for whatever reason you decide to go with the Provisioned Throughput option anyways, make sure to set the limit to a minimum of 12000 RUs.

Basic settings

Set your Global Distributions settings, i kept mine default. Next go to the Networking tab and fill in the settings.

It is recommended to use a Private Endpoint connection but for hassle free non-Prod environment deployments a Public Endpoint is also an option.

Create your private endpoint, making sure it shares the same virtual network as your future server container.

Networking settings and Private Endpoint

For the Backup Policy, Encryption and Tags choose whatever fits your use-case. Review the account and create.

Where to find a connection string

After the database account has been created, navigate to Settings / Connection strings. The connection string can be found under Primary/Secondary connection string.

If you use RU-based Cosmos DB you need to specify the DB_TYPE environmental variable in your server container with value COSMOSDB. More information here: Environment Variables