Share via

Snabbstart: Skapa ett Azure Cosmos DB for MongoDB vCore-kluster med hjälp av en Bicep-mall

  • Artikel

GÄLLER FÖR: MongoDB vCore

I den här snabbstarten skapar du ett nytt Azure Cosmos DB för MongoDB vCore-kluster. Det här klustret innehåller alla dina MongoDB-resurser: databaser, samlingar och dokument. Klustret tillhandahåller en unik slutpunkt för olika verktyg och SDK:er för att ansluta till Azure Cosmos DB och utföra vardagliga åtgärder.

Förutsättningar

Granska Bicep-filen

Bicep-filen som används i den här snabbstarten kommer från Azure-snabbstartsmallar.

@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'
  }
}

Kommentar

Observera att i koden ovan kallas shardGroupSpecs nodeGroupSpecs.

Två Azure-resurser definieras i Bicep-filen:

Distribuera Bicep-filen

Skapa ett Azure Cosmos DB for MongoDB vCore-kluster med hjälp av Bicep-mallen.

  1. Skapa gränssnittsvariabler för resourceGroupName och plats

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

  2. Om du inte redan har gjort det loggar du in på Azure CLI med kommandot az login .

  3. az group create Använd kommandot för att skapa en ny resursgrupp i din prenumeration.

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

  4. Använd az deployment group create för att distribuera bicep-mallen. Du uppmanas sedan att ange ett värde för parametrarna adminUsername och adminPassword .

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

    Dricks

    Du kan också använda alternativet --parameters för att skicka in en parameterfil med fördefinierade värden.

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

    I det här exemplet matas clusteradmin JSON-filen in och P@ssw.rd värden för parametrarna adminUsername respektive adminPassword parametrarna.

    {
  "$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. Vänta tills distributionsåtgärden har slutförts innan du går vidare.

Granska distribuerade resurser

Visa en lista över de resurser som distribuerats av Bicep-mallen till målresursgruppen.

  1. Använd az resource list för att hämta en lista över resurser i resursgruppen.

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

  2. I exempelutdata letar du efter resurser som har en typ av Microsoft.DocumentDB/mongoClusters. Här är ett exempel på vilken typ av utdata du kan förvänta dig:

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

Rensa resurser

När du är klar med ditt Azure Cosmos DB for MongoDB vCore-kluster kan du ta bort de Azure-resurser som du skapade så att du inte debiteras fler avgifter.

  1. Använd az group delete för att ta bort resursgruppen från din prenumeration.

    az group delete \
    --name $resourceGroupName

Gå vidare

I den här guiden har du lärt dig hur du skapar ett Azure Cosmos DB för MongoDB vCore-kluster. Nu kan du migrera data till klustret.

Migrera data till Azure Cosmos DB för MongoDB vCore