AzureRmWebAppDeployment@3 - توزيع Azure App Service لمهمة v3

استخدم هذه المهمة لتوزيع تطبيق ويب أو جوال أو واجهة برمجة تطبيقات في Azure App Service باستخدام Docker أو Java أو .NET أو .NET Core أو Node.js أو PHP أو Python أو Ruby.

ملاحظة

استخدم AzureFunctionApp@1 لنشر تطبيقات Azure Functions.

قم بتحديث Azure App Services على Windows وWeb App على Linux مع الصور المضمنة أو حاويات docker ASP.NET و.NET Core وPHP وPython أو تطبيقات الويب المستندة إلى Node.js وتطبيقات الوظائف وتطبيقات الأجهزة المحمولة وتطبيقات واجهة برمجة التطبيقات ووظائف الويب باستخدام Web Deploy/Kudu REST APIs.

بناء الجملة

# Azure App Service deploy v3
# Deploy to Azure App Service a web, mobile, or API app using Docker, Java, .NET, .NET Core, Node.js, PHP, Python, or Ruby.
- task: AzureRmWebAppDeployment@3
  inputs:
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    appType: 'app' # 'app' | 'applinux' | 'functionapp' | 'api' | 'mobileapp'. Alias: WebAppKind. Required. App type. Default: app.
    WebAppName: # string. Required. App Service name. 
    #DeployToSlotFlag: false # boolean. Optional. Use when WebAppKind != "". Deploy to slot. Default: false.
    #ResourceGroupName: # string. Required when DeployToSlotFlag = true. Resource group. 
    #SlotName: # string. Required when DeployToSlotFlag = true. Slot. 
    #ImageSource: 'Registry' # 'Registry' | 'Builtin'. Optional. Use when WebAppKind = applinux || WebAppKind = linux. Image Source. Default: Registry.
    #AzureContainerRegistry: # string. Required when ImageSource = AzureContainerRegistry. Registry. 
    #AzureContainerRegistryLoginServer: # string. Optional. Use when ImageSource = invalidimagesource. Registry Login Server Name. 
    #AzureContainerRegistryImage: # string. Required when ImageSource = AzureContainerRegistry. Image. 
    #AzureContainerRegistryTag: # string. Optional. Use when ImageSource = AzureContainerRegistry. Tag. 
    #DockerRepositoryAccess: 'public' # 'private' | 'public'. Required when ImageSource = invalidImage. Repository Access. Default: public.
    #dockerRegistryConnection: # string. Alias: RegistryConnectedServiceName. Required when DockerRepositoryAccess = private || ImageSource = PrivateRegistry. Registry Connection. 
    #PrivateRegistryImage: # string. Required when ImageSource = PrivateRegistry. Image. 
    #PrivateRegistryTag: # string. Optional. Use when ImageSource = PrivateRegistry. Tag. 
    #DockerNamespace: # string. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource  = Registry. Registry or Namespace. 
    #DockerRepository: # string. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource  = Registry. Image. 
    #DockerImageTag: # string. Optional. Use when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource  = Registry. Tag. 
    #VirtualApplication: # string. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Virtual application. 
    #Package: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Required when WebAppKind != linux && WebAppKind != applinux &&  WebAppKind != "". Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #packageForLinux: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Alias: BuiltinLinuxPackage. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #RuntimeStack: # string. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin. Runtime Stack. 
    #StartupCommand: # string. Optional. Use when WebAppKind = applinux || WebAppKind = linux. Startup command. 
  # Output
    #WebAppUri: # string. Optional. Use when WebAppKind != "". App Service URL. 
  # Post Deployment Action
    #ScriptType: # 'Inline Script' | 'File Path'. Optional. Use when WebAppKind != "". Deployment script type. 
    #InlineScript: ':: You can provide your deployment commands here. One command per line.' # string. Required when ScriptType == Inline Script && WebAppKind != "". Inline Script. Default: :: You can provide your deployment commands here. One command per line..
    #ScriptPath: # string. Required when ScriptType == File Path && WebAppKind != "". Deployment script path. 
  # File Transforms & Variable Substitution Options
    #GenerateWebConfig: false # boolean. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Generate Web.config. Default: false.
    #WebConfigParameters: # string. Required when GenerateWebConfig == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Web.config parameters. 
    #enableXmlTransform: false # boolean. Alias: XmlTransformation. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. XML transformation. Default: false.
    #enableXmlVariableSubstitution: false # boolean. Alias: XmlVariableSubstitution. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. XML variable substitution. Default: false.
    #JSONFiles: # string. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. JSON variable substitution. 
  # Application and Configuration Settings
    #AppSettings: # string. App settings. 
    #ConfigurationSettings: # string. Configuration settings. 
  # Additional Deployment Options
    #TakeAppOfflineFlag: false # boolean. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Take App Offline. Default: false.
    #UseWebDeploy: false # boolean. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Publish using Web Deploy. Default: false.
    #SetParametersFile: # string. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". SetParameters file. 
    #RemoveAdditionalFilesFlag: false # boolean. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Remove additional files at destination. Default: false.
    #ExcludeFilesFromAppDataFlag: false # boolean. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Exclude files from the App_Data folder. Default: false.
    #AdditionalArguments: # string. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Additional arguments. 
    #RenameFilesFlag: false # boolean. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Rename locked files. Default: false.
