Sdílet prostřednictvím

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

V tomto rychlém startu nasadíte nový cluster Azure DocumentDB pomocí Terraformu. 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 konfigurace Terraformu

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

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

  2. Přidejte tuto konfiguraci do obsahu souboru.

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

    Návod

    Další informace o možnostech použití azurerm_mongo_cluster prostředku najdete azurerm v dokumentaci zprostředkovatele v Terraform Registry.

Nasazení konfigurace

Pomocí plánu provádění nasaďte konfigurační soubor vytvořený v předchozím kroku.

  1. Inicializujte nasazení Terraformu pomocí Terraform CLI.

    terraform init --upgrade

  2. Vytvořte plán provádění a uložte ho do souboru s názvem main.tfplan. Zadejte hodnoty při zobrazení výzvy k zadání admin_usernameadmin_password proměnných.

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

    Poznámka:

    Tento příkaz dočasně nastaví proměnnou ARM_SUBSCRIPTION_ID prostředí. Toto nastavení je vyžadováno pro azurerm poskytovatele počínaje verzí 4.0. Další informace najdete v tématu ID předplatného v azurermsouboru.

  3. Použijte plán provádění pro nasazení prostředků do Azure.

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

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

Odeberte všechny prostředky definované v konfiguraci Terraformu.

  1. Pomocí příkazu zničíte prostředky spravované Terraformem destroy .

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

    Návod

    Případně můžete použít az group delete k odebrání skupiny prostředků z 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í.

  2. Potvrďte všechny relevantní výzvy k pokračování v odstranění.

Související obsah

  • Last updated on