مشاركة عبر

بداية سريعة: إنشاء قوالب ARM باستخدام Visual Studio Code

  • مقالة

توفر أدوات إدارة الموارد Azure للتعليمات البرمجية Visual Studio دعم اللغة ومقتطفات الموارد والإكمال التلقائي للمورد. تساعد هذه الأدوات في إنشاء قوالب Azure Resource Manager والتحقق من صحتها (قوالب ARM)، وبالتالي فهو الأسلوب الموصى به لإنشاء قالب ARM وتكوينه. في قالب التشغيل السريع هذا، يمكنك استخدام الملحق لإنشاء ملف Bicep من الصفر. أثناء القيام بذلك، تواجه قدرات الإضافات مثل قصاصات قالب ARM والتحقق من الصحة والإكمال ودعم ملف المعلمة.

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

لإكمال قالب التشغيل السريع، تحتاج Visual Studio Codeمع تثبيت ملحق Bicep. تحتاج أيضاً إلى تثبيت أحدث Azure CLI أو أحدث وحدة Azure PowerShellومصادقتها.

في حال لم يكن لديك اشتراك Azure، فأنشئ حساباً مجانيّاً قبل البدء.

تلميح

نوصي باستخدام Bicep لأنها تقدم نفس الإمكانات التي توفرها نماذج ARM ولأن البنية أسهل في الاستخدام. لمعرفة المزيد، راجع Quickstart: إنشاء ملفات Bicep باستخدام Visual Studio Code.

إشعار

لا يتعرف الإصدار الحالي من ملحق Azure Resource Manager Tools ل Visual Studio Code على التحسينات التي تم إجراؤها في languageVersion 2.0.

إنشاء قالب ARM

أنشئ ملفاً جديداً باسم azuredeploy.jsonوافتحه باستخدام Visual Studio Code. أدخل arm في محرر التعليمات البرمجية، الذي يبدأ تشغيل Azure Resource Manager لحوسبة قالب ARM.

حدد arm! لإنشاء قالب محدد النطاق لنشر مجموعة موارد Azure.

لقطة شاشة تعرض قصاصات دعم Azure Resource Manager.

تقوم هذه التعليمات البرمجية بإنشاء لبنات الإنشاء الأساسية لقالب ARM.

لقطة شاشة تعرض قالب ARM مدعوم بالكامل.

لاحظ أن وضع لغة Visual Studio Code قد تغير من JSON إلى قالب Azure Resource Manager. يتضمن الملحق خادم لغة خاص بقوالب ARM يوفر التحقق من الصحة والإكمال وخدمات اللغات الأخرى الخاصة بالقالب.

لقطة شاشة تعرض Azure Resource Manager كوضع لغة Visual Studio Code.

إضافة مورد Azure

يتضمن الامتداد تعليمات برمجية للعديد من موارد Azure. يمكن استخدام هذه التعليمات البرمجية لإضافة موارد إلى نشر القوالب بسهولة.

ضع المؤشر في كتلة موارد القالب، واكتب في storage، وحدد التعليمات البرمجية في arm-storage.

لقطة شاشة تعرض موردا تتم إضافته إلى قالب ARM.

يضيف هذا الإجراء مورد تخزين إلى القالب.

لقطة شاشة تعرض مورد Azure Storage في قالب ARM.

يمكن استخدام مفتاح علامة التبويب في علامة التبويب من خلال خصائص قابلة للتكوين على حساب التخزين.

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

الاكتمال والتحقق

من أقوى إمكانيات الملحق تكامله مع مخططات Azure. توفر مخططات Azure الملحق مع التحقق من الصحة وقدرات الإكمال الواعية بالموارد. دعنا نرى حساب التخزين للتحقق من الصحة والإكمال على أرض الواقع.

أولاً، حدث نوع حساب التخزين إلى قيمة غير صالحة مثل megaStorage. لاحظ أن هذا الإجراء ينتج عنه تحذير يشير إلى أن megaStorage ليست قيمة صالحة.

لقطة شاشة تعرض تكوين تخزين غير صالح.

لاستخدام إمكانات الإكمال، بادر بإزالة megaStorage، ضع المؤشر داخل علامات الاقتباس الثنائية واضغط على ctrl + space. يقدم هذا الإجراء قائمة كاملة بالقيم الصالحة.

