Partager via

Démarrage rapide : créer un cluster vCore Azure Cosmos DB for MongoDB à l’aide d’un modèle Bicep

  • Article

S’APPLIQUE À : MongoDB vCore

Dans ce guide de démarrage rapide, vous créez un nouveau cluster Azure Cosmos DB for MongoDB vCore. Ce cluster contient toutes vos ressources MongoDB : bases de données, collections et documents. Le cluster fournit un point de terminaison unique à différents outils et kits de développement logiciel (SDK) pour se connecter à Azure Cosmos DB et effectuer des opérations quotidiennes.

Prérequis

Examiner le fichier Bicep

Le fichier Bicep utilisé dans ce guide de démarrage rapide est tiré des modèles de démarrage rapide 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'
  }
}

Remarque

Veuillez noter que dans le code ci-dessus, shardGroupSpecs est appelé nodeGroupSpecs.

Deux ressources Azure sont définies dans le fichier Bicep :

Déployer le fichier Bicep

Créer un cluster vCore Azure Cosmos DB for MongoDB à l’aide du modèle Bicep.

  1. Créez des variables d’interpréteur de commandes pour resourceGroupName et location

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

  2. Si vous ne l’avez pas déjà fait, connectez-vous à Azure CLI à l’aide de la commande az login.

  3. Utilisez la commande az group create pour créer un groupe de ressources dans votre abonnement.

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

  4. Utilisez az deployment group create pour déployer le modèle Bicep. Vous êtes ensuite invité à entrer une valeur pour les paramètres adminUsername et adminPassword.

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

    Conseil

    Vous pouvez également utiliser l’option --parameters pour passer un fichier de paramètres avec des valeurs prédéfinies.

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

    Cet exemple de fichier JSON injecte les valeurs clusteradmin et P@ssw.rd aux paramètres adminUsername et adminPassword respectivement.

    {
  "$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. Attendez que l’opération de déploiement soit terminée avant de continuer.

Vérifier les ressources déployées

Répertoriez les ressources déployées par le modèle Bicep sur votre groupe de ressources cible.

  1. Utilisez az resource list pour obtenir la liste des ressources de votre groupe de ressources.

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

  2. Dans l’exemple de sortie, recherchez les ressources de type Microsoft.DocumentDB/mongoClusters. Voici un exemple du type de sortie auquel vous pouvez vous attendre :

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

Nettoyer les ressources

Quand vous en avez terminé avec votre cluster vCore Azure Cosmos DB for MongoDB, vous pouvez supprimer les ressources Azure que vous avez créées afin d’éviter des frais supplémentaires.

  1. Utilisez az group delete pour supprimer le groupe de ressources de votre abonnement.

    az group delete \
    --name $resourceGroupName

Étape suivante

Dans ce guide, vous avez appris à créer un cluster Azure Cosmos DB for MongoDB vCore. Vous pouvez maintenant migrer des données vers votre cluster.

Migrer des données vers Azure Cosmos DB for MongoDB vCore