Поделиться через

Краткое руководство. Создание кластера виртуальных ядер Azure Cosmos DB для MongoDB с помощью шаблона Bicep

  • Статья

Область применения: Виртуальные ядра MongoDB

В этом кратком руководстве описано, как создать новый кластер виртуальных ядер Azure Cosmos DB для MongoDB. Этот кластер содержит все ресурсы MongoDB: базы данных, коллекции и документы. Кластер предоставляет уникальную конечную точку для различных средств и пакетов SDK для подключения к Azure Cosmos DB и выполнения повседневных операций.

Необходимые компоненты

Проверка BICEP-файла

Файл Bicep, используемый в этом кратком руководстве, взят из шаблонов быстрого запуска 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'
  }
}

Примечание.

Обратите внимание, что в приведенном выше коде shardGroupSpecs называется nodeGroupSpecs.

В файле Bicep определено два ресурса Azure:

Развертывание BICEP-файла

Создайте кластер виртуальных ядер Azure Cosmos DB для MongoDB с помощью шаблона Bicep.

  1. Создание переменных оболочки для resourceGroupName и расположения

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

  2. Если вы еще этого не сделали, войдите в Azure CLI с помощью команды az login.

  3. Используйте команду az group create, чтобы создать новую группу ресурсов в подписке.

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

  4. Используется az deployment group create для развертывания шаблона bicep. Затем вам будет предложено ввести значение для adminUsername параметров и adminPassword параметров.

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

    Совет

    Кроме того, используйте --parameters параметр для передачи файла параметров с предварительно определенными значениями.

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

    В этом примере JSON-файл внедряет clusteradmin и P@ssw.rd значения для adminPassword adminUsername параметров соответственно.

    {
  "$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. Дождитесь завершения операции развертывания перед переходом.

Просмотр развернутых ресурсов

Перечислите ресурсы, развернутые шаблоном Bicep в целевой группе ресурсов.

  1. Используется az resource list для получения списка ресурсов в группе ресурсов.

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

  2. В примере выходных данных найдите ресурсы с типом Microsoft.DocumentDB/mongoClusters. Ниже приведен пример типа выходных данных, которые следует ожидать:

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

Очистка ресурсов

После завершения работы с кластером виртуальных ядер Azure Cosmos DB для MongoDB можно удалить созданные ресурсы Azure, чтобы не взиматься дополнительная плата.

  1. Используется az group delete для удаления группы ресурсов из подписки.

    az group delete \
    --name $resourceGroupName

Следующий шаг

В этом руководстве вы узнали, как создать кластер виртуальных ядер Azure Cosmos DB для MongoDB. Теперь можно перенести данные в кластер.

Перенос данных в Azure Cosmos DB для виртуального ядра MongoDB