النشر إلى Azure App Service باستخدام Azure Pipelines

خدمات | Azure DevOps Server 2022

توضح هذه المقالة كيفية استخدام Azure Pipelines لإنشاء تطبيق الويب الخاص بك واختباره ونشره تلقائيا إلى Azure App Service. يمكنك إعداد مسار تكامل مستمر وتسليم مستمر (CI/CD) يتم تشغيله كلما قمت بإيداع تغيير التعليمات البرمجية إلى فرع معين من المستودع الخاص بك.

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

يمكنك استخدام مهمة Azure Web App في البنية الأساسية لبرنامج ربط العمليات التجارية للنشر إلى App Service. بالنسبة للسيناريوهات الأكثر تعقيدا، مثل استخدام معلمات XML في عمليات التوزيع، يمكنك استخدام مهمة نشر Azure App Service .

المتطلبات

• تطبيق Azure App Service يعمل مع تعليمات برمجية مستضافة على GitHub أو Azure Repos. يمكنك استخدام أي من مقالات التشغيل السريع التالية لإنشاء نموذج تطبيق:

  • ASP.NET Core: إنشاء تطبيق ويب ASP.NET Core في Azure
  • ASP.NET: إنشاء تطبيق ويب ASP.NET Framework في Azure
  • JavaScript: إنشاء تطبيق ويب Node.js في Azure App Service
  • Java: إنشاء تطبيق Java في Azure App Service
  • Python: إنشاء تطبيق Python في Azure App Service

• مؤسسة Azure DevOps لديها القدرة على تشغيل المسارات على الوكلاء المستضافين من Microsoft. تحتاج إلى طلب طبقة مجانية من الوظائف المتوازية أو شراء وظائف متوازية. لمزيد من المعلومات، راجع تكوين الوظائف المتوازية والدفع لها.

• مشروع تم إنشاؤه في مؤسسة Azure DevOps حيث لديك إذن لإنشاء المسارات واتصالات خدمة Azure وتفويضها. إنشاء مشروع في Azure DevOps.

هام

أثناء إجراءات GitHub، قد تتم مطالبتك بإنشاء اتصال خدمة GitHub أو إعادة توجيهك إلى GitHub لتسجيل الدخول، أو تثبيت تطبيق Azure Pipelines GitHub، أو تخويل Azure Pipelines، أو المصادقة على مؤسسات GitHub. اتبع التعليمات التي تظهر على الشاشة لإكمال العمليات اللازمة. لمزيد من المعلومات، راجع الوصول إلى مستودعات GitHub.

إنشاء خط أنابيب

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

YAML

حدد البنية الأساسية لبرنامج ربط العمليات التجارية عن طريق إنشاء ملف YAML azure-pipelines.yml في مستودع التعليمات البرمجية الخاص بك.

1. في قائمة التنقل اليسرى لمشروع Azure DevOps، حدد التدفقات.
2. في صفحة التدفقات ، حدد مسار جديد، أو إنشاء مسار إذا كان هذا المسار هو الأول في المشروع.
3. في شاشة أين توجد التعليمات البرمجية الخاصة بك ، حدد موقع التعليمات البرمجية المصدر، إما Azure Repos Git أو GitHub. إذا لزم الأمر، قم بتسجيل الدخول إلى GitHub.
4. في شاشة تحديد مستودع ، حدد مستودع التعليمات البرمجية الخاص بك.
5. في شاشة تكوين التدفق ، حدد مسار المبتدئين.

أضف مهمة .NET Core (DotNetCoreCLI@2) إلى البنية الأساسية لبرنامج ربط العمليات التجارية، وقم بإنشاء تطبيقك ونشره.

