AzureRmWebAppDeployment@3 - Azure App Service déployer la tâche v3

Article
07/02/2024

Utilisez cette tâche pour déployer sur Azure App Service une application web, mobile ou API à l’aide de Docker, Java, .NET, .NET Core, Node.js, PHP, Python ou Ruby.

Notes

Utilisez AzureFunctionApp@1 pour déployer Azure Functions applications.

Mettez à jour Azure App Services sur Windows, Web App sur Linux avec des images intégrées ou des conteneurs Docker, ASP.NET, .NET Core, PHP, Python ou des applications web basées sur Node.js, Des applications de fonction, des applications mobiles, des applications API et des travaux web à l’aide des API REST Web Deploy/Kudu.

Syntax

# 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.

Entrées

azureSubscription - Abonnement Azure
Alias d’entrée : ConnectedServiceName. string. Obligatoire.

Spécifiez l’abonnement Azure Resource Manager pour le déploiement.

appType - Type d’application
Alias d’entrée : WebAppKind. string. Obligatoire. Valeurs autorisées : app (Application web), applinux (Application web Linux), functionapp (Application de fonction (non recommandé, Utiliser Azure Functions tâche)), api (Application API), mobileapp (Application mobile). Valeur par défaut : app.

Spécifiez le type d’application web à déployer.

Remarque : Spécifiez l’application web Linux pour les images de plateforme intégrées ou les déploiements d’images conteneur personnalisées.

appType - Type d’application
Alias d’entrée : WebAppKind. string. Obligatoire. Valeurs autorisées : app (Application web), applinux (Application web Linux), functionapp (Application de fonction), api (Application API), mobileapp (Application mobile). Valeur par défaut : app.

Spécifiez le type d’application web à déployer.

Remarque : Spécifiez l’application web Linux pour les images de plateforme intégrées ou les déploiements d’images conteneur personnalisées.

WebAppName - App Service nom
string. Obligatoire.

Spécifiez le nom d’un Azure App Service existant. Les services d’application basés sur le type d’application sélectionné ne sont répertoriés que lors de l’utilisation de l’assistant de tâche.

DeployToSlotFlag - Déployer sur un emplacement
boolean. facultatif. Utilisez quand WebAppKind != "". Valeur par défaut : false.

Utilisez cette option pour déployer sur un emplacement existant autre que l’emplacement de production. Si cette option n’est pas sélectionnée, le Azure App Service sera déployé sur l’emplacement production.

ResourceGroupName - Groupe de ressources
string. Nécessaire lorsque DeployToSlotFlag = true.

Spécifiez le groupe de ressources Azure qui contient le Azure App Service spécifié ci-dessus.

SlotName - Fente
string. Nécessaire lorsque DeployToSlotFlag = true.

Spécifiez un emplacement existant autre que l’emplacement de production.

ImageSource - Source d’image
string. facultatif. Utilisez quand WebAppKind = applinux || WebAppKind = linux. Valeurs autorisées : Registry (Registre de conteneurs), Builtin (Image intégrée). Valeur par défaut : Registry.

App Service sur Linux propose deux options différentes pour publier votre application :

Déploiement d’images personnalisées ou déploiement d’applications avec une image de plateforme intégrée.

AzureContainerRegistry - Registre
string. Nécessaire lorsque ImageSource = AzureContainerRegistry.

Un nom de domaine de premier niveau global unique pour votre registre spécifique.

Remarque : Un nom d’image complet sera au format : <registry>/<repository>:.<tag> Par exemple : myregistry.azurecr.io/nginx:latest.

AzureContainerRegistryLoginServer - Nom du serveur de connexion au Registre
string. facultatif. Utilisez quand ImageSource = invalidimagesource.

Spécifiez un nom de serveur de connexion Azure Container Registry.

AzureContainerRegistryImage - Image
string. Nécessaire lorsque ImageSource = AzureContainerRegistry.

Nom du dépôt dans lequel les images conteneur sont stockées.

Remarque : Un nom d’image complet sera au format : <registry>/<repository>:.<tag> Par exemple, myregistry.azurecr.io/nginx:latest.

AzureContainerRegistryTag - Étiquette
string. facultatif. Utilisez quand ImageSource = AzureContainerRegistry.

Il s’agit du mécanisme utilisé par les registres pour donner une version aux images Docker.