# Azure App Service Deploy v3
# Update Azure App Services on Windows, Web App on Linux with built-in images or Docker containers, ASP.NET, .NET Core, PHP, Python or Node.js based Web applications, Function Apps, Mobile Apps, API applications, Web Jobs using Web Deploy / Kudu REST APIs.
- task: AzureRmWebAppDeployment@3
  inputs:
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    appType: 'app' # 'app' | 'applinux' | 'functionapp' | 'api' | 'mobileapp'. Alias: WebAppKind. Required. App type. Default: app.
    WebAppName: # string. Required. App Service name. 
    #DeployToSlotFlag: false # boolean. Optional. Use when WebAppKind != "". Deploy to slot. Default: false.
    #ResourceGroupName: # string. Required when DeployToSlotFlag = true. Resource group. 
    #SlotName: # string. Required when DeployToSlotFlag = true. Slot. 
    #ImageSource: 'Registry' # 'Registry' | 'Builtin'. Optional. Use when WebAppKind = applinux || WebAppKind = linux. Image Source. Default: Registry.
    #AzureContainerRegistry: # string. Required when ImageSource = AzureContainerRegistry. Registry. 
    #AzureContainerRegistryLoginServer: # string. Optional. Use when ImageSource = invalidimagesource. Registry Login Server Name. 
    #AzureContainerRegistryImage: # string. Required when ImageSource = AzureContainerRegistry. Image. 
    #AzureContainerRegistryTag: # string. Optional. Use when ImageSource = AzureContainerRegistry. Tag. 
    #DockerRepositoryAccess: 'public' # 'private' | 'public'. Required when ImageSource = invalidImage. Repository Access. Default: public.
    #dockerRegistryConnection: # string. Alias: RegistryConnectedServiceName. Required when DockerRepositoryAccess = private || ImageSource = PrivateRegistry. Registry Connection. 
    #PrivateRegistryImage: # string. Required when ImageSource = PrivateRegistry. Image. 
    #PrivateRegistryTag: # string. Optional. Use when ImageSource = PrivateRegistry. Tag. 
    #DockerNamespace: # string. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource  = Registry. Registry or Namespace. 
    #DockerRepository: # string. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource  = Registry. Image. 
    #DockerImageTag: # string. Optional. Use when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource  = Registry. Tag. 
    #VirtualApplication: # string. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Virtual application. 
    #Package: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Required when WebAppKind != linux && WebAppKind != applinux &&  WebAppKind != "". Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #packageForLinux: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Alias: BuiltinLinuxPackage. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #RuntimeStack: # string. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin. Runtime Stack. 
    #StartupCommand: # string. Optional. Use when WebAppKind = applinux || WebAppKind = linux. Startup command. 
  # Output
    #WebAppUri: # string. Optional. Use when WebAppKind != "". App Service URL. 
  # Post Deployment Action
    #ScriptType: # 'Inline Script' | 'File Path'. Optional. Use when WebAppKind != "". Deployment script type. 
    #InlineScript: ':: You can provide your deployment commands here. One command per line.' # string. Required when ScriptType == Inline Script && WebAppKind != "". Inline Script. Default: :: You can provide your deployment commands here. One command per line..
    #ScriptPath: # string. Required when ScriptType == File Path && WebAppKind != "". Deployment script path. 
  # File Transforms & Variable Substitution Options
    #GenerateWebConfig: false # boolean. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Generate Web.config. Default: false.
    #WebConfigParameters: # string. Required when GenerateWebConfig == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Web.config parameters. 
    #enableXmlTransform: false # boolean. Alias: XmlTransformation. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. XML transformation. Default: false.
    #enableXmlVariableSubstitution: false # boolean. Alias: XmlVariableSubstitution. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. XML variable substitution. Default: false.
    #JSONFiles: # string. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. JSON variable substitution. 
  # Application and Configuration Settings
    #AppSettings: # string. App settings. 
    #ConfigurationSettings: # string. Configuration settings. 
  # Additional Deployment Options
    #TakeAppOfflineFlag: false # boolean. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Take App Offline. Default: false.
    #UseWebDeploy: false # boolean. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Publish using Web Deploy. Default: false.
    #SetParametersFile: # string. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". SetParameters file. 
    #RemoveAdditionalFilesFlag: false # boolean. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Remove additional files at destination. Default: false.
    #ExcludeFilesFromAppDataFlag: false # boolean. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Exclude files from the App_Data folder. Default: false.
    #AdditionalArguments: # string. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Additional arguments. 
    #RenameFilesFlag: false # boolean. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Rename locked files. Default: false.

