تشغيل سريع: تكامل Bicep مع Azure Pipelines

توضح لك هذه المقالة كيفية تكامل ملفات Bicep مع Azure Pipelines من أجل التكامل المستمر، والتوزيع المستمر (CI/CD).

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

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

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

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

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

لديك ملف Bicep يحدد البنية الأساسية للمشروع. هذا الملف في مستودع.

تحتاج إلى ملف bicepparam يحدد المعلمات المستخدمة من قبل ملف bicep الخاص بك. هذا الملف في مستودع.

إنشاء مسار تدفق

1. من مؤسسة Azure DevOps، حدد Pipelines and Create pipeline.

   

2. حدد مكان تخزين التعليمة البرمجية. يستخدم هذا التشغيل السريع Azure Repos Git.

   

3. حدد المستودع الذي يحتوي على التعليمات البرمجية للمشروع.

   

4. حدد Starter pipeline لنوع التدفق المراد إنشاؤه.

   

توزيع ملفات Bicep

يمكنك استخدام مهمة نشر مجموعة موارد Azure أو مهمة Azure CLI لنشر ملف Bicep.

استخدام مهمة نشر قالب Azure Resource Manager

إشعار

اعتبارا من الإصدار 3.235.0 من مهمة نشر قالب Azure Resource Manager، يتم دعم استخدام ملفات bicepparam .

إشعار

AzureResourceManagerTemplateDeployment@3 تتطلب المهمة توفير كل من ملفات Bicep وbicepparam عند استخدام bicepparam. يمكن لملف Bicep الرجوع إلى جميع المواقع المدعومة لمراجع الوحدة النمطية. يجب أن يشير ملف bicepparam إلى ملف Bicep المحلي في العبارة using .

1. استبدل تدفق البداية الخاص بك مع YAML التالية. يقوم بإنشاء مجموعة موارد ونشر ملف Bicep وbicepparam باستخدام مهمة نشر قالب Azure Resource Manager.

   trigger:
   - main
   
   name: Deploy Bicep files
   
   parameters:
   - name: azureServiceConnection
     type: string
     default: '<your-connection-name>'
   
   variables:
     vmImageName: 'ubuntu-latest'
     resourceGroupName: 'exampleRG'
     location: '<your-resource-group-location>'
     templateFile: './main.bicep'
     csmParametersFile: './main.bicepparam'
   
   pool:
     vmImage: $(vmImageName)
   
   steps:
   - task: AzureResourceManagerTemplateDeployment@3
     inputs:
       deploymentScope: 'Resource Group'
       azureSubscription: '${{ parameters.azureServiceConnection }}'
       action: 'Create Or Update Resource Group'
       resourceGroupName: '$(resourceGroupName)'
       location: '$(location)'
       templateLocation: 'Linked artifact'
       csmFile: '$(templateFile)'
       csmParametersFile: '$(csmParametersFile)'
       overrideParameters: '-storageAccountType Standard_LRS'
       deploymentMode: 'Incremental'
       deploymentName: 'DeployPipelineTemplate'
   

2. تحديث قيم azureServiceConnection و location.

3. تحقق من أن لديك ملفا صالحا main.bicep في المستودع الخاص بك.

4. تحقق من أن لديك ملفا صالحا main.bicepparam في المستودع يحتوي على عبارة استخدام .

5. حدد حفظ. يتم تشغيل تدفق البنية تلقائيًا. عد إلى ملخص لخط أنابيب البناء الخاص بك، ومشاهدة الحالة.

استخدام مهمة Azure CLI

إشعار

يتطلب الأمر az deployment group create ملف bicepparam فقط. using يمكن أن تستهدف العبارة في ملف bicepparam أي موقع مدعوم للإشارة إلى ملف Bicep. ملف Bicep مطلوب فقط في المستودع الخاص بك عندما using يكون من مسار قرص محلي باستخدام Azure CLI.

إشعار

عند استخدام ملف bicepparam مع الأمر az deployment group create ، لا يمكنك تجاوز المعلمات.

1. استبدل تدفق البداية الخاص بك مع YAML التالية. ينشئ مجموعة موارد وينشر ملف bicepparam باستخدام مهمة Azure CLI:

   trigger:
   - main
   
   name: Deploy Bicep files
   
   parameters:
     azureServiceConnection: '<your-connection-name>'
   
   variables:
     vmImageName: 'ubuntu-latest'
     resourceGroupName: 'exampleRG'
     location: '<your-resource-group-location>'
     bicepParamFile: './main.bicepparam'
   
   pool:
     vmImage: $(vmImageName)
   
   steps:
   - task: AzureCLI@2
     inputs:
       azureSubscription: '${{ parameters.azureServiceConnection }}'
       scriptType: bash
       scriptLocation: inlineScript
       useGlobalConfig: false
       inlineScript: |
         az --version
         az group create --name $(resourceGroupName) --location $(location)
         az deployment group create `
           --resource-group $(resourceGroupName) `
           --parameters $(bicepParamFile) `
           --name DeployPipelineTemplate
   

   للحصول على أوصاف مدخلات المهمة، راجع مهمة Azure CLI. عند استخدام المهمة على سحابة ذات هواء، يجب تعيين useGlobalConfig خاصية المهمة إلى true. القيمة الافتراضية هي false.

2. تحديث قيم azureServiceConnection و location.

3. تحقق من أن لديك ملفا صالحا main.bicepparam في المستودع يحتوي على عبارة استخدام .

4. حدد حفظ. يتم تشغيل تدفق البنية تلقائيًا. عد إلى ملخص لخط أنابيب البناء الخاص بك، ومشاهدة الحالة.

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

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

المبادره القطريه

az group delete --name exampleRG

بوويرشيل

Remove-AzResourceGroup -Name exampleRG

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

نشر ملفات Bicep باستخدام إجراءات GitHub