لقطة شاشة تعرض الإكمال التلقائي للامتداد.

أضف معلمات القالب

الآن بادر بإنشاء واستخدام معلمة لتحديد اسم حساب التخزين.

ضع المؤشر في كتلة المعلمات، وأضف حرف إرجاع واكتب "، ثم حدد new-parameter المعلمة البرمجية. يضيف هذا الإجراء معلمة عامة إلى القالب.

لقطة شاشة تعرض معلمة تتم إضافتها إلى قالب ARM.

تحديث اسم المعلمة إلى storageAccountName والوصف إلى Storage account name .

لقطة شاشة تعرض المعلمة المكتملة في قالب ARM.

تحتوي أسماء حسابات التخزين Azure على 3 أحرف كحد أدنى و24 حرفًا كحد أقصى. إضافة كلٍ من minLength وmaxLength إلى المعلمة وتوفير القيم المناسبة.

لقطة شاشة تعرض minLength وmaxLength التي تتم إضافتها إلى معلمة قالب ARM.

الآن، على مورد التخزين، حدِّث خاصية الاسم لاستخدام المعلمة. للقيام بذلك، قم بحذف الاسم الحالي. أدخل عرض أسعار مزدوج وقوس مربع افتتاحي [، والذي ينتج قائمة بوظائف قالب ARM. حدد المعلمات من القائمة.

لقطة شاشة تعرض الإكمال التلقائي عند استخدام المعلمات في موارد قالب ARM.

إدخال عرض أسعار واحد ' داخل الأقواس المستديرة ينتج قائمة بجميع المعلمات المعرفة في القالب، في هذه الحالة، storageAccountName. حدد المعلمة.

لقطة شاشة تعرض المعلمة المكتملة في مورد قالب ARM.

قم بإنشاء ملف معلمة

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

يسهل الملحق إنشاء ملف معلمات من القوالب الموجودة لديك. للقيام بذلك، انقر بزر الماوس الأيمن فوق القالب في محرر التعليمات البرمجية وحدد Select/Create Parameter File .

لقطة شاشة تعرض عملية النقر بزر الماوس الأيمن لإنشاء ملف معلمة من قالب ARM.

حدد New>All Parameters> حدد اسمًا وموقعًا لملف المعلمة.

ينشئ هذا الإجراء ملف معلمة جديد ويحدده بالقالب الذي تم إنشاؤه منه. يمكنك مشاهدة وتعديل تعيين ملف القالب/المعلمة الحالي في شريط حالة Visual Studio التعليمات البرمجية أثناء تحديد القالب.

لقطة شاشة تعرض تعيين ملف القالب/المعلمة في شريط حالة Visual Studio Code.

الآن بعد أن تم تعيين ملف المعلمة إلى القالب، يتحقق الملحق من صحة كل من ملف القالب والمعلمة معا. لمشاهدة التحقق من الصحة هذا في التدريب العملي، إضافة قيمة حرفين إلى storageAccountName المعلمة في ملف المعلمة وحفظ الملف.

لقطة شاشة تعرض قالب غير صالح بسبب مشكلة في ملف المعلمة.

انتقل مرة أخرى إلى قالب ARM ولاحظ الخطأ الذي يشير إلى أن القيمة لا تفي بمعايير المعلمة.

لقطة شاشة تعرض قالب ARM صالحا.

تحديث القيمة إلى شيء مناسب وحفظ الملف والانتقال مرة أخرى إلى القالب. لاحظ أنه تم حل الخطأ على المعلمة.

نشر القالب

افتح محطة Visual Studio Code المتكاملة باستخدام مجموعة المفاتيح ctrl + ` ثم استخدم وحدة Azure CLI أو Azure PowerShell النمطية لنشر القالب.

az group create --name arm-vscode --location eastus

az deployment group create --resource-group arm-vscode --template-file azuredeploy.json --parameters azuredeploy.parameters.json

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

عندما لم تعد هناك حاجة إلى موارد Azure، استخدم الوحدة Azure CLI أو Azure PowerShell لحذف مجموعة موارد التشغيل السريع.

az group delete --name arm-vscode

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

سلسلة البرامج التعليمية للمبتدئين