Partager via

Démarrage rapide : Déployer un cluster Azure DocumentDB à l’aide de Terraform

Dans ce guide de démarrage rapide, vous déployez un nouveau cluster Azure DocumentDB à l’aide de Terraform. Ce guide de démarrage rapide fournit des instructions pas à pas pour vous aider à commencer rapidement. Ce cluster contient toutes vos ressources MongoDB : bases de données, collections et documents. Il fournit un point de terminaison unique pour les outils et les kits de développement logiciel (SDK) pour se connecter à Azure DocumentDB et effectuer des opérations.

Prerequisites

  • Un abonnement Azure

Configurer l’environnement

Configurez votre environnement Azure CLI pour gérer les ressources Azure DocumentDB dans votre abonnement.

  1. Démarrez dans un répertoire vide.

  2. Connectez-vous à Azure CLI.

    az login

  3. Vérifiez votre abonnement Azure cible.

    az account show

    Note

    Si vous n’êtes pas connecté à l’abonnement attendu, utilisez cette commande pour modifier votre abonnement :

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

    Pour plus d’informations, consultez gérer les abonnements Azure avec Azure CLI.

Préparer la configuration Terraform

Créez et configurez un fichier Terraform pour définir les ressources nécessaires au déploiement d’un cluster Azure DocumentDB.

  1. Créez un fichier main.tf dans le répertoire de votre projet.

  2. Ajoutez cette configuration au contenu du fichier.

    variable "admin_username" {
  type = string
  description = "Username for default administrator account"
}

variable "admin_password" {
  type = string
  description = "Password for default administrator account"
  sensitive = true
}

terraform {
  required_providers {
    azurerm = {
      source = "hashicorp/azurerm"
      version = "~> 4.0"
    }
  }
}

provider "azurerm" {
  features { }
}

resource "azurerm_resource_group" "resource_group" {
  name     = "example-resource-group"
  location = "West US"
}

resource "azurerm_mongo_cluster" "cluster" {
  name                   = "example-mongo-cluster"
  resource_group_name    = azurerm_resource_group.resource_group.name
  location               = azurerm_resource_group.resource_group.location
  administrator_username = var.admin_username
  administrator_password = var.admin_password
  shard_count            = "1"
  compute_tier           = "M10"
  high_availability_mode = "Disabled"
  storage_size_in_gb     = "32"
  version                = "8.0"
}

    Conseil / Astuce

    Pour plus d’informations sur les options à l’aide de la azurerm_mongo_cluster ressource, consultez azurerm la documentation du fournisseur dans Terraform Registry.

Déployer la configuration

Déployez le fichier de configuration créé à l’étape précédente à l’aide d’un plan d’exécution.

  1. Initialisez le déploiement Terraform avec Terraform CLI.

    terraform init --upgrade

  2. Créez un plan d’exécution et enregistrez-le dans un fichier nommé main.tfplan. Fournissez des valeurs lorsque vous êtes invité pour les variables admin_username et admin_password.

    ARM_SUBSCRIPTION_ID=$(az account show --query id --output tsv) terraform plan --out "main.tfplan"

    Note

    Cette commande définit temporairement la variable d’environnement ARM_SUBSCRIPTION_ID . Ce paramètre est requis pour le fournisseur azurerm à partir de la version 4.0. Pour plus d'informations, consultez l'identifiant d'abonnement dans azurerm.

  3. Appliquez le plan d’exécution pour déployer des ressources sur Azure.

    ARM_SUBSCRIPTION_ID=$(az account show --query id --output tsv) terraform apply "main.tfplan"

  4. Attendez que l’opération de déploiement se termine avant de passer à l’opération.

Passer en revue les ressources déployées

Répertoriez les ressources Azure DocumentDB déployées sur votre groupe de ressources.

  1. Permet az resource list d’obtenir la liste des ressources de votre groupe de ressources.

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

  2. Dans l’exemple de sortie, recherchez les ressources qui ont un type de Microsoft.DocumentDB/mongoClusters. Voici un exemple de type de sortie à attendre :

    [
  "msdocs-documentdb-example-cluster"
]

Nettoyer les ressources

Supprimez toutes les ressources définies dans votre configuration Terraform.

  1. Détruisez vos ressources gérées par Terraform à l’aide de la destroy commande.

    ARM_SUBSCRIPTION_ID=$(az account show --query id --output tsv) terraform destroy

    Conseil / Astuce

    Vous pouvez également utiliser cette option az group delete pour supprimer le groupe de ressources de votre abonnement :

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

    Important

    Vérifiez que vous n’avez plus besoin des ressources avant d’exécuter cette commande, car elle les supprime définitivement.

  2. Confirmez les invites pertinentes pour procéder à la suppression.

Contenu connexe

  • Last updated on