البرنامج التعليمي: الاستفادة من مرجع قالب إيه آر إم

تعرَّف على كيفية العثور على معلومات مخطط القالب، واستخدم المعلومات لإنشاء قوالب "Azure Resource Manager" (قوالب إيه آر إم).

في هذا البرنامج التعليمي، يمكنك استخدام قالب أساسي من قوالب "Azure Quickstart". باستخدام التوثيق المرجعي للقالب؛ يمكنك التحقق من صحة القالب.

يغطي هذا البرنامج التعليمي المهام التالية:

• فتح قالب بدء بداية سريعة
• فهم القالب
• العثور على مرجع القالب
• تحرير القالب
• نشر القالب

إذا لم يكن لديك اشتراك في Azure، فأنشئ free account قبل البدء.

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

لإكمال هذه المقالة، تحتاج إلى الآتي:

• "Visual Studio Code" إلى جانب ملحق "Resource Manager Tools". راجع بدء بداية سريعة: إنشاء قوالب ARM باستخدام Visual Studio Code.

فتح قالب بدء بداية سريعة

قوالب Azure Quickstart هي مستودع لقوالب ARM. بدلاً من إنشاء قالب من البداية، يمكنك العثور على نموذج قالب وتخصيصه. يطلق على القالب المستخدَم في بدء بداية سريعة هذا إنشاء حساب تخزين قياسي. يحدد القالب مورد حساب Azure Storage.

1. في "Visual Studio Code"، حدِّد "File">"Open File" .

2. في اسم الملف، أَلصِق عنوان URL الآتي:

   https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.storage/storage-account-create/azuredeploy.json
   

3. حدد "Open" لفتح الملف.

4. حدِّد "File">"Save As" لحفظ نسخة من الملف باسم azuredeploy.json على جهاز الكمبيوتر المحلي الخاص بك.

فهم المخطط

1. من "Visual Studio Code"، قم بطي القالب إلى مستوى الجذر. لديك أبسط هيكل يحتوي على العناصر التالية:

   

   • $schema:حدِّد موقع ملف مخطط JSON الذي يصف إصدار لغة القالب.
   • contentVersion:حدِّد أي قيمة لهذا العنصر لتوثيق التغييرات الهامة في قالبك.
   • metadata: حدد بيانات التعريف للقالب.
   • parameters:حدِّد القيم التي يتم توفيرها عند تنفيذ النشر لتخصيص نشر الموارد.
   • variables:حدِّد القيم التي تُستخدم كأجزاء JSON في القالب لتبسيط تعبيرات لغة القالب. هذا القالب لا يحتوي على هذا العنصر.
   • resources:حدِّد أنواع الموارد التي يتم نشرها أو تحديثها في مجموعة موارد.
   • outputs:حدِّد القيم التي يتم إرجاعها بعد النشر.

2. قم بتوسيع resources. يوجد مورد Microsoft.Storage/storageAccounts محدَّد. إصدار واجهة برمجة التطبيقات الموضح على لقطة الشاشة هو 2022-09-01. يستخدم اسم إس كي يو قيمة معلمة. المعلمة اسمها storageAccountType.

   

3. قم بتوسيع parameters لمشاهدة كيفية تحديد storageAccountType. المعلمة لها ثمانية قيم مسموح بها.

باستخدام مرجع القالب؛ يمكنك معرفة ما إذا كنت تستخدم أحدث إصدار من واجهة برمجة التطبيقات، وما إذا كان تعريف المعلمة يتضمن جميع القيم المسموح بها.

العثور على مرجع القالب

1. استعرض للوصول إلى مرجع قالب Azure.

2. في المربع تصفية حسب العنوان، أدخل حسابات التخزين، وحدد حسابات التخزين الأولى ضمن المرجع >التخزين.

   

3. حدد قالب ARM.

4. عادة ما يحتوي نوع المورد على العديد من إصدارات API. تعرض هذه الصفحة أحدث إصدار لمخطط القالب افتراضياً. حدد مربع القائمة المنسدلة Latest لمشاهدة الإصدارات. أحدث إصدار يظهر على لقطة الشاشة هو 2022-09-01. حدد إما Latest أو الإصدار مباشرة أسفل Latest لمشاهدة أحدث إصدار. تأكَّد من مطابقة هذا الإصدار للإصدار المستخدم لمورد حساب التخزين في قالبك. إذا قمت بتحديث إصدار إيه بي آي، فتحقَّق من مطابقة تعريف المورد مع مرجع القالب.

   

5. تسرد هذه الصفحة تفاصيل نوع مورد "storageAccount". على سبيل المثال، يسرد القيم المسموح بها لكائن Sku. هناك ثمانية وحدات SKU، وهي تتطابق مع تلك المدرجة في قالب البدء السريع الذي فتحته سابقاً.

   

نشر القالب

1. سجل الدخول إلى Azure Cloud Shell

2. يمكنك اختيار بيئتك المفضلة عن طريق تحديد PowerShell أو Bash (لـ CLI) في الزاوية العلوية اليسرى. يلزم إعادة تشغيل Shell عند التبديل.

   

3. حدد Upload/download files، ثم حدد Upload. راجع لقطة الشاشة السابقة. حدد الملف الذي قمت بحفظه في القسم السابق. بعد تحميل الملف، يمكنك استخدام الأمر ls والأمر cat للتحقق من تحميل الملف بنجاح.

4. من Cloud Shell، قم بإجراء الأوامر الآتية. حدد علامة التبويب لعرض رمز "PowerShell" أو رمز سي إل آي.

   عندما تقوم بنشر القالب، حدِّد المعلمة storageAccountType التي تحتوي على قيمة مضافة حديثاً، على سبيل المثال، "Standard_RAGRS" . ستفشل عملية النشر إذا استخدمت قالب بداية سريعة الأصلي حيث إن "Standard_RAGRS" لم تكن قيمة مسموحاً بها.

   CLI

   echo "Enter a project name that is used to generate resource group name:" &&
   read projectName &&
   echo "Enter the location (i.e. centralus):" &&
   read location &&
   resourceGroupName="${projectName}rg" &&
   az group create --name $resourceGroupName --location "$location" &&
   az deployment group create --resource-group $resourceGroupName --template-file "$HOME/azuredeploy.json" --parameters storageAccountType='Standard_RAGRS'
   

   PowerShell

   $projectName = Read-Host -Prompt "Enter a project name that is used to generate resource group name"
   $location = Read-Host -Prompt "Enter the location (i.e. centralus)"
   $resourceGroupName = "${projectName}rg"
   
   New-AzResourceGroup -Name $resourceGroupName -Location "$location"
   New-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName -TemplateFile "$HOME/azuredeploy.json" -storageAccountType "Standard_RAGRS"
   

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

عندما لا تكون موارد Azure مطلوبة، قم بتنظيف الموارد التي قمت بنشرها عن طريق حذف مجموعة الموارد.

1. من مدخل Azure، حدد مجموعة الموارد من القائمة اليمنى.
2. أدخل اسم مجموعة الموارد في الحقل Filter by name.
3. حدد اسم مجموعة الموارد. وسترى إجمالي ستة موارد في مجموعة الموارد.
4. حدد Delete resource group من القائمة.

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

تعلمت في هذا البرنامج التعليمي كيفية استخدام مرجع القالب لتخصيص قالب موجود. لمعرفة كيفية إنشاء مثيلات حساب تخزين متعددة، اطلع على ما يأتي:

إنشاء مثيلات متعددة