1. في شاشة مراجعة YAML لخط الأنابيب ، احذف كل التعليمات البرمجية بعد السطر steps: .
2. حدد نهاية الملف، ثم حدد إظهار المساعد على اليمين.
3. ضمن المهام، حدد .NET Core.
4. في شاشة تكوين .NET Core ، ضمن اتصال Azure Resource Manager، حدد اشتراك Azure، ثم حدد تخويل لإنشاء اتصال الخدمة المطلوب.
5. ضمن الأوامر، حدد نشر.
6. تأكد من تحديد خانتي الاختيار نشر مشاريع ويبوالمشاريع المنشورة على Zip ، ثم حدد إضافة.
7. تظهر المهمة في مسار YAML الخاص بك. راجع كود YAML لمعرفة ما يفعله. عندما تكون جاهزا، حدد حفظ وتشغيل، ثم حدد حفظ وتشغيل مرة أخرى.
8. في شاشة ملخص الإنشاء، ضمن الوظائف، حدد الارتباط الإذن المطلوب . في شاشة عمليات الفحوص ، حدد تصريح، ثم حدد السماح مرة أخرى. يسمح منح الإذن هنا باستخدام اتصال الخدمة الذي قمت بالسماح به لجميع عمليات تشغيل هذا التدفق.

كلاسيكي

1. في قائمة التنقل اليسرى لمشروع Azure DevOps، حدد التدفقات.
2. في صفحة التدفقات ، حدد مسار جديد، أو إنشاء مسار إذا كان هذا المسار هو الأول في المشروع.
3. في شاشة أين توجد التعليمات البرمجية الخاصة بك ، حدد استخدام المحرر الكلاسيكي لإنشاء مسار بدون YAML.
4. في شاشة تحديد مستودع ، حدد موقع التعليمات البرمجية المصدر، إما Azure Repos Git أو GitHub، ثم حدد مستودع التعليمات البرمجية والفرع الافتراضي. حدد متابعة.
5. في شاشة اختيار قالب ، حدد ASP.NET Core، ثم حدد تطبيق.
6. في شاشة البنية الأساسية لبرنامج ربط العمليات التجارية الجديدة، ضمن مواصفات العامل على اليمين، حدد مواصفات الوكيل مثل أحدث أوبونتو أو أحدث النوافذ وفقا للنظام الأساسي للتطبيق وإصداره.
7. انظر إلى خط الأنابيب لترى ما يفعله. عندما تكون جاهزا، حدد حفظ وقائمة الانتظار.
8. حدد حفظ وقائمة الانتظار مرة أخرى، وفي شاشة تشغيل التدفق ، حدد حفظ وتشغيل.

ينشر المسار ملف ZIP للتوزيع كأداة Azure لمهمة التوزيع لاستخدامها في الخطوة التالية.

إضافة مهمة النشر

بعد تشغيل المسار بنجاح، أضف مهمة النشر.

YAML

1. في شاشة تشغيل التدفق، حدد أيقونة المزيد من الإجراءات في الجزء العلوي الأيمن، ثم حدد تحرير التدفق.
2. حدد نهاية ملف YAML، وحدد إظهار المساعد إذا لم تظهر قائمة المهام .
3. في قائمة المهام ، ابحث عن مهمة Azure Web App وحددها. بدلا من ذلك، يمكنك استخدام مهمة نشر Azure App Service .
4. في شاشة تكوين Azure Web App، ضمن اشتراك Azure، حدد نفس اتصال الخدمة الذي قمت بإعداده للخطوة السابقة. لا تحتاج إلى إعادة تفويض هذا الاتصال.
5. بالنسبة لنوع التطبيق، حدد Azure Web App على Linux أو Azure Web App على Windows، اعتمادا على التعليمات البرمجية الخاصة بك.
6. بالنسبة إلى اسم التطبيق، حدد اسم تطبيق App Service أو أدخله.
7. حدد إضافة.
8. حدد التحقق من الصحة والحفظ، ثم حدد حفظ.
9. حدد تشغيل، ثم حدد تشغيل مرة أخرى.

يجب أن يبدو مسار YAML الكامل مثل التعليمات البرمجية التالية:

trigger:
- <branch-specification>

pool:
  vmImage: <agent-specification>

steps:
- task: DotNetCoreCLI@2
  inputs:
    azureSubscription: '<your-authorized-service-connection>'
    command: 'publish'
    publishWebProjects: true

- task: AzureWebApp@1
  inputs:
    azureSubscription: '<your-authorized-service-connection>'
    appType: 'webApp'
    appName: '<your-app-name>'
    package: '$(System.DefaultWorkingDirectory)/**/*.zip'
    deploymentMethod: 'auto'  

