تشغيل سريع: تكامل 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 الخاص بك. هذا الملف في مستودع.
إنشاء مسار تدفق
من مؤسسة Azure DevOps، حدد Pipelines and Create pipeline.
حدد مكان تخزين التعليمة البرمجية. يستخدم هذا التشغيل السريع Azure Repos Git.
حدد المستودع الذي يحتوي على التعليمات البرمجية للمشروع.
حدد 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
.
استبدل تدفق البداية الخاص بك مع 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'
تحديث قيم
azureServiceConnection
وlocation
.تحقق من أن لديك ملفا صالحا
main.bicep
في المستودع الخاص بك.تحقق من أن لديك ملفا صالحا
main.bicepparam
في المستودع يحتوي على عبارة استخدام .حدد حفظ. يتم تشغيل تدفق البنية تلقائيًا. عد إلى ملخص لخط أنابيب البناء الخاص بك، ومشاهدة الحالة.
استخدام مهمة Azure CLI
إشعار
يتطلب الأمر az deployment group create ملف bicepparam فقط. using
يمكن أن تستهدف العبارة في ملف bicepparam أي موقع مدعوم للإشارة إلى ملف Bicep. ملف Bicep مطلوب فقط في المستودع الخاص بك عندما using
يكون من مسار قرص محلي باستخدام Azure CLI.
إشعار
عند استخدام ملف bicepparam مع الأمر az deployment group create ، لا يمكنك تجاوز المعلمات.
استبدل تدفق البداية الخاص بك مع 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
.تحديث قيم
azureServiceConnection
وlocation
.تحقق من أن لديك ملفا صالحا
main.bicepparam
في المستودع يحتوي على عبارة استخدام .حدد حفظ. يتم تشغيل تدفق البنية تلقائيًا. عد إلى ملخص لخط أنابيب البناء الخاص بك، ومشاهدة الحالة.
تنظيف الموارد
عندما لا تعد هناك حاجة إلى موارد Azure، استخدم الوحدة Azure CLI أو Azure PowerShell لحذف مجموعة موارد التشغيل السريع.
az group delete --name exampleRG