Bagikan melalui

Mulai cepat: Membuat kluster Azure Cosmos DB for MongoDB vCore dengan menggunakan templat Bicep

  • Artikel

BERLAKU UNTUK: MongoDB vCore

Dalam mulai cepat ini, Anda membuat kluster Azure Cosmos DB for MongoDB vCore baru. Kluster ini berisi semua sumber daya MongoDB Anda: database, koleksi, dan dokumen. Kluster ini menyediakan titik akhir unik untuk berbagai alat dan SDK untuk terhubung ke Azure Cosmos DB dan melakukan operasi sehari-hari.

Prasyarat

Tinjau file Bicep

File Bicep yang digunakan dalam mulai cepat berasal dari Templat Mulai Cepat Azure.

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

Catatan

Harap dicatat bahwa dalam kode di atas, shardGroupSpecs disebut nodeGroupSpecs.

Dua sumber daya Azure ditentukan dalam file Bicep:

Menerapkan file Bicep

Buat kluster Azure Cosmos DB for MongoDB vCore dengan menggunakan templat Bicep.

  1. Membuat variabel shell untuk resourceGroupName, dan lokasi

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

  2. Jika Anda belum melakukannya, masuk ke Azure CLI menggunakan perintah az login.

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

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

  4. Gunakan az deployment group create untuk menyebarkan templat bicep. Anda kemudian diminta untuk memasukkan nilai untuk adminUsername parameter dan adminPassword .

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

    Tip

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

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

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

  5. Tunggu hingga operasi penyebaran selesai sebelum melanjutkan.

Meninjau sumber daya yang disebarkan

Cantumkan sumber daya yang disebarkan oleh templat Bicep ke grup sumber daya target Anda.

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

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

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

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

Membersihkan sumber daya

Setelah selesai dengan kluster Azure Cosmos DB for MongoDB vCore, 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 $resourceGroupName

Langkah selanjutnya

Dalam panduan ini, Anda mempelajari cara membuat kluster Azure Cosmos DB for MongoDB vCore. Anda sekarang dapat memigrasikan data ke kluster Anda.

Memigrasikan data ke Azure Cosmos DB untuk MongoDB vCore