• azureSubscription: اسم اتصال الخدمة المعتمد باشتراك Azure الخاص بك.
• appName: اسم تطبيقك الحالي.
• packageمسار الملف إلى الحزمة أو المجلد الذي يحتوي على محتويات App Service.: يتم دعم أحرف البدل.

كلاسيكي

بالنسبة لخطوط الأنابيب الكلاسيكية، من الأسهل تحديد مراحل الإنشاء والإصدار في مسارات منفصلة.

1. في قائمة التنقل اليمنى لمشروعك، حددإصدارات>، ثم حدد مسار جديد لإنشاء مسار إصدار.

2. ضمن تحديد قالب، حدد قالب توزيع Azure App Service ، وحدد تطبيق. يضيف هذا القالب المهام الضرورية تلقائيا.

   إشعار

   إذا كنت تقوم بنشر تطبيق Node.js إلى App Service على Windows، فحدد قالب توزيع تطبيق Node.js إلى Azure App Service . يقوم هذا القالب بتكوين المهمة لإنشاء ملف web.config يحتوي على معلمة تبدأ iisnode الخدمة.

3. في صفحة مسار الإصدار الجديد ، حدد علامة التبويب المهام ، وحدد المرحلة 1، وأكمل الحقول التالية ضمن المعلمات:

   • اشتراك Azure: إذا لم يكن لديك بالفعل اتصال خدمة Azure، فحدد اشتراك Azure، ثم حدد تخويل لإنشاء اتصال الخدمة المطلوب.
   • نوع التطبيق: حدد Azure Web App على Linux أو Azure Web App على Windows، لمطابقة التعليمات البرمجية ومواصفات العامل.
   • اسم خدمة التطبيق: حدد تطبيق App Service.

4. في علامة التبويب البنية الأساسية لبرنامج ربط العمليات التجارية في شاشة البنية الأساسية لبرنامج ربط العمليات التجارية للإصدار الجديد ، بجوار البيانات الاصطناعية، حدد إضافة.

5. في شاشة إضافة أداة ، تأكد من تحديد إنشاء ، وضمن المصدر (البنية الأساسية للبناء)، حدد البنية الأساسية لبرنامج ربط العمليات التجارية الذي قمت بإنشائه في القسم السابق.

6. حدد إضافة.

7. في صفحة التدفق، حدد حفظ في الجزء العلوي الأيمن، ثم حدد موافق.

8. لتشغيل التدفق، في صفحة البنية الأساسية لبرنامج ربط العمليات التجارية، حدد إنشاء إصدار، ثم حدد إنشاء.

الأمثلة

تناقش الأقسام التالية إنشاء أنواع مختلفة من مسارات الإنشاء والإصدار.

النشر إلى تطبيق ظاهري

YAML

يتم نشر مهمة Azure Web App إلى التطبيق الجذر في تطبيق ويب Azure. يمكنك النشر إلى تطبيق ظاهري معين باستخدام VirtualApplication خاصية مهمة نشر Azure App Service .

- task: AzureRmWebAppDeployment@5
  inputs:
    VirtualApplication: '<name of virtual application>'

VirtualApplication هو اسم التطبيق الظاهري الذي تم تكوينه في مدخل Microsoft Azure. لمزيد من المعلومات، راجع تكوين تطبيق App Service في مدخل Microsoft Azure.

كلاسيكي

يتم نشر مهمة Azure Web App إلى التطبيق الجذر في تطبيق ويب Azure. للنشر على تطبيق ظاهري معين، أدخل اسمه في خاصية التطبيق الظاهري لمهمة نشر Azure App Service .

النشر في فتحة

YAML

يوضح المثال التالي كيفية النشر إلى فتحة التقسيم المرحلي، ثم التبديل إلى فتحة إنتاج:

- task: AzureWebApp@1
  inputs:
    azureSubscription: '<service-connection-name>'
    appType: webAppLinux
    appName: '<app-name>'
    deployToSlotOrASE: true
    resourceGroupName: '<name of resource group>'
    slotName: staging
    package: '$(Build.ArtifactStagingDirectory)/**/*.zip'

- task: AzureAppServiceManage@0
  inputs:
    azureSubscription: '<service-connection-name>'
    WebAppName: '<app-name>'
    ResourceGroupName: '<name of resource group>'
    SourceSlot: staging
    SwapWithProduction: true

