Aracılığıyla paylaş

Hızlı Başlangıç: Bicep kullanarak Azure DocumentDB kümesi dağıtma

Bu hızlı başlangıçta, Bicep kullanarak yeni bir Azure DocumentDB kümesi dağıtacaksınız. Bu hızlı başlangıç, hızlı bir şekilde başlamanıza yardımcı olacak adım adım yönergeler sağlar. Bu küme tüm MongoDB kaynaklarınızı içerir: veritabanları, koleksiyonlar ve belgeler. Azure DocumentDB'ye bağlanmak ve işlemleri gerçekleştirmek için araçlar ve yazılım geliştirme setleri (SDK) için benzersiz bir uç nokta sağlar.

Önkoşullar

Ortamı yapılandırma

Aboneliğinizdeki Azure DocumentDB kaynaklarını yönetmek için Azure CLI ortamınızı ayarlayın.

  1. Boş bir klasörde başlayın.

  2. Azure CLI'da oturum açın.

    az login

  3. Hedef Azure aboneliğinizi denetleyin.

    az account show

    Uyarı

    Beklediğiniz aboneliğe bağlı değilseniz aboneliğinizi değiştirmek için şu komutu kullanın:

    az account set --subscription "<subscription-name>"

    Daha fazla bilgi için bkz. Azure CLI ile Azure aboneliklerini yönetme.

Bicep şablonunu hazırlama

Azure DocumentDB kümesini dağıtmak için gereken kaynakları tanımlamak için bir Bicep dosyası oluşturun ve yapılandırın.

  1. Proje dizininizde yeni bir main.bicep dosyası oluşturun.

  2. Bu şablonu dosyanın içeriğine ekleyin.

    @description('Cluster name')
@minLength(8)
@maxLength(40)
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@2025-09-01' = {
  name: clusterName
  location: location
  properties: {
    administrator: {
      userName: adminUsername
      password: adminPassword
    }
    serverVersion: '8.0'
    sharding: {
      shardCount: 1
    }
    storage: {
      sizeGb: 32
    }
    highAvailability: {
      targetMode: 'Disabled'
    }
    compute: {
      tier: 'M10'
    }
  }
}

resource firewallRules 'Microsoft.DocumentDB/mongoClusters/firewallRules@2025-09-01' = {
  parent: cluster
  name: 'AllowAllAzureServices'
  properties: {
    startIpAddress: '0.0.0.0'
    endIpAddress: '0.0.0.0'
  }
}

    Tip

    Kaynağı kullanma Microsoft.DocumentDB/mongoclusters seçenekleri hakkında daha fazla bilgi için belgelere bakınMicrosoft.DocumentDB/mongoclusters.

Şablonu dağıt

Önceki adımda oluşturulan şablonu bir Azure Resource Manager dağıtımı kullanarak dağıtın.

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

    az group create \
    --name "<resource-group-name>" \
    --location "<location>"

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

    az deployment group create \
    --resource-group "<resource-group-name>" \
    --template-file 'main.bicep'

    Tip

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

    az deployment group create \
    --resource-group "<resource-group-name>" \
    --template-file 'main.bicep' \
    --parameters @main.parameters.json

    Bu örnek JSON dosyası, sırasıyla clusteradmin ve P@ssw.rd değerlerini adminUsername ve adminPassword parametrelerine enjekte eder.

    {
  "$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"
    }
  }
}

  3. Devam etmeden önce dağıtım işleminin tamamlanmasını bekleyin.

Dağıtılmış kaynakları gözden geçir.

Kaynak grubunuz için dağıtılan Azure DocumentDB kaynaklarını listeleyin.

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

    az resource list \
    --resource-group "<resource-group-name>" \
    --namespace "Microsoft.DocumentDB" \
    --resource-type "mongoClusters" \
    --query "[].name" \
    --output json

  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:

    [
  "msdocs-documentdb-example-cluster"
]

Kaynakları temizle

Azure DocumentDB 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 "<resource-group-name>" \
    --yes \
    --no-wait

    Önemli

    Bu komut kalıcı olarak silindiğinden, bu komutu çalıştırmadan önce kaynaklara artık ihtiyacınız olmadığından emin olun.

İlgili içerik

  • Last updated on