terraform_azcli_provider

• terraform_azcli_provider
  • Synopsis
  • Dev Stuff
    • Required Go Modules
    • Useful Go Commands
  • User Stuff
    • Authenticating to Azure
      • Provider Example Usage
    • Resources
      • azcli_cosmos_database
        • Database Example Usage
      • azcli_cosmos_collection
        • Collection Example Usage
    • Full Example

Synopsis

Before using this provider, consider using the native azurerm provider first

This provider implements a lightweight wrapper around Microsoft's AZ CLI. Its primary purpose is to fill in gaps where native terraform module lacks support. For example, creating CosmosDB collections.

One benefit this provider implements is auto import, this means if your resources already exist the provider will simply generate the state as needed without a requirement for destroying\recreating or indeed importing.

Dev Stuff

Required Go Modules

In order to build this provider you will require these modules

go get -u github.com/tidwall/gjson
go get -u github.com/hashicorp/terraform/helper/schema

Useful Go Commands

go env

User Stuff

Authenticating to Azure

This provider expects the AZ cli to be logged in before use, the only parameter supported is subscription name

Provider Example Usage

provider "azcli" {
  subscription_name = "my-azure-subscription"
  version = "~> 0.0.4"
}

Resources

azcli_cosmos_database

Manages Cosmos account databases.

Note: Official Terraform azurerm provider now supports creating databases.

Database Example Usage

---

locals {
  resource_group_name = "abxrg0008-test"
  cosmos_account_name = "abxtf"

}

# WARNING - throughput doesn't change as az cli doesn't support updating a database
resource "azcli_cosmos_database" "with_throughput" {
  cosmos_account_name = "${local.cosmos_account_name}"
  resource_group_name = "${local.resource_group_name}"
  name                = "testdatabase"
  throughput = "400"
}

resource "azcli_cosmos_database" "default" {
  cosmos_account_name = "${local.cosmos_account_name}"
  resource_group_name = "${local.resource_group_name}"
  name                = "testdatabase"
}

azcli_cosmos_collection

Manages Cosmos database collections.

This can create/manage a collection with scaling set at the collection, or if the db has scaling enabled it can create/manage collections with throughput controlled at the DB.

Please note if you create a collection using db throughput, you cannot change it to dedicated throughput later. Also you cannot move a collection with dedicated througphput to db based throughput.

Collection Example Usage

---

locals {
  resource_group_name = "abxrg0008-test"
  cosmos_account_name = "abxtf"

}

# the official azurerm provider now supports creating database, you may chose to use that instead but including here for reference
resource "azcli_cosmos_database" "default" {
  cosmos_account_name = "${local.cosmos_account_name}"
  resource_group_name = "${local.resource_group_name}"
  name                = "testdatabase"
}

resource "azcli_cosmos_database" "db_with_throughput" {
  cosmos_account_name = "${local.cosmos_account_name}"
  resource_group_name = "${local.resource_group_name}"
  name                = "throughputdb"
  throughput          = "400"
}

resource "azcli_cosmos_collection" "collection_with_dedicated_throughput" {
   cosmos_account_name = "${local.cosmos_account_name}"
   resource_group_name = "${local.resource_group_name}"
   database_name       = "${azcli_cosmos_database.db_with_throughput.id}"
   name                = "mycollectionwithdedicatedthroughput"
   throughput          = "800"
 }

 resource "azcli_cosmos_collection" "collection_with_db_throughput" {
   cosmos_account_name = "${local.cosmos_account_name}"
   resource_group_name = "${local.resource_group_name}"
   database_name       = "${azcli_cosmos_database.db_with_throughput.id}"
   name                = "mycollectionwithdbthroughput"
 }

 resource "azcli_cosmos_collection" "default" {
   cosmos_account_name = "${local.cosmos_account_name}"
   resource_group_name = "${local.resource_group_name}"
   database_name       = "${azcli_cosmos_database.default.id}"
   name                = "mycollection"
   throughput = "400"
 }

  resource "azcli_cosmos_collection" "partition" {
   cosmos_account_name = "${local.cosmos_account_name}"
   resource_group_name = "${local.resource_group_name}"
   database_name       = "${azcli_cosmos_database.default.id}"
   name                = "partition"
   partition_key       = "/abu/belal/test"
   throughput = "400"
 }

Full Example

provider "azcli" {
  subscription_name = "azure-abu-test"
  version = "~> 0.0"
}


locals {
  resource_group_name = "abxrg0008-test"
  cosmos_account_name = "abxtf"

}

# the official azurerm provider now supports creating database, you may chose to use that instead but including here for reference
resource "azcli_cosmos_database" "default" {
  cosmos_account_name = "${local.cosmos_account_name}"
  resource_group_name = "${local.resource_group_name}"
  name                = "testdatabase"
}

 resource "azcli_cosmos_collection" "default" {
   cosmos_account_name = "${local.cosmos_account_name}"
   resource_group_name = "${local.resource_group_name}"
   database_name       = "${azcli_cosmos_database.default.id}"
   name                = "mycollection"
   throughput = "400"
 }

  resource "azcli_cosmos_collection" "partition" {
   cosmos_account_name = "${local.cosmos_account_name}"
   resource_group_name = "${local.resource_group_name}"
   database_name       = "${azcli_cosmos_database.default.id}"
   name                = "partition"
   partition_key       = "/abu/belal/test"
   throughput = "400"
 }

azcli_functionapp_slot

The resource type will create a function app slot and perform some basic managing of setting.

This will allow you to configure the following settings:

• http 2.0
• always on

This also enables by default a managed identity

Example

The below example will create two slots

provider "azcli" {
  subscription_name = "MyAzureSubscription"
  version = "=0.0.6"
}


locals {
  resource_group_name = "myrg"

}

resource "azcli_functionapp_slot" "slot1" {
  slot_name = "slot1"
  resource_group_name = "myrg"
  function_app_name = "mrdtestapp"
  http_20_enabled = "true"
  always_on = "true"
}
resource "azcli_functionapp_slot" "slot2" {
  slot_name = "slot2"
  resource_group_name = "myrg"
  function_app_name = "myapp"
  http_20_enabled = "true"
  always_on = "false"
}


output "id" {
  value = azcli_functionapp_slot.slot1.id
}

output "identity" {
  value = azcli_functionapp_slot.slot1.identity
}