• azureSubscriptionاتصال خدمة Azure.:
• appTypeنوع التطبيق الاختياري مثل webAppLinux النشر على تطبيق ويب على Linux.:
• appNameاسم تطبيقك الحالي.:
• deployToSlotOrASE:منطقيه. ما إذا كان سيتم النشر في فتحة توزيع موجودة أو بيئة App Service.
• resourceGroupNameاسم مجموعة الموارد المراد النشر فيها، مطلوب إذا deployToSlotOrASE كان صحيحا.:
• slotNameاسم الفتحة المراد النشر فيها، مطلوب إذا deployToSlotOrASE كان صحيحا.: الإعدادات الافتراضية لـ production.
• packageمسار الملف إلى الحزمة أو المجلد الذي يحتوي على محتويات التطبيق.: يتم دعم أحرف البدل.
• SourceSlot: يتم إرسال الفتحة إلى الإنتاج عندما SwapWithProduction يكون صحيحا.
• SwapWithProduction:منطقيه. ما إذا كان سيتم تبديل حركة مرور فتحة المصدر بالإنتاج.

كلاسيكي

استخدم الخيار Deploy to Slot أو App Service Environment في مهمة Azure Web App لتحديد الفتحة للنشر إليها. لتبديل الفتحات، استخدم مهمة إدارة Azure App Service .

النشر في تطبيقات ويب متعددة

YAML

يمكنك استخدام المهام في ملف YAML لإعداد مسار عمليات التوزيع. باستخدام الوظائف، يمكنك التحكم في ترتيب النشر إلى تطبيقات ويب متعددة.

jobs:
- job: buildandtest
  pool:
    vmImage: ubuntu-latest
 
  steps:
  # publish an artifact called drop
  - task: PublishPipelineArtifact@1
    inputs:
      targetPath: '$(Build.ArtifactStagingDirectory)' 
      artifactName: drop
  
  # deploy to Azure Web App staging
  - task: AzureWebApp@1
    inputs:
      azureSubscription: '<service-connection-name>'
      appType: <app type>
      appName: '<staging-app-name>'
      deployToSlotOrASE: true
      resourceGroupName: <group-name>
      slotName: 'staging'
      package: '$(Build.ArtifactStagingDirectory)/**/*.zip'

- job: deploy
  dependsOn: buildandtest
  condition: succeeded()

  pool: 
    vmImage: ubuntu-latest
  
  steps:
    # download the artifact drop from the previous job
  - task: DownloadPipelineArtifact@2
    inputs:
      source: 'current'
      artifact: 'drop'
      path: '$(Pipeline.Workspace)'

  - task: AzureWebApp@1
    inputs:
      azureSubscription: '<service-connection-name>'
      appType: <app type>
      appName: '<production-app-name>'
      resourceGroupName: <group-name>
      package: '$(Pipeline.Workspace)/**/*.zip'

كلاسيكي

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

النشر المشروط

YAML

للنشر المشروط في YAML، استخدم إحدى الأساليب التالية:

• إضافة شرط إلى الخطوة.
• اعزل خطوات التوزيع في مهمة منفصلة، وأضف شرطا إلى تلك المهمة.

يوضح المثال التالي كيفية استخدام شروط الخطوة لنشر الإصدارات الناجحة فقط التي تنشأ من الفرع الرئيسي:

- task: AzureWebApp@1
  condition: and(succeeded(), eq(variables['Build.SourceBranch'], 'refs/heads/main'))
  inputs:
    azureSubscription: '<service-connection-name>'
    appName: '<app-name>'

لمزيد من المعلومات حول الشروط، راجع تحديد الشروط.

كلاسيكي

في مسار الإصدار الخاص بك، يمكنك تنفيذ عمليات التحقق والشروط المختلفة للتحكم في النشر:

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

لمزيد من المعلومات، راجع المقالات التالية:

• مشغلات الإصدار الكلاسيكي
• التحكم في النشر باستخدام الموافقات
• مفاهيم بوابات النشر

النشر باستخدام نشر الويب

يمكن نشر مهمة نشر Azure App Service إلى App Service باستخدام Web Deploy.

YAML

trigger:
- main

