Megosztás:

Rövid útmutató: Azure DocumentDB-fürt üzembe helyezése a Bicep használatával

Ebben a gyorsútmutatóban egy új Azure DocumentDB-fürtöt helyez üzembe a Bicep eszközzel. Ez a rövid útmutató részletes útmutatást nyújt a gyors kezdéshez. Ez a fürt az összes MongoDB-erőforrást tartalmazza: adatbázisokat, gyűjteményeket és dokumentumokat. Egyedi végpontot biztosít az Eszközök és szoftverfejlesztői készletek (SDK-k) számára az Azure DocumentDB-hez való csatlakozáshoz és a műveletek végrehajtásához.

Előfeltételek

  • Azure-előfizetés

Környezet konfigurálása

Állítsa be az Azure CLI-környezetet az Azure DocumentDB-erőforrások előfizetésben való kezeléséhez.

  1. Kezdje egy üres mappában.

  2. Jelentkezzen be az Azure CLI-be.

    az login

  3. Ellenőrizze az Azure előfizetését, amelyre céloz.

    az account show

    Megjegyzés:

    Ha nem csatlakozik a várt előfizetéshez, használja ezt a parancsot az előfizetés módosításához:

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

    További információ: Azure-előfizetések kezelése az Azure CLI-vel.

A Bicep-sablon előkészítése

Hozzon létre és konfiguráljon egy Bicep-fájlt az Azure DocumentDB-fürt üzembe helyezéséhez szükséges erőforrások meghatározásához.

  1. Hozzon létre egy új main.bicep-fájlt a projektkönyvtárban.

  2. Adja hozzá ezt a sablont a fájl tartalmához.

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

    Jótanács

    Az erőforrást használó lehetőségekről további információt a Microsoft.DocumentDB/mongoclustersdokumentációban találMicrosoft.DocumentDB/mongoclusters.

A sablon üzembe helyezése

Helyezze üzembe az előző lépésben létrehozott sablont egy Azure Resource Manager-üzembe helyezéssel.

  1. az group create A paranccsal hozzon létre egy új erőforráscsoportot az előfizetésben.

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

  2. A bicep-sablon üzembe helyezésére használható az deployment group create . Ezután a rendszer kéri, hogy adjon meg egy értéket a adminUsername és adminPassword paraméterekhez.

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

    Jótanács

    Azt is megteheti, hogy a --parameters opciót használva előre definiált értékeket tartalmazó paraméterfájlt ad meg.

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

    Ez a példa JSON-fájl injektálja a clusteradmin és P@ssw.rd értékeket a adminUsername és adminPassword paraméterekhez.

    {
  "$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. Mielőtt továbblépne, várja meg, amíg az üzembe helyezési művelet befejeződik.

Üzembe helyezett erőforrások áttekintése

Listázhatja az erőforráscsoportban üzembe helyezett Azure DocumentDB-erőforrásokat.

  1. Az erőforráscsoport erőforrásainak listájának lekérésére használható az resource list .

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

  2. A példakimenetben keresse meg azokat az erőforrásokat, amelyek típusa Microsoft.DocumentDB/mongoClusters. Íme egy példa a várható kimenet típusára:

    [
  "msdocs-documentdb-example-cluster"
]

Erőforrások tisztítása

Miután végzett az Azure DocumentDB-fürttel, törölheti az Azure-erőforrásokat, amelyeket létrehozott, hogy elkerülje a további költségeket.

  1. Használja a az group delete-t az erőforráscsoport eltávolításához az előfizetésből.

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

    Fontos

    Győződjön meg arról, hogy a parancs futtatása előtt már nincs szüksége az erőforrásokra, mivel az véglegesen törli őket.

Kapcsolódó tartalom

  • Last updated on