Sdílet prostřednictvím

Rychlý start: Vytvoření clusteru virtuálních jader Azure Cosmos DB pro MongoDB pomocí šablony Bicep

  • Článek

PLATÍ PRO: Virtuální jádro MongoDB

V tomto rychlém startu vytvoříte nový cluster virtuálních jader Azure Cosmos DB pro MongoDB. Tento cluster obsahuje všechny prostředky MongoDB: databáze, kolekce a dokumenty. Cluster poskytuje jedinečný koncový bod pro různé nástroje a sady SDK pro připojení ke službě Azure Cosmos DB a provádění každodenních operací.

Požadavky

Kontrola souboru Bicep

Soubor Bicep použitý v tomto rychlém startu pochází ze šablon Azure Pro rychlý start.

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

Poznámka:

Upozorňujeme, že ve výše uvedeném kódu se shardGroupSpecs nazývá nodeGroupSpecs.

V souboru Bicep se definují dva prostředky Azure:

Nasazení souboru Bicep

Vytvořte cluster virtuálních jader Azure Cosmos DB pro MongoDB pomocí šablony Bicep.

  1. Vytvoření proměnných prostředí pro resourceGroupName a umístění

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

  2. Pokud jste to ještě neudělali, přihlaste se k Azure CLI pomocí az login příkazu.

  3. az group create Pomocí příkazu vytvořte v předplatném novou skupinu prostředků.

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

  4. Slouží az deployment group create k nasazení šablony bicep. Pak se zobrazí výzva k zadání hodnoty parametrů adminUsername a adminPassword parametrů.

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

    Tip

    Alternativně můžete použít --parameters možnost předání souboru parametrů s předem definovanými hodnotami.

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

    Tento příklad souboru JSON vloží clusteradmin a P@ssw.rd hodnoty pro adminUsername parametry a adminPassword parametry.

    {
  "$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. Počkejte, než se operace nasazení dokončí, a teprve pak pokračujte.

Kontrola nasazených prostředků

Uveďte prostředky nasazené šablonou Bicep do cílové skupiny prostředků.

  1. Slouží az resource list k získání seznamu prostředků ve vaší skupině prostředků.

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

  2. V příkladu výstupu vyhledejte prostředky, které mají typ Microsoft.DocumentDB/mongoClusters. Tady je příklad typu výstupu, který očekáváte:

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

Vyčištění prostředků

Až budete hotovi s clusterem virtuálních jader Azure Cosmos DB pro MongoDB, můžete odstranit prostředky Azure, které jste vytvořili, abyste nemuseli účtovat další poplatky.

  1. Slouží az group delete k odebrání skupiny prostředků z vašeho předplatného.

    az group delete \
    --name $resourceGroupName

Další krok

V této příručce jste zjistili, jak vytvořit cluster virtuálních jader Azure Cosmos DB pro MongoDB. Teď můžete migrovat data do clusteru.

Migrace dat do služby Azure Cosmos DB pro virtuální jádro MongoDB