الإدخالات

azureSubscription - اشتراك Azure
الاسم المستعار للإدخل: ConnectedServiceName. string. مطلوب

حدد اشتراك Azure Resource Manager للتوزيع.


appType - نوع التطبيق
الاسم المستعار للإدخل: WebAppKind. string. مطلوب القيم المسموح بها: app (تطبيق الويب)، applinux (Linux Web App)، functionapp (تطبيق الوظائف (غير مستحسن، استخدام مهمة Azure Functions))، api (تطبيق واجهة برمجة التطبيقات)، mobileapp (تطبيق الأجهزة المحمولة). القيمة الافتراضية: app.

حدد نوع تطبيق الويب المراد نشره.

ملاحظة: حدد Linux Web App لصور النظام الأساسي المضمنة أو عمليات نشر صور الحاوية المخصصة.


appType - نوع التطبيق
الاسم المستعار للإدخل: WebAppKind. string. مطلوب القيم المسموح بها: app (Web App)، applinux (Linux Web App)، functionapp (Function App)، api (API App)، mobileapp (تطبيق الأجهزة المحمولة). القيمة الافتراضية: app.

حدد نوع تطبيق الويب المراد نشره.

ملاحظة: حدد Linux Web App لصور النظام الأساسي المضمنة أو عمليات نشر صور الحاوية المخصصة.


WebAppName - اسم App Service
string. مطلوب

حدد اسم خدمة تطبيقات Azure الموجودة. سيتم سرد خدمات التطبيقات المستندة إلى نوع التطبيق المحدد فقط عند استخدام مساعد المهام.


DeployToSlotFlag - التوزيع إلى الفتحة
boolean. ‏‏اختياري. استخدم عندما WebAppKind != "". القيمة الافتراضية: false.

استخدم هذا الخيار للنشر إلى فتحة موجودة بخلاف فتحة الإنتاج. إذا لم يتم تحديد هذا الخيار، فسيتم نشر Azure App Service في فتحة الإنتاج.


ResourceGroupName - مجموعة الموارد
string. مطلوب عند DeployToSlotFlag = true.

حدد مجموعة موارد Azure التي تحتوي على Azure App Service المحددة أعلاه.


SlotName - فتحه
string. مطلوب عند DeployToSlotFlag = true.

حدد فتحة موجودة بخلاف فتحة الإنتاج.


ImageSource - مصدر الصورة
string. ‏‏اختياري. استخدم عندما WebAppKind = applinux || WebAppKind = linux. القيم المسموح بها: Registry (سجل الحاوية)، Builtin (صورة مضمنة). القيمة الافتراضية: Registry.

تقدم App Service على Linux خيارين مختلفين لنشر تطبيقك:

توزيع الصور المخصصة أو نشر التطبيق باستخدام صورة النظام الأساسي المضمنة.


