AzureRmWebAppDeployment@3 : Servizio app di Azure distribuire l'attività v3

Articolo
07/02/2024

Usare questa attività per eseguire la distribuzione in Servizio app di Azure un'app Web, per dispositivi mobili o per le API usando Docker, Java, .NET, .NET Core, Node.js, PHP, Python o Ruby.

Nota

Usare AzureFunctionApp@1 per distribuire app Funzioni di Azure.

Aggiornare i servizi di app Azure in Windows, App Web in Linux con immagini o contenitori Docker predefiniti, ASP.NET, .NET Core, PHP, Python o Node.js applicazioni Web basate su app per le funzioni, app per dispositivi mobili, applicazioni API e processi Web con API REST di distribuzione Web/Kudu.

Sintassi

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

Input

azureSubscription - Sottoscrizione di Azure
Alias di input: ConnectedServiceName. string. Obbligatorio.

Specificare la sottoscrizione di Azure Resource Manager per la distribuzione.

appType - Tipo di app
Alias di input: WebAppKind. string. Obbligatorio. Valori consentiti: app (App Web), (App Web Linux), applinux (App Web Linux), functionapp (App per le funzioni (scelta non consigliata, usare Funzioni di Azure attività)), api (app per le API), mobileapp (app per dispositivi mobili). Valore predefinito: app.

Specificare il tipo di app Web da distribuire.

Nota: specificare App Web Linux per le immagini della piattaforma predefinite o le distribuzioni di immagini del contenitore personalizzate.

appType - Tipo di app
Alias di input: WebAppKind. string. Obbligatorio. Valori consentiti: app (App Web), applinux (App Web Linux), functionapp (App per le funzioni), api (app per le API), mobileapp (app per dispositivi mobili). Valore predefinito: app.

Specificare il tipo di app Web da distribuire.

Nota: specificare App Web Linux per le immagini della piattaforma predefinite o le distribuzioni di immagini del contenitore personalizzate.

WebAppName - nome servizio app
string. Obbligatorio.

Specificare il nome di un Servizio app di Azure esistente. I servizi app basati sul tipo di app selezionato verranno elencati solo quando si usa l'attività assistente.

DeployToSlotFlag - Eseguire la distribuzione nello slot
boolean. facoltativo. Usare quando WebAppKind != "". Valore predefinito: false.

Usare questa opzione per eseguire la distribuzione in uno slot esistente diverso dallo slot di produzione. Se questa opzione non è selezionata, il Servizio app di Azure verrà distribuito nello slot di produzione.

ResourceGroupName - Gruppo di risorse
string. Obbligatorio quando DeployToSlotFlag = true.

Specificare il gruppo di risorse di Azure che contiene il Servizio app di Azure specificato in precedenza.

SlotName - Slot
string. Obbligatorio quando DeployToSlotFlag = true.

Specificare uno slot esistente diverso da quello di produzione.

ImageSource - Origine immagine
string. facoltativo. Usare quando WebAppKind = applinux || WebAppKind = linux. Valori consentiti: Registry (Registro Contenitori), Builtin (Immagine predefinita). Valore predefinito: Registry.

Servizio app in Linux offre due diverse opzioni per pubblicare l'applicazione:

Distribuzione di immagini personalizzate o distribuzione di app con un'immagine della piattaforma predefinita.

AzureContainerRegistry - Registro
string. Obbligatorio quando ImageSource = AzureContainerRegistry.

Nome di dominio di primo livello univoco globale per il registro specifico.

Nota: un nome di immagine completo sarà del formato: <registry>/<repository>:.<tag> Ad esempio, myregistry.azurecr.io/nginx:latest.

AzureContainerRegistryLoginServer - Nome del server di accesso del Registro di sistema
string. facoltativo. Usare quando ImageSource = invalidimagesource.

Specificare un nome del server di accesso del Registro Azure Container.

AzureContainerRegistryImage - Immagine
string. Obbligatorio quando ImageSource = AzureContainerRegistry.

Nome del repository in cui vengono archiviate le immagini del contenitore.

Nota: un nome di immagine completo sarà del formato: <registry>/<repository>:.<tag> Ad esempio, myregistry.azurecr.io/nginx:latest.

AzureContainerRegistryTag - Tag
string. facoltativo. Usare quando ImageSource = AzureContainerRegistry.

Questo è il meccanismo usato dai registri per assegnare alle immagini Docker una versione.

