كيف يعمل Bicep

مكتمل

لقد طورت فهما للغة قالب Bicep والفوائد التي يوفرها لتأليف القالب. قبل أن تبدأ عملية كتابة قوالب Bicep لتزويد مواردك، فأنت تريد معرفة المزيد عن كيفية عمل Bicep.

في هذه الوحدة، ستتعرف إلى كيفية عمل Bicep مع Azure Resource Manager.

توزيع Bicep

في الوحدة السابقة، تعلمت أن Bicep هي لغة مجال مخصصة، مما يعني أنها مصممة لسيناريوهات معينة أو مجال محدد. Bicep مصمم لتسهيل توزيع موارد Azure وتكوينها.

عند توزيع مورد أو سلسلة من الموارد إلى Azure، يمكنك إرسال قالب Bicep إلى Resource Manager، والذي لا يزال يتطلب قوالب JSON. الأدوات المُضمنة في Bicep تحوِّل قالب Bicep خاصتك إلى قالب JSON. وتعرف هذه العملية باسم التحويل البرمجي، والتي تتعامل بالأساس مع قالب ARM باعتباره لغة وسيطة. يحدث التحويل تلقائيا عند إرسال توزيعك، أو يمكنك إجراء ذلك يدويًا.

Diagram that shows the workflow from a template author, a Bicep template, an emitted JSON template, and a deployment to Azure.

إشعار

التحويل البرمجي هو عملية تحويل التعليمة البرمجية المصدر المكتوبة بلغة إلى لغة أخرى.

تحتوي أحدث إصدارات Azure CLI وAzure PowerShell على دعم Bicep مضمن. يمكنك استخدام أوامر التوزيع نفسها لتوزيع قالبي Bicep وJSON. على سبيل المثال، يوزع الأمر التالي قالب Bicep إلى مجموعة موارد المسماة storage-resource-group:

az deployment group create \
  --template-file main.bicep \
  --resource-group storage-resource-group

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

يمكنك عرض قالب JSON الذي أُرسِل إلى Resource Manager باستخدام الأمر bicep build. في المثال التالي، يُحوَّل قالب Bicep إلى قالب JSON المقابل له:

bicep build main.bicep

مقارنة قالبي JSON وBicep

يقدم Bicep بناء جملة أبسط لاستخدامه عند كتابة القوالب. انظر إلى الأمثلة التالية لقالبين. القالب الموجود على اليسار هو قالب Bicep. القالب الموجود على اليمين هو قالب JSON.

Screenshot that compares Bicep code on the left and the corresponding JSON code on the right.

لاحظ أن قالب Bicep يحتوي على تعليمات برمجية أقل. بناء الجملة أسهل في القراءة والفهم، ولا توجد تعبيرات معقدة كما هو الحال في قالب JSON على اليمين.

إشعار

لعرض ملفات JSON وBiped المكافئة جنبًا إلى جنب، راجع Bicep Playground.