pool:
  vmImage: windows-latest

variables:
  buildConfiguration: 'Release'

steps:
- task: DotNetCoreCLI@2
  inputs:
    command: 'publish'
    publishWebProjects: true
    arguments: '--configuration $(buildConfiguration)'
    zipAfterPublish: true

- task: AzureRmWebAppDeployment@5
  inputs:
    ConnectionType: 'AzureRM'
    azureSubscription: '<service-connection-name>'
    appType: 'webApp'
    WebAppName: '<app-name>'
    packageForLinux: '$(System.DefaultWorkingDirectory)/**/*.zip'
    enableCustomDeployment: true
    DeploymentType: 'webDeploy'

كلاسيكي

إذا كنت تستخدم قالب توزيع Azure App Service في مسار إصدار، فاتبع هذه الخطوات للنشر في Web Deploy.

1. حدد علامة التبويب المهام ، ثم حدد نشر Azure App Service، مهمة نشر Azure App Service .
2. في شاشة التكوين، تأكد من تعيين نوع الاتصال إلى Azure Resource Manager.
3. قم بتوسيع خيارات النشر الإضافية واختر تحديد أسلوب النشر. تأكد من تحديد Web Deploy كطريقة نشر.
4. احفظ مسار الإصدار.

إشعار

باستخدام مهمة نشر Azure App Service ، يجب عليك استخدام نوع اتصال Azure Resource Manager أو AzureRM عند النشر باستخدام Web Deploy. يستخدم نوع الاتصال هذا ملفات تعريف النشر للنشر عند تمكين المصادقة الأساسية لتطبيقك. عند تعطيل المصادقة الأساسية، يستخدم الاتصال مصادقة معرف Microsoft Entra الأكثر أمانا.

الأسئلة المتداولة

ما الفرق بين مهام AzureWebApp وAzureRmWebAppDeploy؟

مهمة Azure Web App هي أبسط طريقة للنشر إلى تطبيق ويب Azure. بشكل افتراضي، يمكنك نشر التطبيق الجذر في تطبيق ويب Azure.

يمكن لمهمة نشر Azure App Service التعامل مع المزيد من السيناريوهات المخصصة، مثل:

• النشر باستخدام Web Deploy، إذا كنت تستخدم عادة عملية نشر خدمات معلومات الإنترنت (IIS).
• النشر على التطبيقات الظاهرية.
• النشر إلى أنواع التطبيقات الأخرى، مثل تطبيقات الحاويات أو تطبيقات الوظائف أو WebJobs أو واجهة برمجة التطبيقات وتطبيقات الأجهزة المحمولة.

إشعار

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

لماذا أحصل على الرسالة "تم توفير حزمة App Service أو مسار مجلد غير صالح"؟

في مسارات YAML، قد يكون هناك عدم تطابق بين مكان حفظ حزمة الويب المبنية والمكان الذي تبحث فيه مهمة النشر عنها. تلتقط مهمة AzureWebApp الافتراضية حزمة الويب للنشر منها $(System.DefaultWorkingDirectory)/**/*.zip. إذا تم إيداع حزمة الويب في مكان آخر، فقم بتعديل قيمة المعلمة package .

لماذا أحصل على الرسالة "النشر باستخدام خيارات webdeploy مدعومة فقط عند استخدام عامل Windows"؟

يحدث هذا الخطأ في مهمة AzureRmWebAppDeployment عند تكوين المهمة للنشر باستخدام Web Deploy، ولكن الوكيل الخاص بك لا يقوم بتشغيل Windows. تحقق من أن معلمة YAML vmImage الخاصة بك تحدد Windows.

pool:
  vmImage: windows-latest

لماذا لا يعمل Web Deploy عند تعطيل المصادقة الأساسية؟

للحصول على معلومات حول استكشاف الأخطاء وإصلاحها حول الحصول على مصادقة معرف Microsoft Entra للعمل مع مهمة نشر Azure App Service ، راجع لا يمكنني نشر الويب إلى Azure App Service باستخدام مصادقة معرف Microsoft Entra من عامل Windows الخاص بي.

المحتوى ذو الصلة

• تخصيص خط الأنابيب الخاص بك
• إنشاء تطبيقات الويب Python ونشرها