Skip to content

Latest commit

 

History

History
85 lines (63 loc) · 2.26 KB

README.md

File metadata and controls

85 lines (63 loc) · 2.26 KB

Cosmosdb account for mongodb

Terraform module to create a CosmosDB account with mongodb in Azure with set of databases.

Limitations

This module only support Cosmos DB API for MongoDB and capability EnableMongo can not be disabled.

Usage

Example showing deployment of a server with two databases.

module "cosmosdb" {

  source = "github.com/avinor/terraform-azurerm-cosmosdb-mongodb?ref=v3.1.1"

  name                = "cosmosdb"
  resource_group_name = "cosmosdb-rg"
  location            = "westeurope"
  capabilities        = ["DisableRateLimitingResponses"]

  databases = {
    mydb = {
      throughput  = 400
      collections = [
        { name = "col0", shard_key = "somekey_0", throughput = 1000 },
        { name = "col1", shard_key = "somekey_1" },
      ]
    }
    mydb2 = {
      max_throughput = 5000
      collections    = [{ name = "col2", shard_key = "someotherkey" }]
    }
  }
}

Diagnostics

Diagnostics settings can be sent to either storage account, event hub or Log Analytics workspace. The variable diagnostics.destination is the id of receiver, ie. storage account id, event namespace authorization rule id or log analytics resource id. Depending on what id is it will detect where to send. Unless using event namespace the eventhub_name is not required for storage account and log analytics workspace.

Setting all in logs and metrics will send all possible diagnostics to destination. If not using all type name of categories to send.

Capabilities

The variable capabilities can be used to enable following capabilities (list of strings, see the example above):

  • AllowSelfServeUpgradeToMongo36
  • DisableRateLimitingResponses
  • EnableAggregationPipeline
  • EnableCassandra
  • EnableGremlin
  • EnableTable
  • EnableServerless
  • MongoDBv3.4
  • mongoEnableDocLevelTTL

Throughput

There are two ways of configuring throughput (RU/s); manual or autoscale.

To use manual throughput, set throughput either on a database or a collection. E.g:

mydb = {
  throughput  = 400
  collections = []
}

To use autoscale throughput, set max_throughput on a database or a collection. E.g:

mydb = {
  max_throughput = 4000
  collections    = []
}

Note: throughput and max_throughput cannot be used in conjunction