AzureContainerRegistry - التسجيل
string. مطلوب عند ImageSource = AzureContainerRegistry.

اسم مجال فريد من المستوى الأعلى عالميا لسجلك المحدد.

ملاحظة: سيكون اسم الصورة المؤهل بالكامل بالتنسيق: <registry>/<repository>:.<tag> على سبيل المثال، myregistry.azurecr.io/nginx:latest.


AzureContainerRegistryLoginServer - اسم خادم تسجيل الدخول إلى السجل
string. ‏‏اختياري. استخدم عندما ImageSource = invalidimagesource.

حدد اسم خادم تسجيل الدخول إلى سجل حاوية Azure.


AzureContainerRegistryImage - الصوره
string. مطلوب عند ImageSource = AzureContainerRegistry.

اسم المستودع حيث يتم تخزين صور الحاوية.

ملاحظة: سيكون اسم الصورة المؤهل بالكامل بالتنسيق: <registry>/<repository>:.<tag> على سبيل المثال، myregistry.azurecr.io/nginx:.latest


AzureContainerRegistryTag - العلامه
string. ‏‏اختياري. استخدم عندما ImageSource = AzureContainerRegistry.

هذه هي الآلية التي تستخدمها السجلات لمنح صور Docker إصدارا.

ملاحظة: سيكون اسم الصورة المؤهل بالكامل بالتنسيق: <registry>/<repository>:.<tag> على سبيل المثال، myregistry.azurecr.io/nginx:.latest


DockerRepositoryAccess - الوصول إلى المستودع
string. مطلوب عند ImageSource = invalidImage. القيم المسموح بها: private، . public القيمة الافتراضية: public.

حدد الوصول إلى مستودع Docker.


dockerRegistryConnection - اتصال السجل
الاسم المستعار للإدخل: RegistryConnectedServiceName. string. مطلوب عند DockerRepositoryAccess = private || ImageSource = PrivateRegistry.

حدد اتصال التسجيل.


PrivateRegistryImage - الصوره
string. مطلوب عند ImageSource = PrivateRegistry.

اسم المستودع حيث يتم تخزين صور الحاوية.

ملاحظة: سيكون اسم الصورة المؤهل بالكامل بالتنسيق: <registry><repository>:<tag>. على سبيل المثال، myregistry.azurecr.io/nginx:.latest


PrivateRegistryTag - العلامه
string. ‏‏اختياري. استخدم عندما ImageSource = PrivateRegistry.

العلامات هي الآلية التي تستخدمها السجلات لمنح صور Docker إصدارا.

ملاحظة: سيكون اسم الصورة المؤهل بالكامل بالتنسيق: '<registry>/<repository>:<tag>'. على سبيل المثال، myregistry.azurecr.io/nginx:.latest


DockerNamespace - السجل أو مساحة الاسم
string. مطلوب عند WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Registry.

اسم مجال فريد من المستوى الأعلى عالميا للسجل أو مساحة الاسم المحددة.

ملاحظة: سيكون اسم الصورة المؤهل بالكامل بالتنسيق: <registry or namespace>/<repository>:.<tag> على سبيل المثال، myregistry.azurecr.io/nginx:.latest


DockerRepository - الصوره
string. مطلوب عند WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Registry.

اسم المستودع حيث يتم تخزين صور الحاوية.

ملاحظة: سيكون اسم الصورة المؤهل بالكامل بالتنسيق: '<registry or namespace>/<repository>:.<tag> على سبيل المثال، myregistry.azurecr.io/nginx:.latest


DockerImageTag - العلامه
string. ‏‏اختياري. استخدم عندما WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Registry.

هذه هي الآلية التي تستخدمها السجلات لمنح صور Docker إصدارا.

ملاحظة: سيكون اسم الصورة المؤهل بالكامل بالتنسيق: '<registry or namespace>/<repository>:<tag>'. على سبيل المثال، myregistry.azurecr.io/nginx:.latest


VirtualApplication - التطبيق الظاهري
string. ‏‏اختياري. استخدم عندما WebAppKind != linux && WebAppKind != applinux && WebAppKind != "".

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


Package - الحزمة أو المجلد
string. مطلوب عند WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". القيمة الافتراضية: $(System.DefaultWorkingDirectory)/**/*.zip.

