Condividi tramite

Guida introduttiva: creare un cluster Azure Cosmos DB for MongoDB vCore usando un modello Bicep

  • Articolo

SI APPLICA A: MongoDB vCore

Questa guida introduttiva illustra come creare un nuovo cluster Azure Cosmos DB for MongoDB vCore. Questo cluster contiene tutte le risorse di MongoDB: database, raccolte e documenti. Il cluster fornisce un endpoint univoco per vari strumenti e SDK per connettersi ad Azure Cosmos DB ed eseguire operazioni quotidiane.

Prerequisiti

Esaminare il file Bicep

Il file Bicep usato in questo avvio rapido proviene dai modelli di avvio rapido di Azure.

@description('Azure Cosmos DB MongoDB vCore cluster name')
@maxLength(44)
param clusterName string = 'msdocs-${uniqueString(resourceGroup().id)}'

@description('Location for the cluster.')
param location string = resourceGroup().location

@description('Username for admin user')
param adminUsername string

@secure()
@description('Password for admin user')
@minLength(8)
@maxLength(128)
param adminPassword string

resource cluster 'Microsoft.DocumentDB/mongoClusters@2022-10-15-preview' = {
  name: clusterName
  location: location
  properties: {
    administratorLogin: adminUsername
    administratorLoginPassword: adminPassword
    nodeGroupSpecs: [
        {
            kind: 'Shard'
            shardCount: 1
            sku: 'M40'
            diskSizeGB: 128
            enableHa: false
        }
    ]
  }
}

resource firewallRules 'Microsoft.DocumentDB/mongoClusters/firewallRules@2022-10-15-preview' = {
  parent: cluster
  name: 'AllowAllAzureServices'
  properties: {
    startIpAddress: '0.0.0.0'
    endIpAddress: '0.0.0.0'
  }
}

Nota

Tenere presente che nel codice precedente, shardGroupSpecs è denominato nodeGroupSpecs.

Nel file Bicep sono definite due risorse di Azure:

Distribuire il file Bicep

Creare un cluster Azure Cosmos DB for MongoDB vCore usando il modello Bicep.

  1. Creare variabili della shell per resourceGroupName e location

    # Variable for resource group name and location
resourceGroupName="msdocs-cosmos-quickstart-rg"
location="eastus"

  2. Se non è già stato fatto, accedere all'interfaccia della riga di comando di Azure usando il comando az login.

  3. Usare il comando az group create per creare un nuovo gruppo di risorse nella sottoscrizione.

    az group create \
    --name $resourceGroupName \
    --location $location

  4. Usare az deployment group create per distribuire il modello Bicep. Verrà quindi richiesto di immettere un valore per i parametri adminUsername e adminPassword.

    az deployment group create \
    --resource-group $resourceGroupName \
    --template-file 'main.bicep'

    Suggerimento

    In alternativa, usare l'opzione --parameters per passare un file di parametri con valori predefiniti.

    az deployment group create \
    --resource-group $resourceGroupName \
    --template-file 'main.bicep' \
    --parameters @main.parameters.json

    Questo esempio di file JSON inserisce rispettivamente i valori clusteradmin e P@ssw.rd per i parametri adminUsername e adminPassword.

    {
  "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "adminUsername": {
      "value": "clusteradmin"
    },
    "adminPassword": {
      "value": "P@ssw.rd"
    }
  }
}

  5. Attendere il completamento dell'operazione di distribuzione prima di procedere.

Esaminare le risorse distribuite

Elencare le risorse distribuite dal modello Bicep nel gruppo di risorse di destinazione.

  1. Usare az resource list per ottenere un elenco delle risorse contenute nel gruppo di risorse.

    az resource list \
    --resource-group $resourceGroupName \
    --location $location \
    --output tsv

  2. Nell'esempio di output, cercare le risorse con un tipo di Microsoft.DocumentDB/mongoClusters. Di seguito è riportato un esempio del tipo di output previsto:

    Name                  ResourceGroup                Location    Type                                Status
--------------------  ---------------------------  ----------  ----------------------------------  --------
msdocs-sz2dac3xtwzzu  msdocs-cosmos-quickstart-rg  eastus      Microsoft.DocumentDB/mongoClusters

Pulire le risorse

Dopo aver completato le operazioni con il cluster Azure Cosmos DB for MongoDB vCore, è possibile eliminare le risorse di Azure create in modo tale da non sostenere costi aggiuntivi.

  1. Usare az group delete per rimuovere il gruppo di risorse dalla sottoscrizione.

    az group delete \
    --name $resourceGroupName

Passaggio successivo

In questa guida si è appreso come creare un cluster Azure Cosmos DB for MongoDB vCore. È ora possibile eseguire la migrazione dei dati al cluster.

Eseguire la migrazione dei dati di Azure Cosmos DB for MongoDB vCore