Nota: un nome di immagine completo sarà del formato: <registry>/<repository>:.<tag> Ad esempio, myregistry.azurecr.io/nginx:latest.

DockerRepositoryAccess - Accesso al repository
string. Obbligatorio quando ImageSource = invalidImage. Valori consentiti: private, public. Valore predefinito: public.

Specificare l'accesso al repository Docker.

dockerRegistryConnection - Connessione al Registro di sistema
Alias di input: RegistryConnectedServiceName. string. Obbligatorio quando DockerRepositoryAccess = private || ImageSource = PrivateRegistry.

Specificare la connessione al Registro di sistema.

PrivateRegistryImage - Immagine
string. Obbligatorio quando ImageSource = PrivateRegistry.

Nome del repository in cui vengono archiviate le immagini del contenitore.

Nota: un nome di immagine completo sarà del formato: <registry><repository>:<tag>. Ad esempio, myregistry.azurecr.io/nginx:latest.

PrivateRegistryTag - Tag
string. facoltativo. Usare quando ImageSource = PrivateRegistry.

I tag sono il meccanismo usato dai registri per assegnare alle immagini Docker una versione.

Nota: un nome di immagine completo sarà del formato : '<registry>/<repository>:<tag>'. Ad esempio, myregistry.azurecr.io/nginx:latest.

DockerNamespace - Registro di sistema o spazio dei nomi
string. Obbligatorio quando WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Registry.

Nome di dominio di primo livello univoco globale per il registro o lo spazio dei nomi specifico.

Nota: un nome di immagine completo sarà del formato: <registry or namespace>/<repository>:.<tag> Ad esempio, myregistry.azurecr.io/nginx:latest.

DockerRepository - Immagine
string. Obbligatorio quando WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Registry.

Nome del repository in cui vengono archiviate le immagini del contenitore.

Nota: un nome di immagine completo sarà del formato: '<registry or namespace>/<repository>:.<tag> Ad esempio, myregistry.azurecr.io/nginx:latest.

DockerImageTag - Tag
string. facoltativo. Usare quando WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Registry.

Questo è il meccanismo usato dai registri per assegnare alle immagini Docker una versione.

Nota: un nome di immagine completo sarà del formato : '<registry or namespace>/<repository>:<tag>'. Ad esempio, myregistry.azurecr.io/nginx:latest.

VirtualApplication - Applicazione virtuale
string. facoltativo. Usare quando WebAppKind != linux && WebAppKind != applinux && WebAppKind != "".

Specificare il nome dell'applicazione virtuale configurata nel portale di Azure. L'opzione non è necessaria per le distribuzioni nella radice servizio app.

Package - Pacchetto o cartella
string. Obbligatorio quando WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Valore predefinito: $(System.DefaultWorkingDirectory)/**/*.zip.

Percorso del file del pacchetto o di una cartella contenente il contenuto del servizio app generato da MSBuild o da un file ZIP o war compresso.

Le variabili sono Build e Release. Sono supportati caratteri jolly .

Ad esempio, $(System.DefaultWorkingDirectory)/\*\*/\*.zip o $(System.DefaultWorkingDirectory)/\*\*/\*.war.

packageForLinux - Pacchetto o cartella
Alias di input: BuiltinLinuxPackage. string. Obbligatorio quando WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin. Valore predefinito: $(System.DefaultWorkingDirectory)/**/*.zip.

Percorso del file del pacchetto o di una cartella contenente il contenuto del servizio app generato da MSBuild o da un file ZIP o war compresso.

Le variabili sono Build e Release. Sono supportati caratteri jolly .

Ad esempio, $(System.DefaultWorkingDirectory)/\*\*/\*.zip o $(System.DefaultWorkingDirectory)/\*\*/\*.war.

RuntimeStack - Runtime Stack
string. Obbligatorio quando WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin.

Specificare il framework e la versione.

StartupCommand - Comando di avvio
string. facoltativo. Usare quando WebAppKind = applinux || WebAppKind = linux.

Specificare il comando di avvio.

WebAppUri - URL servizio app
string. facoltativo. Usare quando WebAppKind != "".

Specificare un nome per la variabile di output generata per l'URL del Servizio app di Azure. La variabile può essere usata nelle attività successive.

ScriptType - Tipo di script di distribuzione
string. facoltativo. Usare quando WebAppKind != "". Valori consentiti: Inline Script, File Path (Percorso file script).

