Delen via

Quickstart: Een Azure Cosmos DB voor MongoDB vCore-cluster maken met behulp van een Bicep-sjabloon

  • Artikel

VAN TOEPASSING OP: MongoDB vCore

In deze quickstart maakt u een nieuw Azure Cosmos DB voor MongoDB vCore-cluster. Dit cluster bevat al uw MongoDB-resources: databases, verzamelingen en documenten. Het cluster biedt een uniek eindpunt voor verschillende hulpprogramma's en SDK's om verbinding te maken met Azure Cosmos DB en dagelijkse bewerkingen uit te voeren.

Vereisten

Het Bicep-bestand controleren

Het Bicep-bestand dat in deze quickstart wordt gebruikt, is afkomstig van Azure-quickstartsjablonen.

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

Notitie

Houd er rekening mee dat in de bovenstaande code shardGroupSpecs nodeGroupSpecs wordt genoemd.

Er worden twee Azure-resources gedefinieerd in het Bicep-bestand:

Het Bicep-bestand implementeren

Maak een Azure Cosmos DB voor MongoDB vCore-cluster met behulp van de Bicep-sjabloon.

  1. Shell-variabelen maken voor resourceGroupName en locatie

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

  2. Als u dat nog niet hebt gedaan, meldt u zich aan bij de Azure CLI met behulp van de az login opdracht.

  3. Gebruik de az group create opdracht om een nieuwe resourcegroep in uw abonnement te maken.

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

  4. Gebruik az deployment group create dit diagram om de bicep-sjabloon te implementeren. Vervolgens wordt u gevraagd om een waarde voor de adminUsername en adminPassword parameters in te voeren.

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

    Tip

    U kunt ook de --parameters optie gebruiken om een parameterbestand door te geven met vooraf gedefinieerde waarden.

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

    Dit voorbeeld van een JSON-bestand injecteert clusteradmin en P@ssw.rd waarden voor respectievelijk de adminUsername en adminPassword parameters.

    {
  "$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. Wacht tot de implementatiebewerking is voltooid voordat u verdergaat.

Geïmplementeerde resources bekijken

Vermeld de resources die door de Bicep-sjabloon zijn geïmplementeerd in uw doelresourcegroep.

  1. Gebruik az resource list dit om een lijst met resources in uw resourcegroep op te halen.

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

  2. Zoek in de voorbeelduitvoer naar resources met een type Microsoft.DocumentDB/mongoClusters. Hier volgt een voorbeeld van het type uitvoer dat u kunt verwachten:

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

Resources opschonen

Wanneer u klaar bent met uw Azure Cosmos DB voor MongoDB vCore-cluster, kunt u de Azure-resources verwijderen die u hebt gemaakt, zodat er geen extra kosten in rekening worden gebracht.

  1. Gebruik az group delete deze optie om de resourcegroep uit uw abonnement te verwijderen.

    az group delete \
    --name $resourceGroupName

Volgende stap

In deze handleiding hebt u geleerd hoe u een Azure Cosmos DB voor MongoDB vCore-cluster maakt. U kunt nu gegevens migreren naar uw cluster.

Gegevens migreren naar Azure Cosmos DB voor MongoDB vCore