Share via

Criar um aplicativo Angular com a API do Azure Cosmos DB para MongoDB - Criar uma conta do Azure Cosmos DB

  • Artigo

APLICA-SE A: MongoDB

Este tutorial com várias partes demonstra como criar um novo aplicativo escrito em Node.js com Express e Angular e, em seguida, conectá-lo à sua conta do Azure Cosmos DB configurada com a API do Azure Cosmos DB para MongoDB.

A Parte 4 do tutorial é a continuação da Parte 3 e abrange as seguintes tarefas:

  • Criar um grupo de recursos do Azure com a CLI do Azure
  • Criar uma conta do Azure Cosmos DB com a CLI do Azure

Instruções de vídeo

Pré-requisitos

Antes de iniciar esta parte do tutorial, certifique-se de que concluiu os passos na Parte 3 do tutorial.

Nesta secção do tutorial, pode utilizar a Azure Cloud Shell (no browser) ou a CLI do Azure instalada localmente.

Azure Cloud Shell

O Azure aloja o Azure Cloud Shell, um ambiente de shell interativo que pode utilizar através do seu browser. Pode utilizar o Bash ou o PowerShell com o Cloud Shell para trabalhar com os serviços do Azure. Você pode usar os comandos pré-instalados do Cloud Shell para executar o código neste artigo, sem precisar instalar nada em seu ambiente local.

Para iniciar o Azure Cloud Shell:

Opção Exemplo/Ligação
Selecione Experimentar no canto superior direito de um código ou bloco de comandos. Selecionar Experimentar não copia automaticamente o código ou comando para o Cloud Shell. Screenshot that shows an example of Try It for Azure Cloud Shell.
Aceda a https://shell.azure.com ou selecione o botão Iniciar Cloud Shell para abrir o Cloud Shell no browser. Button to launch Azure Cloud Shell.
Selecione o botão Cloud Shell na barra de menus, na parte direita do portal do Azure. Screenshot that shows the Cloud Shell button in the Azure portal

Para usar o Azure Cloud Shell:

  1. Inicie o Cloud Shell.

  2. Selecione o botão Copiar em um bloco de código (ou bloco de comando) para copiar o código ou comando.

  3. Cole o código ou comando na sessão do Cloud Shell selecionando Ctrl+Shift+V no Windows e Linux ou selecionando Cmd+Shift+V no macOS.

  4. Selecione Enter para executar o código ou comando.

Iniciar sessão no Azure

Vai utilizar a CLI do Azure para criar os recursos necessários para alojar a sua aplicação no Azure. Se executar comandos da CLI do Azure no Cloud Shell, isso significa que já tem sessão iniciada. Para executar comandos da CLI do Azure localmente, inicie sessão na sua subscrição do Azure com o comando az login e siga as instruções apresentadas no ecrã.

az login

Criar um grupo de recursos

Um grupo de recursos é um contêiner lógico no qual os recursos do Azure, como aplicativos Web, bancos de dados e contas de armazenamento, são implantados e gerenciados. Por exemplo, pode optar por eliminar todo o grupo de recursos num único passo simples mais tarde.

No Cloud Shell, crie um grupo de recursos com o comando az group create. O exemplo seguinte cria um grupo de recursos com o nome myResourceGroup, na localização Europa Ocidental. Para ver todas as localizações suportadas para o Serviço de Aplicações no escalão Gratuito, execute o comando az appservice list-locations --sku FREE.

az group create --name myResourceGroup --location "West Europe"

Geralmente, o grupo de recursos e os recursos são criados numa região perto de si.

Quando o comando for concluído, uma saída JSON mostra as propriedades do grupo de recursos.

Gorjeta

Este tutorial orienta-o ao longo dos passos para criar a aplicação passo a passo. Se quiser transferir o projeto concluído, pode obter a aplicação terminada a partir do repositório angular-cosmosdb no GitHub.

Criar uma conta do Azure Cosmos DB

Crie uma conta do Azure Cosmos DB com o comando az cosmosdb create.

az cosmosdb create --name <cosmosdb-name> --resource-group myResourceGroup --kind MongoDB
  • Em <cosmosdb-name>, utilize o nome exclusivo da sua conta do Azure Cosmos DB, o qual tem de ser único de entre todos os nomes de contas do Azure Cosmos DB no Azure.
  • A definição --kind MongoDB permite que o Azure Cosmos DB tenha ligações de cliente MongoDB.

A conclusão do comando pode demorar alguns minutos. Quando terminar, a janela de terminal apresenta informações sobre a base de dados nova.

Após a conta do Azure Cosmos DB ter sido criada:

  1. Abra uma janela nova do browser e aceda a https://portal.azure.com

  2. Clique no logotipo do Azure Cosmos DB na barra esquerda e ele mostra todos os arquivos do Azure Cosmos DB que você tem.

  3. Clique na conta do Azure Cosmos DB que acabou de criar, selecione o separador Descrição geral e desloque-se para baixo para ver o mapa onde está localizada a base de dados.

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

  4. Desloque-se para baixo na navegação do lado esquerdo e clique no separador Replicar dados globalmente, o que apresenta um mapa no qual pode ver as diferentes áreas em que pode replicar. Por exemplo, pode clicar em Austrália Sudeste ou Leste da Austrália e replicar os dados na Austrália. Pode saber mais sobre a replicação global em How to distribute data globally with Azure Cosmos DB (Como distribuir dados globalmente com o Azure Cosmos DB). Por agora, vamos apenas manter a única instância e, quando quisermos replicar, já sabemos como.

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

Próximos passos

Nesta parte do tutorial, fez o seguinte:

  • Criou um grupo de recursos do Azure com a CLI do Azure
  • Criou uma conta do Azure Cosmos DB com a CLI do Azure

Pode avançar para a parte seguinte do tutorial para ligar o Azure Cosmos DB à sua aplicação com o Mongoose.

Use Mongoose to connect to Azure Cosmos DB (Utilizar o Mongoose para ligar ao Azure Cosmos DB)

Tentando fazer o planejamento de capacidade para uma migração para o Azure Cosmos DB? Você pode usar informações sobre seu cluster de banco de dados existente para planejamento de capacidade.