Personalizza la distribuzione fornendo uno script che verrà eseguito nel servizio app Azure dopo che l'attività ha completato correttamente la distribuzione. Ad esempio, questo può ripristinare i pacchetti per le applicazioni Node, PHP e Python. Altre informazioni sulla distribuzione di Servizio app di Azure.

InlineScript - Inline Script
string. Obbligatorio quando ScriptType == Inline Script && WebAppKind != "". Valore predefinito: :: You can provide your deployment commands here. One command per line..

ScriptPath - Percorso dello script di distribuzione
string. Obbligatorio quando ScriptType == File Path && WebAppKind != "".

GenerateWebConfig - Generare Web.config
boolean. facoltativo. Usare quando WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Valore predefinito: false.

Verrà generato e distribuito uno standard Web.config in Servizio app di Azure se l'applicazione non ne ha una. I valori in web.config possono essere modificati e variano in base al framework dell'applicazione. Ad esempio, per l'applicazione node.js , web.config avrà valori di file di avvio e iis_node modulo. Altre informazioni sulla distribuzione di Servizio app di Azure.

WebConfigParameters - parametriWeb.config
string. Obbligatorio quando GenerateWebConfig == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war.

Modifica i valori come i file di avvio nel file generato web.config . Questa funzionalità di modifica è solo per l'oggetto generato web.config. Altre informazioni sulla distribuzione di Servizio app di Azure.

AppSettings - Impostazioni dell'app
string.

Modifica le impostazioni dell'applicazione dell'app Web seguendo la sintassi -key value . I valori contenenti spazi devono essere racchiusi tra virgolette doppie. Esempi: -Port 5000-RequestTimeout 5000-WEBSITE_TIME_ZONE"Eastern Standard Time".

ConfigurationSettings - Impostazioni di configurazione
string.

Modifica le impostazioni di configurazione dell'app Web seguendo il valore della sintassi -key . I valori contenenti spazi devono essere racchiusi tra virgolette doppie.

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

TakeAppOfflineFlag - Portare l'app offline
boolean. facoltativo. Usare quando WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Valore predefinito: false.

Usare questa opzione per portare offline il Servizio app di Azure inserendo un app_offline.htm file nella directory radice del servizio app prima dell'inizio dell'operazione di sincronizzazione. Il file verrà rimosso al termine dell'operazione di sincronizzazione.

UseWebDeploy - Pubblicare con Distribuzione Web
boolean. facoltativo. Usare quando WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Valore predefinito: false.

Publish using Web Deploy le opzioni sono supportate solo quando si usa l'agente Windows. In altre piattaforme, l'attività si basa sulle API REST Kudu per distribuire il Servizio app di Azure e le opzioni seguenti non sono supportate.

SetParametersFile - File SetParameters
string. facoltativo. Usare quando UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "".

Percorso del SetParameters.xml file da utilizzare.

RemoveAdditionalFilesFlag - Rimuovere file aggiuntivi nella destinazione
boolean. facoltativo. Usare quando UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Valore predefinito: false.

Utilizzare questa opzione per eliminare i file nel Servizio app di Azure che non hanno file corrispondenti nel pacchetto o nella cartella servizio app.

Nota: verranno rimossi anche tutti i file correlati a qualsiasi estensione installata in questa Servizio app di Azure. Per evitare questo problema, selezionare la Exclude files from App_Data folder casella di controllo .

ExcludeFilesFromAppDataFlag - Escludere i file dalla cartella App_Data
boolean. facoltativo. Usare quando UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Valore predefinito: false.

Usare questa opzione per impedire la distribuzione o l'eliminazione dei file nella App_Data cartella dal Servizio app di Azure.

AdditionalArguments - Argomenti aggiuntivi
string. facoltativo. Usare quando UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "".

Argomenti aggiuntivi distribuzione Web che seguono la sintassi -key:value.

Queste verranno applicate durante la distribuzione del Servizio app di Azure. Esempi: -disableLink:AppPoolExtension-disableLink:ContentExtension.

Vedere altri esempi di impostazioni dell'operazione di distribuzione Web.

RenameFilesFlag - Rinominare i file bloccati
boolean. facoltativo. Usare quando UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Valore predefinito: false.

Usare questa opzione per abilitare il flag MSDEPLOY_RENAME_LOCKED_FILES=1 msdeploy nelle impostazioni dell'applicazione Servizio app di Azure. L'opzione consente a msdeploy di rinominare i file bloccati bloccati durante la distribuzione dell'app.

