Bagikan melalui

Mulai cepat: Menyebarkan kluster Azure DocumentDB menggunakan Bicep

Dalam mulai cepat ini, Anda menyebarkan kluster Azure DocumentDB baru menggunakan Bicep. Panduan cepat ini menyediakan instruksi langkah demi langkah untuk membantu Anda memulai dengan cepat. Kluster ini berisi semua sumber daya MongoDB Anda: database, koleksi, dan dokumen. Ini menyediakan titik akhir unik untuk alat dan kit pengembangan perangkat lunak (SDK) untuk terhubung ke Azure DocumentDB dan melakukan operasi.

Prasyarat

  • Langganan Azure

    • Jika Anda tidak memiliki langganan Azure, buat akun gratis

Mengonfigurasi lingkungan

Siapkan lingkungan Azure CLI Anda untuk mengelola sumber daya Azure DocumentDB di langganan Anda.

  1. Mulai di direktori kosong.

  2. Masuk ke Azure CLI.

    az login

  3. Periksa langganan Azure Anda yang ditargetkan.

    az account show

    Nota

    Jika Anda tidak tersambung ke langganan yang Anda harapkan, gunakan perintah ini untuk mengubah langganan Anda:

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

    Untuk informasi selengkapnya, lihat mengelola langganan Azure dengan Azure CLI.

Menyiapkan templat Bicep

Buat dan konfigurasikan file Bicep untuk menentukan sumber daya yang diperlukan untuk menyebarkan kluster Azure DocumentDB.

  1. Buat file main.bicep baru di direktori proyek Anda.

  2. Tambahkan templat ini ke konten file.

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

    Petunjuk / Saran

    Untuk informasi selengkapnya tentang opsi menggunakan Microsoft.DocumentDB/mongoclusters sumber daya, lihat Microsoft.DocumentDB/mongoclusters dokumentasi.

Menyebarkan templat

Sebarkan templat yang dibuat di langkah sebelumnya menggunakan penyebaran Azure Resource Manager.

  1. az group create Gunakan perintah untuk membuat grup sumber daya baru di langganan Anda.

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

  2. Gunakan az deployment group create untuk menerapkan template Bicep. Anda kemudian diminta untuk memasukkan nilai untuk adminUsername parameter dan adminPassword .

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

    Petunjuk / Saran

    Atau, gunakan --parameters opsi untuk meneruskan file parameter dengan nilai yang telah ditentukan sebelumnya.

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

    Contoh file JSON ini menyuntikkan nilai clusteradmin dan P@ssw.rd masing-masing untuk parameter adminUsername dan 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"
    }
  }
}

  3. Tunggu hingga operasi penyebaran selesai sebelum melanjutkan.

Meninjau sumber daya yang disebarkan

Cantumkan sumber daya Azure DocumentDB yang disebarkan ke grup sumber daya Anda.

  1. Gunakan az resource list untuk mendapatkan daftar sumber daya di grup sumber daya Anda.

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

  2. Dalam contoh output, cari sumber daya yang memiliki jenis Microsoft.DocumentDB/mongoClusters. Berikut adalah contoh jenis output yang diharapkan:

    [
  "msdocs-documentdb-example-cluster"
]

Membersihkan sumber daya

Setelah selesai dengan kluster Azure DocumentDB, Anda dapat menghapus sumber daya Azure yang Anda buat sehingga Anda tidak dikenakan lebih banyak biaya.

  1. Gunakan az group delete untuk menghapus grup sumber daya dari langganan Anda.

    az group delete \
    --name "<resource-group-name>" \
    --yes \
    --no-wait

    Penting

    Pastikan Anda tidak lagi memerlukan sumber daya sebelum menjalankan perintah ini, karena menghapusnya secara permanen.

Konten terkait

  • Last updated on