Sdílet prostřednictvím

Rychlý start: Nasazení clusteru Azure DocumentDB pomocí Bicep

V tomto rychlém startu nasadíte nový cluster Azure DocumentDB pomocí Bicep. Tento rychlý start obsahuje podrobné pokyny, které vám pomůžou rychle začít. Tento cluster obsahuje všechny prostředky MongoDB: databáze, kolekce a dokumenty. Poskytuje jedinečný koncový bod pro nástroje a sady SDK pro připojení k Azure DocumentDB a provádění operací.

Požadavky

  • Předplatné Azure

Konfigurace prostředí

Nastavte prostředí Azure CLI pro správu prostředků Azure DocumentDB ve vašem předplatném.

  1. Začněte v prázdném adresáři.

  2. Přihlaste se k Azure CLI.

    az login

  3. Zkontrolujte cílové předplatné Azure.

    az account show

    Poznámka:

    Pokud nejste připojení k očekávanému předplatnému, použijte tento příkaz ke změně předplatného:

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

    Další informace najdete v tématu správa předplatných Azure pomocí Azure CLI.

Příprava šablony Bicep

Vytvořte a nakonfigurujte soubor Bicep pro definování prostředků potřebných k nasazení clusteru Azure DocumentDB.

  1. V adresáři projektu vytvořte nový soubor main.bicep .

  2. Přidejte tuto šablonu do obsahu souboru.

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

    Návod

    Další informace o možnostech použití Microsoft.DocumentDB/mongoclusters prostředku najdete v Microsoft.DocumentDB/mongoclusters dokumentaci.

Nasazení šablony

Nasaďte šablonu vytvořenou v předchozím kroku pomocí nasazení Azure Resource Manageru.

  1. Pomocí příkazu az group create vytvořte v předplatném novou skupinu prostředků.

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

  2. Použijte az deployment group create k nasazení šablony Bicep. Pak se zobrazí výzva k zadání hodnoty pro parametry adminUsername a adminPassword.

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

    Návod

    Alternativně můžete použít --parameters možnost předání souboru parametrů s předdefinovanými hodnotami.

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

    Tento příklad souboru JSON vloží hodnoty clusteradmin a P@ssw.rd pro parametry adminUsername a adminPassword v tomto pořadí.

    {
  "$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. Počkejte, než se operace nasazení dokončí, a teprve pak pokračujte.

Kontrola nasazených prostředků

Vypište prostředky Azure DocumentDB nasazené do vaší skupiny prostředků.

  1. Použijte az resource list k získání seznamu prostředků ve vaší skupině prostředků.

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

  2. V příkladu výstupu vyhledejte prostředky, které mají typ Microsoft.DocumentDB/mongoClusters. Tady je příklad typu výstupu, který očekáváte:

    [
  "msdocs-documentdb-example-cluster"
]

Vyčistěte zdroje

Až budete s clusterem Azure DocumentDB hotovi, můžete odstranit vytvořené prostředky Azure, abyste nemuseli účtovat další poplatky.

  1. Pomocí az group delete odeberte skupinu prostředků z vašeho předplatného.

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

    Důležité

    Před spuštěním tohoto příkazu se ujistěte, že už prostředky nepotřebujete, protože je trvale odstraní.

Související obsah

  • Last updated on