Create a Cosmos DB Instance in Azure with Terraform

1 hour
  • 4 Learning Objectives

About this Hands-on Lab

Hey, Gurus! Welcome to the Create a Cosmos DB Instance in Azure with Terraform lab. In this lab, we will cover these 4 objectives:

1. First, we will log into the Azure Portal, configure the Cloud Shell, and then download and run the lab setup script to setup our lab.
1. Second, we will import the resource group.
1. Third, we will create the configuration and deploy the Azure Cosmos DB instance.
1. And for the fourth objective, we will update our configuration with an application container instance that will use the database instance created in the previous step, with a simple database-driven application that we will test to verify if our deployment was successful.

Learning Objectives

Successfully complete this lab by achieving the following learning objectives:

Set Up Cloud Shell and the Lab Environment

In the Portal

  1. Go to the Azure Portal and log in using your lab credentials.
  2. Click the Cloud Shell icon next to the search bar in the Portal.
  3. Select Bash at the prompt.
  4. Click Show Advanced Settings.
  5. Set the Cloud Shell region to the same location as the resource group.
  6. Select the existing Resource group, and select Use Existing for the Storage account.
  7. In the File share section, choose Create new and enter "terraform".
  8. Click Attach storage.
  9. Download the script at
  10. Add execute permissions to the script.
  11. Run the script.
Import the Resource Group

In the Cloud Shell

  1. In the Cloud Shell, review the
  2. Make note of the resource group name and label at the top and then close the file.
  3. Run the az group list command to get the subscription id.
  4. Import your resource group into Terraform using the resource group name, label, and subscription id.
  5. After the import, add the name and location of your resource group to the file so it looks like the code below (fill in with your resource group and location):
    resource "azurerm_resource_group" "super-vote" {
        name     = "<RESOURCE_GROUP>"
        location = "<LOCATION>"
  6. Save the file.
Deploy the Cosmos DB Instance

In the Cloud Shell

  1. Open the file.
  2. Define the Cosmos DB instance using the azurerm_cosmosdb_account resource with a label of super-vote.
  3. Create the DB instance using the following arguments and values:
    • name: "tfex-cosmos-db-${random_integer.ri.result}"
    • location: azurerm_resource_group.super-vote.location
    • resource_group_name:
    • offer_type: "Standard"
    • kind: "GlobalDocumentDB"
    • consistency_policy:
      • consistency_level: "BoundedStaleness"
      • max_interval_in_seconds: 10
      • max_staleness_prefix: 200
    • geo_location:
      • location: eastus
      • failover_priority: 0
  4. Save the changes.
  5. Apply the configuration.
Update the Config, Deploy the Changes, and Test the Application

In the Cloud Shell

  1. Open the file.
  2. Define the Container Instance using the azurerm_container_group with a label of super-vote. Create the containuer using the following arguments and values:
    • name: "super-vote"
    • location: azurerm_resource_group.super-vote.location
    • resource_group_name:
    • ip_address_type: "public"
    • dns_name_label: "super-vote"
    • os_type: "linux"
    • container::
      • name: "super-vote"
      • image: ""
      • cpu: "0.5"
      • memory: "1.5"
      • ports::
        • port: 80
        • protocol: "TCP"
    • secure_environment_variables::
      • COSMOS_DB_ENDPOINT: azurerm_cosmosdb_account.super-vote.endpoint
      • COSMOS_DB_MASTERKEY: azurerm_cosmosdb_account.super-vote.primary_master_key
      • TITLE: "Best Superhero!"
      • VOTE1VALUE: "Batman"
      • VOTE2VALUE: "Superman"
  3. Save the changes.
  4. Create a file called and paste the following:
    output "application_endpoint" {
      value = azurerm_container_group.super-vote.fqdn
  5. Save the changes.
  6. Apply the configuration
  7. After the apply completes, copy the dns output for the application endpoint and go to your browser.
  8. Paste the link in your browser and go to the endpoint.
  9. Test the functionality of the application by voting to confirm and complete the lab.

Additional Resources

So, picture this…

You are being asked to test a voting application with a Cosmos DB backend that will be used on the comics website for customer engagement. You will need to first deploy the Cosmos DB instance, then create a container instance that uses the database for the voting application.

Update your Terraform configuration after your database instance deployment with your container image configuration and configure it to use the database instance, and then apply your changes. Once the changes are applied, the endpoint provided in the output can be used to test the application. 

Now that we have a plan, let’s put it into action!

What are Hands-on Labs

Hands-on Labs are real environments created by industry experts to help you learn. These environments help you gain knowledge and experience, practice without compromising your system, test without risk, destroy without fear, and let you learn from your mistakes. Hands-on Labs: practice your skills before delivering in the real world.

Sign In
Welcome Back!

Psst…this one if you’ve been moved to ACG!

Get Started
Who’s going to be learning?