Create an Angular app with Azure Cosmos DB's API for MongoDB - Create an Azure Cosmos DB account

  • Article

APPLIES TO: MongoDB

This multi-part tutorial demonstrates how to create a new app written in Node.js with Express and Angular and then connect it to your Azure Cosmos DB account configured with Azure Cosmos DB's API for MongoDB.

Part 4 of the tutorial builds on Part 3 and covers the following tasks:

  • Create an Azure resource group using the Azure CLI
  • Create an Azure Cosmos DB account using the Azure CLI

Prerequisites

Before starting this part of the tutorial, ensure you've completed the steps in Part 3 of the tutorial.

In this tutorial section, you can use the Azure CLI installed locally.

Note

Before you can use Azure CLI in Microsoft Azure operated by 21Vianet, please run az cloud set -n AzureChinaCloud first to change the cloud environment. If you want to switch back to Azure Public Cloud, run az cloud set -n AzureCloud again.

Sign in to Azure

You'll use the Azure CLI to create the resources needed to host your app in Azure. To run Azure CLI commands locally, sign in to your Azure subscription with the az login command and follow the on-screen directions.

az login

Note

Before you can use Azure CLI in Azure China, please run az cloud set -n AzureChinaCloud first to change the cloud environment. If you want to switch back to Global Azure, run az cloud set -n AzureCloud again.

Create a resource group

A resource group is a logical container into which Azure resources, such as web apps, databases, and storage accounts, are deployed and managed. For example, you can choose to delete the entire resource group in one simple step later.

In the Azure CLI, create a resource group with the az group create command. The following example creates a resource group named myResourceGroup in the China North location. To see all supported locations for App Service in Free tier, run the az appservice list-locations --sku FREE command.

az group create --name myResourceGroup --location "China North"

You generally create your resource group and the resources in a region near you.

When the command finishes, a JSON output shows you the resource group properties.

Tip

This tutorial walks you through the steps to build the application step-by-step. If you want to download the finished project, you can get the completed application from the angular-cosmosdb repo on GitHub.

Create an Azure Cosmos DB account

Create an Azure Cosmos DB account with the az cosmosdb create command.

az cosmosdb create --name <cosmosdb-name> --resource-group myResourceGroup --kind MongoDB
  • For <cosmosdb-name> use your own unique Azure Cosmos DB account name, the name needs to be unique across all Azure Cosmos DB account names in Azure.
  • The --kind MongoDB setting enables the Azure Cosmos DB to have MongoDB client connections.

It may take a minute or two for the command to complete. When it's done, the terminal window displays information about the new database.

Once the Azure Cosmos DB account has been created:

  1. Open a new browser window and go to https://portal.azure.cn

  2. Click the Azure Cosmos DB logo on the left bar, and it shows you all the Azure Cosmos DB s you have.

  3. Click on the Azure Cosmos DB account you just created, select the Overview tab and scroll down to view the map where the database is located.

    Screenshot shows the Overview of an Azure Cosmos DB DB Account.

  4. Scroll down on the left navigation and click the Replicate data globally tab, this displays a map where you can see the different areas you can replicate into. For example, you can click China North or China East and replicate your data to China. You can learn more about multiple-region replication in How to distribute data multiple-regionally with Azure Cosmos DB. For now, let's just keep the once instance and when we want to replicate, we know how.

    Screenshot shows an Azure Cosmos DB DB Account with Replicate data globally selected.

Next steps

In this part of the tutorial, you've done the following:

  • Created an Azure resource group using the Azure CLI
  • Created an Azure Cosmos DB account using the Azure CLI

You can proceed to the next part of the tutorial to connect Azure Cosmos DB to your app using Mongoose.

Use Mongoose to connect to Azure Cosmos DB

Trying to do capacity planning for a migration to Azure Cosmos DB? You can use information about your existing database cluster for capacity planning.