مسار الملف إلى الحزمة أو مجلد يحتوي على محتويات خدمة التطبيق التي تم إنشاؤها بواسطة MSBuild أو ملف مضغوط أو ملف حرب.

المتغيرات هي الإنشاءوالإصدار. يتم دعم أحرف البدل.

على سبيل المثال، $(System.DefaultWorkingDirectory)/\*\*/\*.zip أو $(System.DefaultWorkingDirectory)/\*\*/\*.war.


packageForLinux - الحزمة أو المجلد
الاسم المستعار للإدخل: BuiltinLinuxPackage. string. مطلوب عند WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin. القيمة الافتراضية: $(System.DefaultWorkingDirectory)/**/*.zip.

مسار الملف إلى الحزمة أو مجلد يحتوي على محتويات خدمة التطبيق التي تم إنشاؤها بواسطة MSBuild أو ملف مضغوط أو ملف حرب.

المتغيرات هي الإنشاءوالإصدار. يتم دعم أحرف البدل.

على سبيل المثال، $(System.DefaultWorkingDirectory)/\*\*/\*.zip أو $(System.DefaultWorkingDirectory)/\*\*/\*.war.


RuntimeStack - مكدس وقت التشغيل
string. مطلوب عند WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin.

حدد إطار العمل والإصدار.


StartupCommand - أمر بدء التشغيل
string. ‏‏اختياري. استخدم عندما WebAppKind = applinux || WebAppKind = linux.

حدد أمر بدء التشغيل.


WebAppUri - عنوان URL لخدمة التطبيقات
string. ‏‏اختياري. استخدم عندما WebAppKind != "".

حدد اسما لمتغير الإخراج الذي تم إنشاؤه لعنون URL لخدمة تطبيقات Azure. يمكن استخدام المتغير في المهام اللاحقة.


ScriptType - نوع البرنامج النصي للتوزيع
string. ‏‏اختياري. استخدم عندما WebAppKind != "". القيم المسموح بها: Inline Script، File Path (مسار ملف البرنامج النصي).

تخصيص التوزيع عن طريق توفير برنامج نصي سيتم تشغيله على خدمة Azure App بمجرد إكمال المهمة للتوزيع بنجاح . على سبيل المثال، يمكن أن يؤدي ذلك إلى استعادة الحزم لتطبيقات Node وPHP وPython. تعرف على المزيد حول Azure App Service Deployment.


InlineScript - البرنامج النصي المضمن
string. مطلوب عند ScriptType == Inline Script && WebAppKind != "". القيمة الافتراضية: :: You can provide your deployment commands here. One command per line..


ScriptPath - مسار البرنامج النصي للتوزيع
string. مطلوب عند ScriptType == File Path && WebAppKind != "".


GenerateWebConfig - إنشاء Web.config
boolean. ‏‏اختياري. استخدم عندما WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. القيمة الافتراضية: false.

سيتم إنشاء معيار Web.config ونشره في Azure App Service إذا لم يكن التطبيق يحتوي على واحد. يمكن تحرير القيم في web.config وتختلف استنادا إلى إطار عمل التطبيق. على سبيل المثال، بالنسبة node.js للتطبيق، web.config سيكون لديك قيم ملف بدء التشغيل والوحدة النمطية iis_node . تعرف على المزيد حول Azure App Service Deployment.


WebConfigParameters - معلماتWeb.config
string. مطلوب عند GenerateWebConfig == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war.

تحرير قيم مثل ملفات بدء التشغيل في الملف الذي تم web.config إنشاؤه. ميزة التحرير هذه مخصصة فقط ل web.config. تعرف على المزيد حول Azure App Service Deployment.


AppSettings - إعدادات التطبيق
string.

تحرير إعدادات تطبيق تطبيق الويب بعد بناء الجملة -قيمة المفتاح . يجب إحاطة القيم التي تحتوي على مسافات بعلامات اقتباس مزدوجة. أمثلة: -Port 5000-RequestTimeout 5000-WEBSITE_TIME_ZONE"Eastern Standard Time".


ConfigurationSettings - إعدادات التكوين
string.

تحرير إعدادات تكوين تطبيق الويب باتباع قيمة بناء الجملة -key . يجب إحاطة القيم التي تحتوي على مسافات بعلامات اقتباس مزدوجة.