Remarque : Un nom d’image complet sera au format : <registry>/<repository>:.<tag> Par exemple, myregistry.azurecr.io/nginx:latest.

DockerRepositoryAccess - Accès au référentiel
string. Nécessaire lorsque ImageSource = invalidImage. Valeurs autorisées : private, public. Valeur par défaut : public.

Spécifiez l’accès au référentiel Docker.

dockerRegistryConnection - Connexion au Registre
Alias d’entrée : RegistryConnectedServiceName. string. Nécessaire lorsque DockerRepositoryAccess = private || ImageSource = PrivateRegistry.

Spécifiez la connexion au Registre.

PrivateRegistryImage - Image
string. Nécessaire lorsque ImageSource = PrivateRegistry.

Nom du dépôt dans lequel les images conteneur sont stockées.

Remarque : Un nom d’image complet sera au format : <registry><repository>:<tag>. Par exemple, myregistry.azurecr.io/nginx:latest.

PrivateRegistryTag - Étiquette
string. facultatif. Utilisez quand ImageSource = PrivateRegistry.

Les balises sont le mécanisme utilisé par les registres pour donner une version aux images Docker.

Remarque : Un nom d’image complet sera au format « : :<registry>/<repository><tag> ». Par exemple, myregistry.azurecr.io/nginx:latest.

DockerNamespace - Registre ou espace de noms
string. Nécessaire lorsque WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Registry.

Nom de domaine de premier niveau global unique pour votre registre ou espace de noms spécifique.

Remarque : Un nom d’image complet sera au format : <registry or namespace>/<repository>:.<tag> Par exemple, myregistry.azurecr.io/nginx:latest.

DockerRepository - Image
string. Nécessaire lorsque WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Registry.

Nom du dépôt dans lequel les images conteneur sont stockées.

Remarque : Un nom complet d’image sera au format : '<registry or namespace>/<repository> :.<tag> Par exemple, myregistry.azurecr.io/nginx:latest.

DockerImageTag - Étiquette
string. facultatif. Utilisez quand WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Registry.

Il s’agit du mécanisme utilisé par les registres pour donner une version aux images Docker.

Remarque : Un nom d’image complet sera au format : « : ».<registry or namespace>/<repository><tag> Par exemple, myregistry.azurecr.io/nginx:latest.

VirtualApplication - Application virtuelle
string. facultatif. Utilisez quand WebAppKind != linux && WebAppKind != applinux && WebAppKind != "".

Spécifiez le nom de l’application virtuelle qui a été configurée dans le Portail Azure. L’option n’est pas requise pour les déploiements vers la racine App Service.

Package - Package ou dossier
string. Nécessaire lorsque WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Valeur par défaut : $(System.DefaultWorkingDirectory)/**/*.zip.

Chemin d’accès au package ou à un dossier contenant le contenu app service généré par MSBuild ou un fichier zip ou war compressé.

Les variables sont Build et Release. Les caractères génériques sont pris en charge.

Par exemple, $(System.DefaultWorkingDirectory)/\*\*/\*.zip ou $(System.DefaultWorkingDirectory)/\*\*/\*.war.

packageForLinux - Package ou dossier
Alias d’entrée : BuiltinLinuxPackage. string. Nécessaire lorsque WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin. Valeur par défaut : $(System.DefaultWorkingDirectory)/**/*.zip.

Chemin d’accès au package ou à un dossier contenant le contenu app service généré par MSBuild ou un fichier zip ou war compressé.

Les variables sont Build et Release. Les caractères génériques sont pris en charge.

Par exemple, $(System.DefaultWorkingDirectory)/\*\*/\*.zip ou $(System.DefaultWorkingDirectory)/\*\*/\*.war.

RuntimeStack - Pile d’exécution
string. Nécessaire lorsque WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin.

Spécifiez le framework et la version.

StartupCommand - Commande de démarrage
string. facultatif. Utilisez quand WebAppKind = applinux || WebAppKind = linux.

Spécifiez la commande de démarrage.

WebAppUri - URL de App Service
string. facultatif. Utilisez quand WebAppKind != "".

Spécifiez un nom pour la variable de sortie qui est générée pour l’URL du Azure App Service. La variable peut être utilisée dans les tâches suivantes.

ScriptType - Type de script de déploiement
string. facultatif. Utilisez quand WebAppKind != "". Valeurs autorisées : Inline Script, File Path (Chemin du fichier de script).

