Megosztás:

Rövid útmutató: Azure DocumentDB-klaszter telepítése a Terraform használatával

Ebben a gyorsútmutatóban egy új Azure DocumentDB-fürtöt helyez üzembe a Terraform használatával. 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 Terraform-konfiguráció előkészítése

Hozzon létre és konfiguráljon egy Terraform-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.tf fájlt a projektkönyvtárban.

  2. Adja hozzá ezt a konfigurációt a fájl tartalmához.

    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"
}

    Jótanács

    Az erőforrást használó lehetőségekről további információt a azurerm_mongo_clusterTerraform Registry szolgáltatói dokumentációjában találazurerm.

A konfiguráció üzembe helyezése

Telepítse az előző lépésben létrehozott konfigurációs fájlt egy végrehajtási terv használatával.

  1. A Terraform üzembe helyezésének inicializálása a Terraform parancssori felületével.

    terraform init --upgrade

  2. Hozzon létre egy végrehajtási tervet, és mentse egy main.tfplan nevű fájlba. Adja meg az értékeket, amikor a rendszer kéri a admin_username és admin_password változókat.

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

    Megjegyzés:

    Ez a parancs ideiglenesen beállítja a ARM_SUBSCRIPTION_ID környezeti változót. Ez a beállítás a azurerm 4.0-s verziótól kezdődő szolgáltatóhoz szükséges. További információt az előfizetés azonosítójában azurermtalál.

  3. Alkalmazza a végrehajtási tervet az erőforrások Azure-ban való üzembe helyezéséhez.

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

  4. 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

Távolítsa el a Terraform-konfigurációban definiált összes erőforrást.

  1. A Terraform által felügyelt erőforrások megsemmisítése a destroy paranccsal.

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

    Jótanács

    Egy másik lehetőségként, használja a az group delete-t, hogy eltávolítsa az erőforráscsoportot az előfizetésébő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.

  2. Erősítse meg a törlés folytatására vonatkozó kéréseket.

Kapcsolódó tartalom

  • Last updated on