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

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

• Ett Azure-konto med en aktiv prenumeration. Skapa ett konto utan kostnad.

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:

• Microsoft.DocumentDB/mongoclusters: Skapar ett Azure Cosmos DB för MongoDB vCore-kluster.
  • Microsoft.DocumentDB/mongoClusters/firewallRules: Skapar brandväggsregler för Azure Cosmos DB for MongoDB vCore-klustret.

Distribuera Bicep-filen

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

Azure CLI

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.

Azure PowerShell

1. Skapa gränssnittsvariabler för RESOURCE_GROUP_NAME och LOCATION

   # Variable for resource group name and location
   $RESOURCE_GROUP_NAME = "msdocs-cosmos-quickstart-rg"
   $LOCATION = "East US"
   

2. Om du inte redan har gjort det loggar du in på Azure PowerShell med hjälp av cmdleten Connect-AzAccount .

3. Använd cmdleten New-AzResourceGroup för att skapa en ny resursgrupp i din prenumeration.

   $parameters = @{
       Name = $RESOURCE_GROUP_NAME
       Location = $LOCATION
   }
   New-AzResourceGroup @parameters
   

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

   $parameters = @{
       ResourceGroupName = $RESOURCE_GROUP_NAME
       TemplateFile = "main.bicep"
   }
   New-AzResourceGroupDeployment @parameters
   

   Dricks

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

   $parameters = @{
       ResourceGroupName = $RESOURCE_GROUP_NAME
       TemplateFile = "main.bicep"
       TemplateParameterFile = "main.parameters.json"
   }
   New-AzResourceGroupDeployment @parameters
   

   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.

Azure CLI

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
   

Azure PowerShell

1. Använd Get-AzResource för att hämta en lista över resurser i resursgruppen.

   $parameters = @{
       ResourceGroupName = $RESOURCE_GROUP_NAME
   }
   Get-AzResource @parameters
   

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              : msdocs-sz2dac3xtwzzu
   ResourceGroupName : msdocs-cosmos-quickstart-rg
   ResourceType      : Microsoft.DocumentDB/mongoClusters
   Location          : eastus
   ResourceId        : /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/msdocs-cosmos-quickstart-rg/providers/Microsoft.DocumentDB/mongoClusters/msdocs-sz2dac3xtwzzu
   Tags              : 
   

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.

Azure CLI

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

   az group delete \
       --name $resourceGroupName
   

Azure PowerShell

1. Använd Remove-AzResourceGroup för att ta bort resursgruppen från din prenumeration.

   $parameters = @{
       Name = $RESOURCE_GROUP_NAME
   }
   Remove-AzResourceGroup @parameters
   

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