مشاركة عبر

Quickstart: نشر مجموعة Azure DocumentDB باستخدام Bicep

في هذا البدء السريع، تقوم بنشر مجموعة جديدة من Azure DocumentDB باستخدام Bicep. يوفر هذا البدء السريع تعليمات خطوة بخطوة لمساعدتك على البدء بسرعة. تحتوي هذه المجموعة على جميع موارد 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.

جهز قالب العضلة ذات الرأسين

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

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

  2. أضف هذا القالب إلى محتوى الملف.

    @description('Cluster name')
@minLength(8)
@maxLength(40)
param clusterName string = 'msdocs-${uniqueString(resourceGroup().id)}'

@description('Location for the cluster.')
param location string = resourceGroup().location

@description('Username for admin user')
param adminUsername string

@secure()
@description('Password for admin user')
@minLength(8)
@maxLength(128)
param adminPassword string

resource cluster 'Microsoft.DocumentDB/mongoClusters@2025-09-01' = {
  name: clusterName
  location: location
  properties: {
    administrator: {
      userName: adminUsername
      password: adminPassword
    }
    serverVersion: '8.0'
    sharding: {
      shardCount: 1
    }
    storage: {
      sizeGb: 32
    }
    highAvailability: {
      targetMode: 'Disabled'
    }
    compute: {
      tier: 'M10'
    }
  }
}

resource firewallRules 'Microsoft.DocumentDB/mongoClusters/firewallRules@2025-09-01' = {
  parent: cluster
  name: 'AllowAllAzureServices'
  properties: {
    startIpAddress: '0.0.0.0'
    endIpAddress: '0.0.0.0'
  }
}

    Tip

    لمزيد من المعلومات حول الخيارات التي تستخدم الموردMicrosoft.DocumentDB/mongoclusters، راجع Microsoft.DocumentDB/mongoclusters التوثيق.

نشر القالب

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

  1. استخدم الأمر az group create لإنشاء مجموعة موارد جديدة في اشتراكك.

    az group create \
    --name "<resource-group-name>" \
    --location "<location>"

  2. استخدم az deployment group create لنشر قالب العضلة ذات الرأسين. ثم يطلب منك إدخال قيمة ل adminUsername و adminPassword المعلمات.

    az deployment group create \
    --resource-group "<resource-group-name>" \
    --template-file 'main.bicep'

    Tip

    بدلا من ذلك، استخدم الخيار --parameters لتمرير ملف معلمات بقيم محددة مسبقا.

    az deployment group create \
    --resource-group "<resource-group-name>" \
    --template-file 'main.bicep' \
    --parameters @main.parameters.json

    هذا المثال يضخ clusteradmin الملف JSON وقيم P@ssw.rd المعاملات adminUsername و adminPassword على التوالي.

    {
  "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "adminUsername": {
      "value": "clusteradmin"
    },
    "adminPassword": {
      "value": "P@ssw.rd"
    }
  }
}

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

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

قم بإدراج موارد 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"
]

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

عندما تنتهي من مجموعة Azure DocumentDB، يمكنك حذف الموارد التي أنشأتها في Azure حتى لا تتحمل المزيد من الرسوم.

  1. استخدم az group delete لإزالة مجموعة الموارد من اشتراكك.

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

    Important

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

محتوى ذو صلة

  • Last updated on