أمثلة: -phpVersion 5.6-linuxFxVersion: node|6.11.


TakeAppOfflineFlag - وضع التطبيق دون اتصال
boolean. ‏‏اختياري. استخدم عندما WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". القيمة الافتراضية: false.

استخدم هذا الخيار لجعل Azure App Service دون اتصال عن طريق وضع app_offline.htm ملف في الدليل الجذر لخدمة التطبيقات قبل بدء عملية المزامنة. ستتم إزالة الملف بعد اكتمال عملية المزامنة بنجاح.


UseWebDeploy - النشر باستخدام Web Deploy
boolean. ‏‏اختياري. استخدم عندما WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". القيمة الافتراضية: false.

Publish using Web Deploy يتم دعم الخيارات فقط عند استخدام عامل Windows. على الأنظمة الأساسية الأخرى، تعتمد المهمة على واجهات برمجة تطبيقات Kudu REST لنشر Azure App Service، ولا يتم دعم الخيارات التالية.


SetParametersFile - ملف SetParameters
string. ‏‏اختياري. استخدم عندما UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "".

موقع الملف المراد SetParameters.xml استخدامه.


RemoveAdditionalFilesFlag - إزالة ملفات إضافية في الوجهة
boolean. ‏‏اختياري. استخدم عندما UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". القيمة الافتراضية: false.

استخدم هذا الخيار لحذف الملفات على Azure App Service التي لا تحتوي على ملفات مطابقة في حزمة أو مجلد App Service.

ملاحظة: سيؤدي ذلك أيضا إلى إزالة جميع الملفات المتعلقة بأي ملحق مثبت على Azure App Service. لمنع ذلك، حدد خانة Exclude files from App_Data folder الاختيار.


ExcludeFilesFromAppDataFlag - استبعاد الملفات من مجلد App_Data
boolean. ‏‏اختياري. استخدم عندما UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". القيمة الافتراضية: false.

استخدم هذا الخيار لمنع نشر الملفات الموجودة App_Data في المجلد إلى/حذفها من Azure App Service.


AdditionalArguments - وسيطات إضافية
string. ‏‏اختياري. استخدم عندما UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "".

وسيطات Web Deploy الإضافية التي تتبع بناء الجملة -key:value.

سيتم تطبيق هذه عند توزيع Azure App Service. أمثلة: -disableLink:AppPoolExtension-disableLink:ContentExtension.

راجع المزيد من الأمثلة على Web Deploy Operation Settings.


RenameFilesFlag - إعادة تسمية الملفات المؤمنة
boolean. ‏‏اختياري. استخدم عندما UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". القيمة الافتراضية: false.

استخدم هذا الخيار لتمكين علامة MSDEPLOY_RENAME_LOCKED_FILES=1 msdeploy في إعدادات تطبيق Azure App Service. يتيح الخيار msdeploy لإعادة تسمية الملفات المؤمنة التي تم تأمينها أثناء نشر التطبيق.


enableXmlTransform - تحويل XML
الاسم المستعار للإدخل: XmlTransformation. boolean. ‏‏اختياري. استخدم عندما WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. القيمة الافتراضية: false.

سيتم تشغيل تحويلات التكوين ل *.Release.config و *.<EnvironmentName>.config على *.config file.

سيتم تشغيل تحويلات التكوين قبل استبدال المتغير.

يتم دعم تحويلات XML فقط للنظام الأساسي ل Windows.


enableXmlVariableSubstitution - استبدال متغير XML
الاسم المستعار للإدخل: XmlVariableSubstitution. boolean. ‏‏اختياري. استخدم عندما WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. القيمة الافتراضية: false.

سيتم مطابقة المتغيرات المحددة في البنية الأساسية لبرنامج ربط العمليات التجارية للإنشاء أو الإصدار مع key الإدخالات أو name في appSettingsأقسام و applicationSettingsو connectionStrings لأي ملف تكوين و parameters.xml. يتم تشغيل استبدال المتغير بعد تحويلات التكوين.

ملاحظة: إذا تم تعريف نفس المتغيرات في البنية الأساسية لبرنامج ربط العمليات التجارية للإصدار وفي البيئة، فستستبدل متغيرات البيئة متغيرات مسار الإصدار.