Personnalise le déploiement en fournissant un script qui s’exécutera sur le service Azure App une fois que la tâche aura terminé le déploiement avec succès. Par exemple, cela peut restaurer des packages pour les applications Node, PHP et Python. En savoir plus sur le déploiement Azure App Service.

InlineScript - Inline Script
string. Nécessaire lorsque ScriptType == Inline Script && WebAppKind != "". Valeur par défaut : :: You can provide your deployment commands here. One command per line..

ScriptPath - Chemin du script de déploiement
string. Nécessaire lorsque ScriptType == File Path && WebAppKind != "".

GenerateWebConfig - Générer des Web.config
boolean. facultatif. Utilisez quand WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Valeur par défaut : false.

Une norme Web.config est générée et déployée sur Azure App Service si l’application n’en a pas. Les valeurs dans web.config peuvent être modifiées et varier en fonction de l’infrastructure de l’application. Par exemple, pour l’application node.js , web.config aura des valeurs de fichier de démarrage et iis_node de module. En savoir plus sur le déploiement Azure App Service.

WebConfigParameters - Web.config paramètres
string. Nécessaire lorsque GenerateWebConfig == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war.

Modifie des valeurs telles que les fichiers de démarrage dans le fichier généré web.config . Cette fonctionnalité de modification concerne uniquement le généré web.config. En savoir plus sur le déploiement Azure App Service.

AppSettings - Paramètres de l’application
string.

Modifie les paramètres de l’application web en suivant la valeur de syntaxe -key . Les valeurs contenant des espaces doivent être placées entre guillemets doubles. Exemples : -Port 5000-RequestTimeout 5000-WEBSITE_TIME_ZONE"Eastern Standard Time".

ConfigurationSettings - Paramètres de configuration
string.

Modifie les paramètres de configuration de l’application web en fonction de la valeur de syntaxe -key . Les valeurs contenant des espaces doivent être placées entre guillemets doubles.

Exemples : -phpVersion 5.6-linuxFxVersion: node|6.11.

TakeAppOfflineFlag - Mise hors connexion de l’application
boolean. facultatif. Utilisez quand WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Valeur par défaut : false.

Utilisez cette option pour mettre le Azure App Service hors connexion en plaçant un app_offline.htm fichier dans le répertoire racine du App Service avant le début de l’opération de synchronisation. Le fichier sera supprimé une fois l’opération de synchronisation terminée.

UseWebDeploy - Publier à l’aide de Web Deploy
boolean. facultatif. Utilisez quand WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Valeur par défaut : false.

Publish using Web Deploy les options sont prises en charge uniquement lors de l’utilisation de l’agent Windows. Sur d’autres plateformes, la tâche s’appuie sur les API REST Kudu pour déployer le Azure App Service, et les options suivantes ne sont pas prises en charge.

SetParametersFile - Fichier SetParameters
string. facultatif. Utilisez quand UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "".

Emplacement du SetParameters.xml fichier à utiliser.

RemoveAdditionalFilesFlag - Supprimer des fichiers supplémentaires à la destination
boolean. facultatif. Utilisez quand UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Valeur par défaut : false.

Utilisez cette option pour supprimer les fichiers sur le Azure App Service qui n’ont aucun fichier correspondant dans le package ou le dossier App Service.

Remarque : cela supprime également tous les fichiers liés à toute extension installée sur ce Azure App Service. Pour éviter cela, cochez la Exclude files from App_Data folder case.

ExcludeFilesFromAppDataFlag - Exclure des fichiers du dossier App_Data
boolean. facultatif. Utilisez quand UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Valeur par défaut : false.

Utilisez cette option pour empêcher le App_Data déploiement/la suppression des fichiers du dossier dans le Azure App Service.

AdditionalArguments - Arguments supplémentaires
string. facultatif. Utilisez quand UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "".

Arguments Web Deploy supplémentaires suivant la syntaxe -key:value.

Sont appliqués pendant le déploiement de l’instance Azure App Service. Exemples : -disableLink:AppPoolExtension-disableLink:ContentExtension.

Consultez d’autres exemples de paramètres d’opération de déploiement web.

RenameFilesFlag - Renommer les fichiers verrouillés
boolean. facultatif. Utilisez quand UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Valeur par défaut : false.

