مشاركة عبر

البرنامج التعليمي: إضافة مورد إلى قالب ARM الخاص بك

  • مقالة

في البرنامج التعليمي السابق، تعلمت كيفية إنشاء قالب إدارة موارد Azure فارغ (قالب ARM) ونشره. أنت الآن جاهز لنشر مورد فعلي لهذا القالب. في هذه الحالة، حساب تخزين Azure. تستغرق هذه التعليمات 9 دقائق حتى تكتمل.

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

نوصي بإكمال البرنامج التعليمي التمهيدي حول القوالب، ولكنه غير مطلوب.

يجب أن يكون لديك Visual Studio Codeمثبتًا ويعمل مع ملحق أدوات Azure Resource Manager، وإما Azure PowerShell أو واجهة سطر أوامر Azure‏ (CLI). لمزيد من المعلومات، راجع ⁧⁩أدوات القالب⁧⁩.

إضافة مورد

لإضافة تعريف حساب تخزين Azure إلى القالب الحالي، انظر إلى ملف JSON المميز في المثال التالي. بدلًا من محاولة نسخ مقاطع من القالب، انسخ الملف بالكامل واستبدل القالب بمحتوياته.

استبدل {provide-unique-name}والأقواس المتعرجة {} باسم حساب تخزين فريد.

هام

يجب أن يكون اسم حساب التخزين فريدًا عبر Azure. إنها مجرد أحرف صغيرة أو أرقام بحد أقصى 24 حرفا. يمكنك استخدام اسم مثلstore1 كبادئة ثم إضافة الأحرف الأولى من اسمك وتاريخ اليوم. يمكن أن يكون الاسم، على سبيل المثال، store1abc06132022.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2021-09-01",
      "name": "{provide-unique-name}",
      "location": "eastus",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    }
  ]
}

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

خصائص المورد

قد تتساءل عن كيفية العثور على الخصائص لاستخدامها لكل نوع مورد. يمكنك استخدام مرجع قالب ARM للبحث عن أنواع الموارد التي تريد نشرها.

كل مورد تقوم بنشره يحتوي على الأقل على الخصائص الثلاثة التالية:

  • type: هو نوع المورد. هذه القيمة هي تركيبة من مساحة الاسم لموفر المورد ونوع المورد مثل Microsoft.Storage/storageAccounts.
  • apiVersion: إصدار من واجهة برمجة تطبيقات REST يستخدم لإنشاء المورد. ينشر كل موفر مورد إصدارات API خاصته، لذلك هذه القيمة خاصة بالنوع.
  • name: اسم المورد.

تحتوي معظم الموارد أيضًاlocation على خاصية تحدد المنطقة التي يتم فيها نشر المورد.

تختلف الخصائص الأخرى حسب نوع المورد وإصدار API. من المهم فهم الصلة بين إصدار API والخصائص المتوفرة، لذلك دعونا نقفز إلى مزيد من التفاصيل.

في هذا البرنامج التعليمي، قمت بإضافة حساب تخزين إلى القالب. يمكنك مشاهدة إصدار واجهة برمجة تطبيقات حساب التخزين في storageAccounts 2021-09-01. لاحظ أنك لم تقم بإضافة كافة الخصائص إلى قالبك. العديد من الخصائص اختيارية. ⁧Microsoft.Storage⁩يمكن لموفر الموارد إصدار API جديد، ولكن لا يجب تغيير الإصدار الذي تقوم بنشره. يمكنك الاستمرار في استخدام هذا الإصدار ومعرفة أن نتائج النشر الخاص بك متسقة.

إذا قمت بعرض إصدار واجهة برمجة تطبيقات أقدم، فقد ترى أن مجموعة أصغر من الخصائص متوفرة.

إذا قررت تغيير إصدار واجهة برمجة التطبيقات لمورد، فتأكد من تقييم خصائص هذا الإصدار وضبط قالبك بشكل مناسب.

نشر القالب

يمكنك نشر القالب لإنشاء حساب التخزين. امنح النشر اسمًا مختلفًا حتى تتمكن من العثور عليه بسهولة في السجل.

إذا لم تكن قد أنشأت مجموعة الموارد، فراجع ⁧⁩إنشاء مجموعة موارد⁧⁩. يفترض المثال أنك قمت بتعيين المتغير ⁧templateFile⁩على المسار إلى ملف القالب، كما هو موضح في ⁧⁩البرنامج التعليمي الأول⁧⁩.

New-AzResourceGroupDeployment `
  -Name addstorage `
  -ResourceGroupName myResourceGroup `
  -TemplateFile $templateFile

ملاحظة

إذا فشل التوزيع، فاستخدمverbose رمز التبديل للحصول على معلومات حول الموارد التي تقوم بإنشائها. استخدم مفتاح ⁧debug⁩ للحصول على مزيد من المعلومات لتصحيح الأخطاء.

هذه الأخطاء هما نوعان من حالات فشل النشر المحتملة التي قد تواجهها:

  • Error: Code=AccountNameInvalid; Message={provide-unique-name} ليس اسم حساب تخزين صالح. يجب أن يتراوح طول اسم حساب التخزين بين 3 و 24 حرفًا وأن يستخدم أرقامًا وأحرفًا صغيرة فقط.

    في القالب، استبدل {provide-unique-name} باسم حساب تخزين فريد. راجع إضافة مورد.

  • Error: Code=StorageAccountAlreadyTaken; Message=The storage account named store1abc09092019 مستخدم بالفعل.

    في القالب، جرب اسم حساب تخزين مختلف.

يستغرق هذا النشر وقتًا أطول من نشر القالب الفارغ لأنك تقوم بإنشاء حساب تخزين. يمكن أن يستغرق حوالي دقيقة.

تحقق من التوزيع

يمكنك التحقق من النشر باستكشاف مجموعة الموارد من مدخل Azure.

  1. تسجيل الدخول إلى ⁧⁩مدخل Microsoft Azure⁧⁩.
  2. من القائمة اليمنى، حدد مجموعات الموارد.
  3. حدد المربع الموجود على يسار myResourceGroup وحدد myResourceGroup
  4. حدد مجموعة الموارد التي قمت بنشرها.
  5. ترى أنه قد تم نشر مورد حساب تخزين.
  6. لاحظ أن تسمية النشر الآن تقول: Deployments: 2 Succeeded.

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

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

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

  1. من مدخل Microsoft Azure، حدد مجموعة الموارد من القائمة اليمنى.
  2. اكتب اسم مجموعة الموارد في عامل التصفية لأي حقل...صندوق.
  3. حدد المربع بجوار myResourceGroup وحدد myResourceGroup أو اسم مجموعة الموارد الذي اخترته.
  4. حدد Delete resource group من القائمة.

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

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

إضافة مؤشرات