JSONFiles - استبدال متغير JSON
string. ‏‏اختياري. استخدم عندما WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war.

يوفر قائمة جديدة مفصولة بخطوط من ملفات JSON لاستبدال قيم المتغير. سيتم توفير أسماء الملفات بالنسبة إلى المجلد الجذر.

لاستبدال متغيرات JSON المتداخلة أو الهرمية، حددها باستخدام JSONPath التعبيرات.

على سبيل المثال، لاستبدال قيمة ConnectionString في العينة أدناه، تحتاج إلى تعريف متغير كما هو الحال Data.DefaultConnection.ConnectionString في البنية الأساسية لبرنامج ربط العمليات التجارية للبناء/الإصدار (أو بيئة البنية الأساسية لبرنامج ربط العمليات التجارية للإصدار).

{
  "Data": {
    "DefaultConnection": {
      "ConnectionString": "Server=(localdb)\SQLEXPRESS;Database=MyDB;Trusted_Connection=True"
    }
  }
}

يتم تشغيل استبدال المتغير بعد تحويلات التكوين.

ملاحظة: يتم استبعاد متغيرات البنية الأساسية لبرنامج ربط العمليات التجارية في الاستبدال.


خيارات التحكم بالمهمة

تحتوي جميع المهام على خيارات التحكم بالإضافة إلى مدخلات المهام الخاصة بها. لمزيد من المعلومات، راجع خيارات التحكم وخصائص المهمة الشائعة.

متغيرات الإخراج

لا شيء

الملاحظات

يتوفر إصدار أحدث من هذه المهمة. لمزيد من المعلومات، راجع AzureRmWebAppDeployment@4.

استكشاف الأخطاء وإصلاحها

لا يمكنني نشر الويب إلى Azure App Service باستخدام مصادقة Microsoft Entra ID من وكيل Windows الخاص بي

تدعم مهمة توزيع Azure App Service الاتصال ب Microsoft Azure باستخدام اتصال خدمة ARM باستخدام Microsoft Entra ID، ما لم تكن الشروط الثلاثة التالية موجودة:

  • أنت تستخدم تنسيق حزمة Web Deploy على عامل Windows
  • يعمل عاملك بإصدار أقدم من msdeploy.exe (على سبيل المثال عند استخدام صورة العامل المستضاف في windows-2019 )
  • تم تعطيل المصادقة الأساسية لخدمة تطبيقات Azure

إذا كانت هذه الشروط الثلاثة موجودة، فستتلقى خطأ مثل App Service is configured to not use basic authentication. This requires Web Deploy msdeploy.exe version 7.1.7225.2108 or higher. You need a version of Visual Studio that includes an updated version of msdeploy.exe. For more information, visit https://aka.ms/azdo-webapp-msdeploy.

لحل هذه المشكلة، يمكنك الاختيار من بين الخيارات التالية، بترتيب التفضيل.

  1. تحديث صورة العامل. إذا كنت تستخدم عوامل مستضافة، فانتقل من windows-2019 إلى windows-2022 (أو windows-latest). إذا كنت تستخدم عوامل مستضافة ذاتيا، فقم بتثبيت Visual Studio 2022 على العامل للحصول على إصدار أحدث من msdeploy.exe.
  2. إذا كنت تعتمد على صورة عامل أقدم ولا يمكنك تحديث العامل للبنية الأساسية لبرنامج ربط العمليات التجارية الخاصة بك، ففكر في تقسيم المهمة بحيث يتم تشغيل مهمة توزيع Azure App Service على windows-2022 (أو windows-latest).
  3. إذا لم يكن أي من هذين الخيارين ممكنا، يمكنك تمكين المصادقة الأساسية لخدمة تطبيقات Azure.

المتطلبات

المتطلبات الوصف
أنواع البنية الأساسية لبرنامج ربط العمليات التجارية YAML، الإصدار الكلاسيكي، الإصدار الكلاسيكي
يعمل على Agent, DeploymentGroup
المطالب بلا
القدرات لا تفي هذه المهمة بأي طلبات للمهام اللاحقة في الوظيفة.
قيود الأوامر أي
متغيرات Settable أي
إصدار الوكيل 2.104.1 أو أحدث
فئة المهمة نشر