Creare un'app Angular con l'API Azure Cosmos DB for MongoDB - Creare un account Azure Cosmos DB

  • Si applica a: ✅ MongoDB

SI APPLICA A: Mongodb

Importante

Si vuole eseguire la migrazione di un'applicazione MongoDB esistente o usare le funzionalità MQL (MongoDB Query Language) ? Prendere in considerazione Azure DocumentDB.

Si sta cercando una soluzione di database per scenari su larga scala con un contratto di servizio di disponibilità 99.999%, scalabilità automatica immediata e failover automatico in più aree? Prendere in considerazione Azure Cosmos DB per NoSQL.

Questa esercitazione in più parti illustra come creare una nuova app scritta in Node.js con Express e Angular e quindi connetterla all'account Azure Cosmos DB configurato con l'API Azure Cosmos DB for MongoDB.

La Parte 4 dell'esercitazione è basata sulla Parte 3 e illustra le attività seguenti:

  • Creare un gruppo di risorse di Azure con l'interfaccia della riga di comando di Azure
  • Creare un account Azure Cosmos DB mediante l'interfaccia della riga di comando di Azure

Guida video

Prerequisiti

Prima di iniziare questa parte dell'esercitazione, assicurarsi di avere completato le procedure illustrate nella Parte 3 dell'esercitazione.

In questa sezione dell'esercitazione è possibile usare Azure Cloud Shell (nel browser Internet) o l'interfaccia della riga di comando di Azure installata in locale.

Azure Cloud Shell

Azure ospita Azure Cloud Shell, un ambiente shell interattivo che è possibile usare tramite il browser. È possibile usare Bash o PowerShell con Cloud Shell per usare i servizi di Azure. È possibile usare i comandi preinstallati di Cloud Shell per eseguire il codice contenuto in questo articolo senza dover installare strumenti nell'ambiente locale.

Per avviare Azure Cloud Shell:

Opzione Esempio/collegamento
Selezionare Prova nell'angolo superiore destro di un codice o di un blocco di comandi. Quando si seleziona Prova, il codice o il comando non viene copiato automaticamente in Cloud Shell. Screenshot che mostra un esempio della funzione
Passare a https://shell.azure.com o selezionare il pulsante Avvia Cloud Shell per aprire Cloud Shell nel browser. Pulsante per avviare Azure Cloud Shell.
Selezionare il pulsante Cloud Shell nella barra dei menu in alto a destra nel portale di Azure. Screenshot che mostra il pulsante Cloud Shell nel portale di Azure

Per usare Azure Cloud Shell:

  1. Avviare Cloud Shell.

  2. Selezionare il pulsante Copia in un blocco di codice (o blocco di comandi) per copiare il codice o il comando.

  3. Incollare il codice o il comando nella sessione di Cloud Shell selezionando Ctrl+Shift+V in Windows e Linux oppure selezionando Cmd+Shift+V in macOS.

  4. Premere INVIO per eseguire il codice o il comando.

Accedere ad Azure

Usare l'interfaccia della riga di comando di Azure per creare le risorse necessarie per ospitare l'app in Azure. Quando si eseguono comandi dell'interfaccia della riga di comando di Azure in Cloud Shell, si è già connessi. Per eseguire comandi dell'interfaccia della riga di comando di Azure in locale, accedere alla sottoscrizione di Azure con il comando az login e seguire le istruzioni visualizzate.

az login

Creare un gruppo di risorse

Un gruppo di risorse è un contenitore logico in cui vengono distribuite e gestite risorse di Azure, ad esempio app Web, database e account di archiviazione. Ad esempio, si può scegliere in un secondo momento di eliminare l'intero gruppo di risorse in un unico semplice passaggio.

In Cloud Shell creare un gruppo di risorse con il comando az group create. L'esempio seguente crea un gruppo di risorse denominato myResourceGroup nella località Europa occidentale. Per visualizzare tutte le località supportate per il servizio app nel livello gratuito, eseguire il comando az appservice list-locations --sku FREE.

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

In genere, il gruppo di risorse e le risorse vengono creati in un'area vicina alla località dell'utente.

Al termine del comando, un output JSON visualizza le proprietà del gruppo di risorse.

Suggerimento

Questa esercitazione illustra in modo dettagliato la procedura per la creazione dell'applicazione. Se si vuole scaricare il progetto finito, è possibile ottenere l'applicazione completa dal repository angular-cosmosdb in GitHub.

Creazione di un account Azure Cosmos DB

Creare un account Azure Cosmos DB con il comando az cosmosdb create.

az cosmosdb create --name <cosmosdb-name> --resource-group myResourceGroup --kind MongoDB
  • Per utilizzare il proprio nome account Azure Cosmos DB univoco con <cosmosdb-name>, assicurati che il nome sia univoco tra tutti i nomi account Azure Cosmos DB in Azure.
  • L'impostazione --kind MongoDB consente ad Azure Cosmos DB di avere connessioni client MongoDB.

Il completamento del comando potrebbe richiedere un minuto o due. Al termine, la finestra del terminale visualizza le informazioni sul nuovo database.

Dopo la creazione dell'account Azure Cosmos DB:

  1. Aprire una nuova finestra del browser e passare a https://portal.azure.com

  2. Fare clic sul logo di Azure Cosmos DB nella barra a sinistra per visualizzare tutte le istanze di Azure Cosmos DB disponibili.

  3. Fare clic sull'account Azure Cosmos DB appena creato, selezionare la scheda Panoramica e scorrere verso il basso per visualizzare la mappa con la posizione del database.

    Screenshot che mostra le informazioni generali di un account Azure Cosmos DB.

  4. Scorrere verso il basso sulla barra di spostamento a sinistra e fare clic sulla scheda Replica i dati a livello globale per visualizzare una mappa con le diverse aree in cui è possibile eseguire la replica. È ad esempio possibile fare clic su Australia sud-orientale o su Australia orientale e replicare i dati in Australia. Per altre informazioni sulla replica globale, vedere Come distribuire i dati a livello globale con Azure Cosmos DB. Per ora, teniamo semplicemente una sola istanza e, quando vogliamo replicarla, sappiamo come fare.

    Screenshot che mostra un account Azure Cosmos DB con l'opzione Replica dati a livello globale selezionata.

Passaggi successivi

In questa parte dell'esercitazione sono state eseguite le operazioni seguenti:

  • È stato creato un gruppo di risorse di Azure con l'interfaccia della riga di comando di Azure
  • È stato creato un account Azure Cosmos DB mediante l'interfaccia della riga di comando di Azure

È possibile passare alla parte successiva dell'esercitazione per connettere Azure Cosmos DB all'app usando Mongoose.

Usare Mongoose per connettersi ad Azure Cosmos DB

Si sta tentando di pianificare la capacità per una migrazione ad Azure Cosmos DB? È possibile usare le informazioni del cluster di database esistente per la pianificazione della capacità.

  • Last updated on