التشغيل السريع: إنشاء Azure Cosmos DB لنظام مجموعة MongoDB vCore باستخدام قالب Bicep

مقالة
08/15/2024

ينطبق على: MongoDB vCore

في هذا التشغيل السريع، يمكنك إنشاء Azure Cosmos DB جديد لنظام مجموعة MongoDB vCore. تحتوي هذه المجموعة على جميع موارد MongoDB: قواعد البيانات والمجموعات والمستندات. يوفر نظام المجموعة نقطة نهاية فريدة لمختلف الأدوات وSDKs للاتصال ب Azure Cosmos DB وتنفيذ العمليات اليومية.

المتطلبات الأساسية

حساب Azure مع اشتراك نشط. أنشئ حساباً مجاناً.

مراجعة ملف Bicep

ملف Bicep المستخدم في هذا التشغيل السريع مأخوذ من قوالب التشغيل السريع لـ Azure.

@description('Azure Cosmos DB MongoDB vCore cluster name')
@maxLength(44)
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@2022-10-15-preview' = {
  name: clusterName
  location: location
  properties: {
    administratorLogin: adminUsername
    administratorLoginPassword: adminPassword
    nodeGroupSpecs: [
        {
            kind: 'Shard'
            shardCount: 1
            sku: 'M40'
            diskSizeGB: 128
            enableHa: false
        }
    ]
  }
}

resource firewallRules 'Microsoft.DocumentDB/mongoClusters/firewallRules@2022-10-15-preview' = {
  parent: cluster
  name: 'AllowAllAzureServices'
  properties: {
    startIpAddress: '0.0.0.0'
    endIpAddress: '0.0.0.0'
  }
}

إشعار

يرجى ملاحظة أنه في التعليمات البرمجية أعلاه، يسمى shardGroupSpecs nodeGroupSpecs.

تم تحديد موردين Azure في ملف Bicep:

Microsoft.DocumentDB/mongoclusters: ينشئ Azure Cosmos DB لنظام مجموعة MongoDB vCore.
- Microsoft.DocumentDB/mongoClusters/firewallRules: إنشاء قواعد جدار الحماية لنظام مجموعة Azure Cosmos DB لنظام مجموعة MongoDB vCore.

نشر ملف Bicep

إنشاء Azure Cosmos DB لنظام مجموعة MongoDB vCore باستخدام قالب Bicep.

Azure CLI
Azure PowerShell

إنشاء متغيرات shell ل resourceGroupName والموقع

# Variable for resource group name and location
resourceGroupName="msdocs-cosmos-quickstart-rg"
location="eastus"

إذا لم تكن قد قمت بتسجيل الدخول بالفعل، فسجل الدخول إلى Azure CLI باستخدام الأمر az login.
استخدم الأمر az group create لإنشاء مجموعة موارد جديدة في اشتراكك.
```
az group create \
    --name $resourceGroupName \
    --location $location
```

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

az deployment group create \
    --resource-group $resourceGroupName \
    --template-file 'main.bicep'

تلميح

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

az deployment group create \
    --resource-group $resourceGroupName \
    --template-file 'main.bicep' \
    --parameters @main.parameters.json

يقوم هذا المثال بإدخال clusteradmin P@ssw.rd ملف JSON وقيم المعلمات 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"
    }
  }
}

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

إنشاء متغيرات shell RESOURCE_GROUP_NAME و LOCATION

# Variable for resource group name and location
$RESOURCE_GROUP_NAME = "msdocs-cosmos-quickstart-rg"
$LOCATION = "East US"

إذا لم تكن سجّلت الدخول بالفعل، فسجّل الدخول إلى Azure PowerShell باستخدام الأمرConnect-AzAccount cmdlet.

استخدم New-AzResourceGroup cmdlet لإنشاء مجموعة موارد جديدة في اشتراكك.

$parameters = @{
    Name = $RESOURCE_GROUP_NAME
    Location = $LOCATION
}
New-AzResourceGroup @parameters

استخدم New-AzResourceGroupDeployment لنشر قالب bicep. ثم تتم مطالبتك بإدخال قيمة للمعلمات adminUsername و adminPassword .

$parameters = @{
    ResourceGroupName = $RESOURCE_GROUP_NAME
    TemplateFile = "main.bicep"
}
New-AzResourceGroupDeployment @parameters

تلميح

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

$parameters = @{
    ResourceGroupName = $RESOURCE_GROUP_NAME
    TemplateFile = "main.bicep"
    TemplateParameterFile = "main.parameters.json"
}
New-AzResourceGroupDeployment @parameters

يقوم هذا المثال بإدخال clusteradmin P@ssw.rd ملف JSON وقيم المعلمات 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"
    }
  }
}

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

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

سرد الموارد التي تم نشرها بواسطة قالب Bicep إلى مجموعة الموارد المستهدفة.

Azure CLI
Azure PowerShell

استخدم az resource list للحصول على قائمة بالموارد في مجموعة الموارد الخاصة بك.
```
az resource list \
    --resource-group $resourceGroupName \
    --location $location \
    --output tsv
```

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

Name                  ResourceGroup                Location    Type                                Status
--------------------  ---------------------------  ----------  ----------------------------------  --------
msdocs-sz2dac3xtwzzu  msdocs-cosmos-quickstart-rg  eastus      Microsoft.DocumentDB/mongoClusters

استخدم Get-AzResource للحصول على قائمة بالموارد في مجموعة الموارد الخاصة بك.
```
$parameters = @{
    ResourceGroupName = $RESOURCE_GROUP_NAME
}
Get-AzResource @parameters
```

Name              : msdocs-sz2dac3xtwzzu
ResourceGroupName : msdocs-cosmos-quickstart-rg
ResourceType      : Microsoft.DocumentDB/mongoClusters
Location          : eastus
ResourceId        : /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/msdocs-cosmos-quickstart-rg/providers/Microsoft.DocumentDB/mongoClusters/msdocs-sz2dac3xtwzzu
Tags              :

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

عند الانتهاء من Azure Cosmos DB لنظام مجموعة MongoDB vCore، يمكنك حذف موارد Azure التي أنشأتها حتى لا تتحمل المزيد من الرسوم.

Azure CLI
Azure PowerShell

استخدم az group delete لإزالة مجموعة الموارد من اشتراكك.
```
az group delete \
    --name $resourceGroupName
```

الخطوة التالية

في هذا الدليل، تعلمت كيفية إنشاء Azure Cosmos DB لنظام مجموعة MongoDB vCore. يمكنك الآن ترحيل البيانات إلى نظام المجموعة الخاص بك.

ترحيل البيانات إلى Azure Cosmos DB ل MongoDB vCore

مشاركة عبر