Aracılığıyla paylaş

Hızlı Başlangıç: Bicep şablonu kullanarak MongoDB sanal çekirdek kümesi için Azure Cosmos DB oluşturma

  • Makale

ŞUNLAR IÇIN GEÇERLIDIR: MongoDB sanal çekirdeği

Bu hızlı başlangıçta MongoDB sanal çekirdek kümesi için yeni bir Azure Cosmos DB oluşturacaksınız. Bu küme tüm MongoDB kaynaklarınızı içerir: veritabanları, koleksiyonlar ve belgeler. Küme, Azure Cosmos DB'ye bağlanmak ve günlük işlemleri gerçekleştirmek için çeşitli araçlar ve SDK'lar için benzersiz bir uç nokta sağlar.

Önkoşullar

Bicep dosyasını gözden geçirme

Bu hızlı başlangıçta kullanılan Bicep dosyası Azure Hızlı Başlangıç Şablonları'ndan alınmıştı.

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

Not

Yukarıdaki kodda shardGroupSpecs öğesinin nodeGroupSpecs olarak adlandırıldığını unutmayın.

Bicep dosyasında iki Azure kaynağı tanımlanır:

Bicep dosyasını dağıtma

Bicep şablonunu kullanarak MongoDB için Azure Cosmos DB sanal çekirdek kümesi oluşturun.

  1. resourceGroupName ve konum için kabuk değişkenleri oluşturma

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

  2. Henüz yapmadıysanız komutunu kullanarak az login Azure CLI'da oturum açın.

  3. az group create Aboneliğinizde yeni bir kaynak grubu oluşturmak için komutunu kullanın.

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

  4. bicep şablonunu dağıtmak için kullanın az deployment group create . Ardından ve adminPassword parametreleri için adminUsername bir değer girmeniz istenir.

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

    İpucu

    Alternatif olarak, önceden tanımlanmış değerler içeren bir parametre dosyası geçirmek için seçeneğini kullanın --parameters .

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

    Bu örnek JSON dosyası clusteradmin sırasıyla ve parametreleri için adminUsername ekler ve P@ssw.rd adminPassword değerler ekler.

    {
  "$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. Devam etmeden önce dağıtım işleminin tamamlanmasını bekleyin.

Dağıtılan kaynakları gözden geçirme

Bicep şablonu tarafından hedef kaynak grubunuz için dağıtılan kaynakları listeleyin.

  1. Kaynak grubunuzdaki kaynakların listesini almak için kullanın az resource list .

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

  2. Örnek çıktıda türüne Microsoft.DocumentDB/mongoClusterssahip kaynakları arayın. Aşağıda bekleyebileceğiniz çıkış türüne bir örnek verilmiştir:

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

Kaynakları temizleme

MongoDB için Azure Cosmos DB sanal çekirdek kümenizle işiniz bittiğinde, daha fazla ücret ödemeden oluşturduğunuz Azure kaynaklarını silebilirsiniz.

  1. Kaynak grubunu aboneliğinizden kaldırmak için kullanın az group delete .

    az group delete \
    --name $resourceGroupName

Sonraki adım

Bu kılavuzda MongoDB sanal çekirdek kümesi için Azure Cosmos DB oluşturmayı öğrendiniz. Artık verileri kümenize geçirebilirsiniz.

MongoDB için Azure Cosmos DB sanal çekirdeğine veri geçirme