Bagikan melalui

Mulai cepat: Menyebarkan kluster Azure DocumentDB menggunakan Terraform

Dalam mulai cepat ini, Anda menyebarkan kluster Azure DocumentDB baru menggunakan Terraform. Panduan cepat ini menyediakan instruksi langkah demi langkah untuk membantu Anda memulai dengan cepat. Kluster ini berisi semua sumber daya MongoDB Anda: database, koleksi, dan dokumen. Ini menyediakan titik akhir unik untuk alat dan kit pengembangan perangkat lunak (SDK) untuk terhubung ke Azure DocumentDB dan melakukan operasi.

Prasyarat

  • Langganan Azure

    • Jika Anda tidak memiliki langganan Azure, buat akun gratis

Mengonfigurasi lingkungan

Siapkan lingkungan Azure CLI Anda untuk mengelola sumber daya Azure DocumentDB di langganan Anda.

  1. Mulai di direktori kosong.

  2. Masuk ke Azure CLI.

    az login

  3. Periksa langganan Azure Anda yang ditargetkan.

    az account show

    Nota

    Jika Anda tidak tersambung ke langganan yang Anda harapkan, gunakan perintah ini untuk mengubah langganan Anda:

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

    Untuk informasi selengkapnya, lihat mengelola langganan Azure dengan Azure CLI.

Menyiapkan konfigurasi Terraform

Buat dan konfigurasikan file Terraform untuk menentukan sumber daya yang diperlukan untuk menyebarkan kluster Azure DocumentDB.

  1. Buat file main.tf baru di direktori proyek Anda.

  2. Tambahkan konfigurasi ini ke konten file.

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

    Petunjuk / Saran

    Untuk informasi selengkapnya tentang opsi menggunakan azurerm_mongo_cluster sumber daya, lihat azurerm dokumentasi penyedia di Terraform Registry.

Mengimplementasikan konfigurasi

Sebarkan file konfigurasi yang dibuat pada langkah sebelumnya menggunakan rencana eksekusi.

  1. Inisialisasi penyebaran Terraform dengan Terraform CLI.

    terraform init --upgrade

  2. Buat rencana eksekusi, dan simpan ke file bernama main.tfplan. Berikan nilai saat diminta untuk admin_username variabel dan admin_password .

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

    Nota

    Perintah ini mengatur ARM_SUBSCRIPTION_ID variabel lingkungan untuk sementara. Pengaturan ini diperlukan untuk penyedia azurerm yang dimulai dengan versi 4.0. Untuk informasi selengkapnya, lihat ID langganan di azurerm.

  3. Terapkan rencana eksekusi untuk menyebarkan sumber daya ke Azure.

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

  4. Tunggu hingga operasi penyebaran selesai sebelum melanjutkan.

Meninjau sumber daya yang disebarkan

Cantumkan sumber daya Azure DocumentDB yang disebarkan ke grup sumber daya Anda.

  1. Gunakan az resource list untuk mendapatkan daftar sumber daya di grup sumber daya Anda.

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

  2. Dalam contoh output, cari sumber daya yang memiliki jenis Microsoft.DocumentDB/mongoClusters. Berikut adalah contoh jenis output yang diharapkan:

    [
  "msdocs-documentdb-example-cluster"
]

Membersihkan sumber daya

Hapus semua sumber daya yang ditentukan dalam konfigurasi Terraform Anda.

  1. Hancurkan sumber daya Anda yang dikelola oleh Terraform menggunakan destroy perintah .

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

    Petunjuk / Saran

    Atau, gunakan az group delete untuk menghapus grup sumber daya dari langganan Anda:

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

    Penting

    Pastikan Anda tidak lagi memerlukan sumber daya sebelum menjalankan perintah ini, karena menghapusnya secara permanen.

  2. Konfirmasikan setiap permintaan yang relevan untuk melanjutkan penghapusan.

Konten terkait

  • Last updated on