Challenge 01 - Install the Azure DocumentDB migration extension for VS Code and Deploy Azure Document DB

May 14, 2026 ยท View on GitHub

< Previous Challenge - Home - Next Challenge >

Introduction

Now that you've gotten your source MongoDB application and database working, you will next be installing the Azure Document DB Migration Extension in Visual Studio Code so that you can migrate the data from your source MongoDB to Azure Document DB in the next challenge. You will also be trying out the Azure DocumentDB extension for VS Code.

Prerequisites

You should have already completed the steps in Challenge 0 to set up your source MongoDB database and the sample application.

Description

First, you will install the Azure DocumentDB Migration extension in Visual Studio Code.

Next, you will deploy Azure Document DB. If you are continuing right from from Challenge 0, you do not need to login again.

NOTE: If you are using GitHub Codespaces, the az login command will use a Device Code to login. If your organization's Azure policy prevents this, follow these steps first before you run the deployment:

CODESPACES=false
az login

Perform the following steps to create an instance of Azure DocumentDB in your Azure subscription

  • Open a New Terminal window in VS Code
  • Type the following commands to deploy Azure DocumentDB.
cd infra 
./deploy-target-db.sh --administratorLogin mflixadmin --administratorPassword <password>

Optional: If you need to, you can specify the resourceGroupName and location as arguments to the deploy-target-db.sh script as follows. Note: It defaults to rg-mflix-documentdb and eastus2 for those, respectively:

cd infra 
./deploy-target-db.sh --resourceGroupName <your_resource_group_name> --location westus --administratorLogin mflixadmin --administratorPassword <password>

The deployment will take some time. While this is deploying, use the DocumentDB for VS Code extension to connect to your source MongoDB database and explore the data:

  • Whether you chose MongoDB running in ACI or Mongo DB Atlas, the MongoDB connection string information is in your .env

Once you've connected, explore the collections within the sample_mflix database. You should see:

  • comments
  • embedded_movies
  • movies
  • sessions
  • theaters
  • users

Open Documents within the movies collection. What do you see?

Success Criteria

To complete this challenge successfully, you should be able to:

  • Verify that you have the Azure DocumentDB migration extension installed
  • Verify that you have Azure DocumentDB deployed into your Azure subscription
  • Explore the database using the DocumentDB for VS Code extension

Learning Resources