Udostępnij za pośrednictwem

Szybki start: tworzenie klastra rdzeni wirtualnych usługi Azure Cosmos DB dla bazy danych MongoDB przy użyciu szablonu Bicep

  • Artykuł

DOTYCZY: Rdzenie wirtualne bazy danych MongoDB

W tym przewodniku Szybki start utworzysz nowy klaster usługi Azure Cosmos DB dla bazy danych MongoDB z rdzeniami wirtualnymi. Ten klaster zawiera wszystkie zasoby bazy danych MongoDB, kolekcje i dokumenty. Klaster udostępnia unikatowy punkt końcowy dla różnych narzędzi i zestawów SDK do łączenia się z usługą Azure Cosmos DB i wykonywania codziennych operacji.

Wymagania wstępne

Przejrzyj plik Bicep

Plik Bicep używany w tym przewodniku Szybki start pochodzi z szablonów szybkiego startu platformy 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'
  }
}

Uwaga

Zwróć uwagę, że w powyższym kodzie element shardGroupSpecs nosi nazwę nodeGroupSpecs.

Dwa zasoby platformy Azure są zdefiniowane w pliku Bicep:

Wdrażanie pliku Bicep

Utwórz klaster usługi Azure Cosmos DB dla rdzeni wirtualnych bazy danych MongoDB przy użyciu szablonu Bicep.

  1. Tworzenie zmiennych powłoki dla właściwości resourceGroupName i lokalizacji

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

  2. Jeśli jeszcze tego nie zrobiono, zaloguj się do interfejsu az login wiersza polecenia platformy Azure przy użyciu polecenia .

  3. Użyj polecenia , az group create aby utworzyć nową grupę zasobów w ramach subskrypcji.

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

  4. Użyj az deployment group create polecenia , aby wdrożyć szablon bicep. Następnie zostanie wyświetlony monit o wprowadzenie wartości parametrów adminUsername i adminPassword .

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

    Napiwek

    Alternatywnie użyj --parameters opcji , aby przekazać plik parametrów ze wstępnie zdefiniowanymi wartościami.

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

    W tym przykładzie plik JSON wprowadza clusteradmin odpowiednio wartości i P@ssw.rd dla adminUsername parametrów i adminPassword .

    {
  "$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. Przed przejściem poczekaj na zakończenie operacji wdrażania.

Przeglądanie wdrożonych zasobów

Wyświetl listę zasobów wdrożonych przez szablon Bicep w docelowej grupie zasobów.

  1. Użyj polecenia az resource list , aby uzyskać listę zasobów w grupie zasobów.

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

  2. W przykładowych danych wyjściowych poszukaj zasobów, które mają typ Microsoft.DocumentDB/mongoClusters. Oto przykład typu danych wyjściowych, których można oczekiwać:

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

Czyszczenie zasobów

Po zakończeniu pracy z klastrem rdzeni wirtualnych usługi Azure Cosmos DB dla bazy danych MongoDB możesz usunąć utworzone zasoby platformy Azure, aby nie ponosić dodatkowych opłat.

  1. Użyj polecenia az group delete , aby usunąć grupę zasobów z subskrypcji.

    az group delete \
    --name $resourceGroupName

Następny krok

W tym przewodniku przedstawiono sposób tworzenia klastra rdzeni wirtualnych usługi Azure Cosmos DB dla bazy danych MongoDB. Teraz możesz migrować dane do klastra.

Migrowanie danych do usługi Azure Cosmos DB dla rdzeni wirtualnych bazy danych MongoDB