مشاركة عبر

Quickstart: نشر عنقود Azure DocumentDB باستخدام Terraform

في هذا البدء السريع، تقوم بنشر مجموعة جديدة من Azure DocumentDB باستخدام Terraform. يوفر هذا البدء السريع تعليمات خطوة بخطوة لمساعدتك على البدء بسرعة. تحتوي هذه المجموعة على جميع موارد MongoDB الخاصة بك: قواعد البيانات، المجموعات، والوثائق. يوفر نقطة نهاية فريدة للأدوات ومجموعات تطوير البرمجيات (SDKs) للاتصال ب Azure DocumentDB وأداء العمليات.

Prerequisites

  • اشتراك Azure

تكوين البيئة

قم بإعداد بيئة Azure CLI الخاصة بك لإدارة موارد Azure DocumentDB في اشتراكك.

  1. ابدأ في دليل فارغ.

  2. تسجيل الدخول إلى Azure CLI.

    az login

  3. تحقق من اشتراكك المستهدف في Azure.

    az account show

    إشعار

    إذا لم تكن متصلا بالاشتراك الذي توقعته، استخدم هذا الأمر لتغيير اشتراكك:

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

    لمزيد من المعلومات، راجع إدارة اشتراكات Azure باستخدام Azure CLI.

تحضير تكوين التيرافورم

إنشاء وتكوين ملف Terraform لتعريف الموارد المطلوبة لنشر عنقود Azure DocumentDB.

  1. أنشئ ملف main.tf جديد في مجلد مشروعك.

  2. أضف هذا التكوين إلى محتوى الملف.

    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

    لمزيد من المعلومات حول الخيارات التي تستخدم المورد azurerm_mongo_cluster ، راجع azurerm وثائق المزود في سجل تيرافورم.

نشر التكوين

نشر ملف التكوين الذي تم إنشاؤه في الخطوة السابقة باستخدام خطة تنفيذ.

  1. قم بتهيئة نشر Terraform باستخدام Terraform CLI.

    terraform init --upgrade

  2. أنشئ خطة تنفيذ، واحفظها في ملف باسم main.tfplan. قدم القيم عند الطلب على المتغيرات admin_usernameadmin_password .

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

    إشعار

    هذا الأمر يضبط متغير ARM_SUBSCRIPTION_ID البيئة مؤقتا. هذا الإعداد مطلوب للمزود azurerm بدءا من الإصدار 4.0. لمزيد من المعلومات، راجع معرف الاشتراك في azurerm.

  3. طبق خطة التنفيذ لنشر الموارد على Azure.

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

  4. انتظر حتى تكتمل عملية النشر قبل الانتقال.

مراجعة الموارد الموزعة

قم بإدراج موارد Azure DocumentDB التي تم نشرها في مجموعة الموارد الخاصة بك.

  1. استخدمها az resource list للحصول على قائمة بالموارد في مجموعة الموارد الخاصة بك.

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

  2. في المخرجات المثالية، ابحث عن الموارد التي تحتوي على نوع من Microsoft.DocumentDB/mongoClusters. إليك مثالا على نوع الناتج المتوقع:

    [
  "msdocs-documentdb-example-cluster"
]

تنظيف الموارد

قم بإزالة جميع الموارد المعرفة في تكوين Terraform الخاص بك.

  1. دمر مواردك التي يديرها تيرافورم باستخدام destroy الأمر.

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

    Tip

    بدلا من ذلك، استخدم az group delete لإزالة مجموعة الموارد من اشتراكك:

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

    Important

    تأكد من أنك لم تعد بحاجة إلى الموارد قبل تشغيل هذا الأمر، لأنه يحذفها بشكل دائم.

  2. أكد أي تعليمات ذات صلة للمضي قدما في الحذف.

محتوى ذو صلة

  • Last updated on