Megosztás a következőn keresztül:


Rövid útmutató: Azure Cosmos DB létrehozása MongoDB vCore-fürthöz Bicep-sablon használatával

A KÖVETKEZŐKRE VONATKOZIK: MongoDB virtuális mag

Ebben a rövid útmutatóban létrehoz egy új Azure Cosmos DB-t a MongoDB vCore-fürthöz. Ez a fürt az összes MongoDB-erőforrást tartalmazza: adatbázisokat, gyűjteményeket és dokumentumokat. A fürt egyedi végpontot biztosít a különböző eszközök és SDK-k számára az Azure Cosmos DB-hez való csatlakozáshoz és a mindennapi műveletek végrehajtásához.

Előfeltételek

A Bicep-fájl áttekintése

Az ebben a rövid útmutatóban használt Bicep-fájl az Azure Gyorsindítási sablonokból származik.

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

Feljegyzés

Vegye figyelembe, hogy a fenti kódban a shardGroupSpecs neve nodeGroupSpecs.

Két Azure-erőforrás van definiálva a Bicep-fájlban:

A Bicep-fájl üzembe helyezése

Hozzon létre egy Azure Cosmos DB for MongoDB virtuális magfürtöt a Bicep-sablon használatával.

  1. A resourceGroupName és a hely rendszerhéjváltozóinak létrehozása

    # Variable for resource group name and location
    resourceGroupName="msdocs-cosmos-quickstart-rg"
    location="eastus"
    
  2. Ha még nem tette meg, jelentkezzen be az Azure CLI-be a az login paranccsal.

  3. az group create A paranccsal hozzon létre egy új erőforráscsoportot az előfizetésben.

    az group create \
        --name $resourceGroupName \
        --location $location
    
  4. A bicep-sablon üzembe helyezésére használható az deployment group create . Ezután a rendszer kéri, hogy adjon meg egy értéket a paraméterekhez és adminPassword a adminUsername paraméterekhez.

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

    Tipp.

    Azt is megteheti --parameters , hogy előre definiált értékeket tartalmazó paraméterfájlt ad át.

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

    Ez a példa JSON-fájl injektálja clusteradmin a P@ssw.rd és a adminUsername adminPassword paraméterek értékeit.

    {
      "$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. Mielőtt továbblépne, várja meg, amíg az üzembe helyezési művelet befejeződik.

Üzembe helyezett erőforrások áttekintése

Listázhatja a Bicep-sablon által a célerőforrás-csoportban üzembe helyezett erőforrásokat.

  1. Az erőforráscsoport erőforrásainak listájának lekérésére használható az resource list .

    az resource list \
        --resource-group $resourceGroupName \
        --location $location \
        --output tsv
    
  2. A példakimenetben keresse meg azokat az erőforrásokat, amelyek típusa Microsoft.DocumentDB/mongoClusters. Íme egy példa a várható kimenet típusára:

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

Az erőforrások eltávolítása

Ha végzett az Azure Cosmos DB for MongoDB virtuálismag-fürtjével, törölheti a létrehozott Azure-erőforrásokat, hogy ne járjon további költségekkel.

  1. Az az group delete erőforráscsoport eltávolítása az előfizetésből.

    az group delete \
        --name $resourceGroupName
    

Következő lépés

Ebben az útmutatóban megtanulta, hogyan hozhat létre Azure Cosmos DB for MongoDB vCore-fürtöt. Most már migrálhatja az adatokat a fürtbe.