Freigeben über

Schnellstart: Erstellen eines Azure Cosmos DB for MongoDB-Clusters mit virtuellem Kern mithilfe einer Bicep-Vorlage

  • Artikel

GILT FÜR: MongoDB-vCore

In dieser Schnellstartanleitung erstellen Sie einen neuen Azure Cosmos DB for MongoDB vCore-Cluster. Dieser Cluster enthält alle Ihre MongoDB-Ressourcen: Datenbanken, Sammlungen und Dokumente. Der Cluster stellt einen eindeutigen Endpunkt für verschiedene Tools und SDKs bereit, um eine Verbindung mit Azure Cosmos DB herzustellen und alltägliche Vorgänge auszuführen.

Voraussetzungen

Überprüfen der Bicep-Datei

Die in dieser Schnellstartanleitung verwendete Bicep-Datei stammt aus den Azure-Schnellstartvorlagen.

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

Hinweis

Beachten Sie, dass shardGroupSpecs im obigen Code als nodeGroupSpecs bezeichnet wird.

In der Bicep-Datei sind zwei Azure-Ressourcen definiert:

Bereitstellen der Bicep-Datei

Erstellen Sie mithilfe der Bicep-Vorlage einen Azure Cosmos DB for MongoDB-Cluster mit virtuellem Kern.

  1. Erstellen Sie Shellvariablen für resourceGroupName und location

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

  2. Wenn Sie das noch nicht getan haben, melden Sie sich mithilfe des Befehls az login bei der Azure CLI an.

  3. Erstellen Sie mit dem Befehl az group create eine neue Ressourcengruppe in Ihrem Abonnement.

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

  4. Verwenden Sie az deployment group create, um die Bicep-Vorlage bereitzustellen. Sie werden dann aufgefordert, einen Wert für die adminUsername- und adminPassword-Parameter einzugeben.

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

    Tipp

    Alternativ können Sie die --parameters-Option verwenden, um eine Parameterdatei mit vordefinierten Werten zu übergeben.

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

    Diese JSON-Beispieldatei fügt clusteradmin- und P@ssw.rd-Werte für die adminUsername- respektive adminPassword-Parameter ein.

    {
  "$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. Warten Sie, bis der Bereitstellungsvorgang abgeschlossen ist, bevor Sie fortfahren.

Überprüfen der bereitgestellten Ressourcen

Listen Sie die von der Bicep-Vorlage bereitgestellten Ressourcen für Ihre Zielressourcengruppe auf.

  1. Verwenden Sie az resource list, um eine Liste der Ressourcen in Ihrer Ressourcengruppe abzurufen.

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

  2. Suchen Sie in der Beispielausgabe nach Ressourcen, die den Typ Microsoft.DocumentDB/mongoClusters aufweisen. Hier sehen Sie ein Beispiel für den Typ der zu erwartenden Ausgabe:

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

Bereinigen von Ressourcen

Wenn Sie Ihren Azure Cosmos DB for MongoDB-Cluster mit virtuellem Kern fertiggestellt haben, können Sie die von Ihnen erstellten Azure-Ressourcen löschen, damit keine weiteren Gebühren anfallen.

  1. Verwenden Sie az group delete, um die Ressourcengruppe aus Ihrem Abonnement zu entfernen.

    az group delete \
    --name $resourceGroupName

Nächster Schritt

In dieser Anleitung haben Sie erfahren, wie Sie einen Azure Cosmos DB for MongoDB vCore-Cluster erstellen. Sie können jetzt Daten zu Ihrem Cluster migrieren.

Migrieren von Daten zu Azure Cosmos DB for MongoDB vCore