Utilisez cette option pour activer l’indicateur MSDEPLOY_RENAME_LOCKED_FILES=1 msdeploy dans Azure App Service paramètres d’application. L’option permet à msdeploy de renommer les fichiers verrouillés qui sont verrouillés pendant le déploiement de l’application.

enableXmlTransform - Transformation XML
Alias d’entrée : XmlTransformation. boolean. facultatif. Utilisez quand WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Valeur par défaut : false.

Les transformations de configuration seront exécutées pour *.Release.config et *.<EnvironmentName>.config sur .*.config file

Les transformations de configuration seront exécutées avant la substitution de variable.

Les transformations XML sont prises en charge uniquement pour la plateforme Windows.

enableXmlVariableSubstitution - Substitution de variable XML
Alias d’entrée : XmlVariableSubstitution. boolean. facultatif. Utilisez quand WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Valeur par défaut : false.

Les variables définies dans le pipeline de build ou de mise en production seront mises en correspondance avec les entrées ou name dans les appSettingssections , applicationSettingset connectionStrings de tout fichier de configuration et parameters.xml.key La substitution de variable est exécutée après les transformations de configuration.

Remarque : Si les mêmes variables sont définies dans le pipeline de mise en production et dans l’environnement, les variables d’environnement remplacent les variables de pipeline de mise en production.

JSONFiles - Substitution de variable JSON
string. facultatif. Utilisez quand WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war.

Fournit une nouvelle liste de fichiers JSON séparés par des lignes pour remplacer les valeurs de variable. Les noms de fichiers doivent être fournis par rapport au dossier racine.

Pour remplacer des variables JSON imbriquées ou hiérarchiques, spécifiez-les à l’aide d’expressions JSONPath .

Par exemple, pour remplacer la valeur de ConnectionString dans l’exemple ci-dessous, vous devez définir une variable comme Data.DefaultConnection.ConnectionString dans le pipeline de génération/mise en production (ou dans l’environnement du pipeline de mise en production).

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

La substitution de variable est exécutée après les transformations de configuration.

Remarque : les variables de pipeline sont exclues en substitution.

Options de contrôle de la tâche

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâches. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Aucun.

Notes

Une version plus récente de cette tâche est disponible. Pour plus d’informations, consultez AzureRmWebAppDeployment@4.

Dépannage

Je ne parviens pas à déployer web sur mon Azure App Service à l’aide de l’authentification Microsoft Entra ID à partir de mon agent Windows

La tâche de déploiement Azure App Service prend en charge la connexion à Microsoft Azure avec une connexion de service ARM à l’aide de Microsoft Entra ID, sauf si les trois conditions suivantes sont présentes :

Vous utilisez le format de package Web Deploy sur un agent Windows
Votre agent s’exécute avec une version antérieure de msdeploy.exe (par exemple, lors de l’utilisation de l’image de l’agent hébergé windows-2019 )
L’authentification de base est désactivée pour votre Azure App Service

Si ces trois conditions sont présentes, vous recevrez une erreur comme 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.

Pour résoudre ce problème, vous pouvez choisir parmi les options suivantes, par ordre de préférence.

Mettez à jour l’image de l’agent. Si vous utilisez des agents hébergés, passez de windows-2019 à windows-2022 (ou windows-latest). Si vous utilisez des agents auto-hébergés, installez Visual Studio 2022 sur l’agent pour obtenir une version plus récente de msdeploy.exe.
Si vous dépendez d’une image d’agent plus ancienne et que vous ne pouvez pas mettre à jour l’agent pour votre pipeline, envisagez de fractionner le travail afin que la tâche de déploiement Azure App Service s’exécute sur windows-2022 (ou windows-latest).
Si aucune de ces options n’est possible, vous pouvez activer l’authentification de base pour votre Azure App Service.

Configuration requise

Condition requise	Description
Types de pipelines	YAML, build classique, version classique
S’exécute sur	Agent, DeploymentGroup
Demandes	None
Capabilities	Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commandes	Quelconque
Variables settables	Quelconque
Version de l’agent	2.104.1 ou version ultérieure
Catégorie de la tâche	Déployer

Partager via

AzureRmWebAppDeployment@3 - Azure App Service déployer la tâche v3

Syntax

Entrées

Options de contrôle de la tâche

Variables de sortie

Notes

Dépannage

Je ne parviens pas à déployer web sur mon Azure App Service à l’aide de l’authentification Microsoft Entra ID à partir de mon agent Windows

Configuration requise

Commentaires

Ressources supplémentaires