Aracılığıyla paylaş

Hızlı Başlangıç: Terraform kullanarak Azure DocumentDB kümesi dağıtma

Bu hızlı başlangıçta Terraform kullanarak yeni bir Azure DocumentDB kümesi dağıtacaksınız. Bu hızlı başlangıç, hızlı bir şekilde başlamanıza yardımcı olacak adım adım yönergeler sağlar. Bu küme tüm MongoDB kaynaklarınızı içerir: veritabanları, koleksiyonlar ve belgeler. Azure DocumentDB'ye bağlanmak ve işlemleri gerçekleştirmek için araçlar ve yazılım geliştirme setleri (SDK) için benzersiz bir uç nokta sağlar.

Önkoşullar

Ortamı yapılandırma

Aboneliğinizdeki Azure DocumentDB kaynaklarını yönetmek için Azure CLI ortamınızı ayarlayın.

  1. Boş bir klasörde başlayın.

  2. Azure CLI'da oturum açın.

    az login

  3. Hedef Azure aboneliğinizi denetleyin.

    az account show

    Uyarı

    Beklediğiniz aboneliğe bağlı değilseniz aboneliğinizi değiştirmek için şu komutu kullanın:

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

    Daha fazla bilgi için bkz. Azure CLI ile Azure aboneliklerini yönetme.

Terraform yapılandırmasını hazırlamak

Azure DocumentDB kümesini dağıtmak için gereken kaynakları tanımlamak için terraform dosyası oluşturun ve yapılandırın.

  1. Proje dizininizde yeni bir main.tf dosyası oluşturun.

  2. Bu yapılandırmayı dosyanın içeriğine ekleyin.

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

    Tip

    Kaynağı kullanma azurerm_mongo_cluster seçenekleri hakkında daha fazla bilgi için Terraform Registry'deki sağlayıcı belgelerine bakınazurerm.

Yapılandırmayı dağıt.

Önceki adımda oluşturulan yapılandırma dosyasını bir yürütme planı kullanarak dağıtın.

  1. Terraform CLI ile Terraform dağıtımını başlatın.

    terraform init --upgrade

  2. Bir yürütme planı oluşturun ve main.tfplan adlı bir dosyaya kaydedin. admin_username ve admin_password değişkenleri istendiğinde değerleri sağlayın.

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

    Uyarı

    Bu komut ortam değişkenini ARM_SUBSCRIPTION_ID geçici olarak ayarlar. Bu ayar, azurerm sağlayıcısı için sürüm 4.0'dan başlayarak gereklidir. Daha fazla bilgi için bkz. azurerm içindeki abonelik kimliği.

  3. Kaynakları Azure'a dağıtmak için yürütme planını uygulayın.

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

  4. Devam etmeden önce dağıtım işleminin tamamlanmasını bekleyin.

Dağıtılmış kaynakları gözden geçir.

Kaynak grubunuz için dağıtılan Azure DocumentDB kaynaklarını listeleyin.

  1. Kaynak grubunuzdaki kaynakların listesini almak için kullanın az resource list .

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

  2. Örnek çıktıda türüne Microsoft.DocumentDB/mongoClusterssahip kaynakları arayın. Aşağıda bekleyebileceğiniz çıkış türüne bir örnek verilmiştir:

    [
  "msdocs-documentdb-example-cluster"
]

Kaynakları temizle

Terraform yapılandırmanızda tanımlanan tüm kaynakları kaldırın.

  1. Terraform tarafından yönetilen kaynaklarınızı komutunu kullanarak yok edin destroy .

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

    Tip

    Alternatif olarak, kaynak grubunu aboneliğinizden kaldırmak için kullanın az group delete :

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

    Önemli

    Bu komut kalıcı olarak silindiğinden, bu komutu çalıştırmadan önce kaynaklara artık ihtiyacınız olmadığından emin olun.

  2. Silme işlemine devam etmek için ilgili istemleri onaylayın.

İlgili içerik

  • Last updated on