enableXmlTransform - Trasformazione XML
Alias di input: XmlTransformation. boolean. facoltativo. Usare quando WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Valore predefinito: false.

Le trasformazioni di configurazione verranno eseguite per *.Release.config e *.<EnvironmentName>.config in *.config file.

Le trasformazioni di configurazione verranno eseguite prima della sostituzione delle variabili.

Le trasformazioni XML sono supportate solo per la piattaforma Windows.

enableXmlVariableSubstitution - Sostituzione di variabili XML
Alias di input: XmlVariableSubstitution. boolean. facoltativo. Usare quando WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Valore predefinito: false.

Le variabili definite nella pipeline di compilazione o versione verranno confrontate con le key voci o name nelle appSettingssezioni , applicationSettingse connectionStrings di qualsiasi file di configurazione e parameters.xml. La sostituzione delle variabili viene eseguita dopo le trasformazioni di configurazione.

Nota: se le stesse variabili sono definite nella pipeline di versione e nell'ambiente, le variabili di ambiente sostituiscono le variabili della pipeline di versione.

JSONFiles - Sostituzione di variabili JSON
string. facoltativo. Usare quando WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war.

Fornisce un nuovo elenco delimitato da righe di file JSON per sostituire i valori delle variabili. I nomi dei file devono essere forniti in relazione alla cartella radice.

Per sostituire le variabili JSON annidate o gerarchiche, specificarle usando JSONPath le espressioni.

Ad esempio, per sostituire il valore di ConnectionString nell'esempio seguente, è necessario definire una variabile come Data.DefaultConnection.ConnectionString nella pipeline di compilazione/versione (o nell'ambiente della pipeline di versione).

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

La sostituzione delle variabili viene eseguita dopo le trasformazioni di configurazione.

Nota: le variabili della pipeline vengono escluse nella sostituzione.

Opzioni di controllo delle attività

Tutte le attività dispongono di opzioni di controllo oltre ai relativi input attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

Nessuno.

Osservazioni

È disponibile una versione più recente di questa attività. Per altre informazioni, vedere AzureRmWebAppDeployment@4.

Risoluzione dei problemi

Non è possibile eseguire la distribuzione Web nel Servizio app di Azure usando l'autenticazione di Microsoft Entra ID dall'agente Windows

L'attività di distribuzione Servizio app di Azure supporta la connessione a Microsoft Azure con una connessione al servizio ARM tramite Microsoft Entra ID, a meno che non siano presenti le tre condizioni seguenti:

Si usa il formato del pacchetto Distribuzione Web in un agente Windows
L'agente è in esecuzione con una versione precedente di msdeploy.exe (ad esempio quando si usa l'immagine dell'agente ospitato windows-2019 )
L'autenticazione di base è disabilitata per il Servizio app di Azure

Se queste tre condizioni sono presenti, si riceverà un errore simile al seguente 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.

Per risolvere questo problema, è possibile scegliere tra le opzioni seguenti, in ordine di preferenza.

Aggiornare l'immagine dell'agente. Se si usano agenti ospitati, passare da windows-2019 a windows-2022 (o windows-latest). Se si usano agenti self-hosted, installare Visual Studio 2022 nell'agente per ottenere una versione più recente di msdeploy.exe.
Se si dipende da un'immagine dell'agente precedente e non è possibile aggiornare l'agente per la pipeline, è consigliabile suddividere il processo in modo che l'attività di distribuzione Servizio app di Azure venga eseguita in Windows-2022 (o windows-latest).
Se nessuna di queste opzioni è possibile, è possibile abilitare l'autenticazione di base per il Servizio app di Azure.

Requisiti

Requisito	Descrizione
Tipi di pipeline	YAML, build classica, versione classica
Viene eseguito in	Agente, DeploymentGroup
Richieste	Nessuno
Capabilities	Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi	Qualsiasi
Variabili impostabili	Qualsiasi
Versione agente	2.104.1 o versione successiva
Categoria attività	Distribuire

Condividi tramite

AzureRmWebAppDeployment@3 : Servizio app di Azure distribuire l'attività v3

Sintassi

Input

Opzioni di controllo delle attività

Variabili di output

Osservazioni

Risoluzione dei problemi

Non è possibile eseguire la distribuzione Web nel Servizio app di Azure usando l'autenticazione di Microsoft Entra ID dall'agente Windows

Requisiti

Commenti e suggerimenti

Risorse aggiuntive