Dela via

Snabbstart: Distribuera ett Azure DocumentDB-kluster med Terraform

I den här snabbstarten distribuerar du ett nytt Azure DocumentDB-kluster med Terraform. Den här snabbstarten innehåller stegvisa instruktioner som hjälper dig att komma igång snabbt. Det här klustret innehåller alla dina MongoDB-resurser: databaser, samlingar och dokument. Den ger en unik slutpunkt för verktyg och programutvecklingspaket (SDK:er) för att ansluta till Azure DocumentDB och utföra åtgärder.

Förutsättningar

  • En prenumeration på Azure

Konfigurera miljö

Konfigurera Din Azure CLI-miljö för att hantera Azure DocumentDB-resurser i din prenumeration.

  1. Börja i en tom katalog.

  2. Logga in på Azure CLI.

    az login

  3. Kontrollera din Azure-målprenumeration.

    az account show

    Anmärkning

    Om du inte är ansluten till den prenumeration du förväntade dig använder du det här kommandot för att ändra din prenumeration:

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

    Mer information finns i Hantera Azure-prenumerationer med Azure CLI.

Förbereda Terraform-konfigurationen

Skapa och konfigurera en Terraform-fil för att definiera de resurser som krävs för att distribuera ett Azure DocumentDB-kluster.

  1. Skapa en ny main.tf fil i projektkatalogen.

  2. Lägg till den här konfigurationen i filens innehåll.

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

    Tips/Råd

    Mer information om alternativ med hjälp av resursen azurerm_mongo_clusterazurerm finns i providerdokumentationen i Terraform Registry.

Distribuera konfigurationen

Distribuera konfigurationsfilen som skapades i föregående steg med hjälp av en implementeringsplan.

  1. Initiera Terraform-distributionen med Terraform CLI.

    terraform init --upgrade

  2. Skapa en körningsplan och spara den i en fil med namnet main.tfplan. Ange värden när du uppmanas att ange variablerna admin_username och admin_password .

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

    Anmärkning

    Det här kommandot ställer in ARM_SUBSCRIPTION_ID miljövariabeln tillfälligt. Denna inställning behövs för att azurerm-leverantören ska fungera från version 4.0. Mer information finns i prenumerations-ID i azurerm.

  3. Tillämpa körningsplanen för att distribuera resurser till Azure.

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

  4. Vänta tills distributionsåtgärden har slutförts innan du går vidare.

Granska distribuerade resurser

Visa en lista över De Azure DocumentDB-resurser som har distribuerats till resursgruppen.

  1. Använd az resource list för att hämta en lista över resurser i resursgruppen.

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

  2. I exempelutdata letar du efter resurser som har en typ av Microsoft.DocumentDB/mongoClusters. Här är ett exempel på vilken typ av utdata du kan förvänta dig:

    [
  "msdocs-documentdb-example-cluster"
]

Rensa resurser

Ta bort alla resurser som definierats i Terraform-konfigurationen.

  1. Förstör dina resurser som hanteras av Terraform med kommandot destroy .

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

    Tips/Råd

    Du kan också använda az group delete för att ta bort resursgruppen från din prenumeration:

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

    Viktigt!

    Se till att du inte längre behöver resurserna innan du kör det här kommandot eftersom de tas bort permanent.

  2. Bekräfta eventuella relevanta uppmaningar om att fortsätta med borttagningen.

Relaterat innehåll

  • Last updated on