AzureWebApp@1 - Attività App Web di Azure v1

Questa attività distribuisce un'app Web di Azure per Linux o Windows.

Sintassi

# Azure Web App v1
# Deploy an Azure Web App for Linux or Windows.
- task: AzureWebApp@1
  inputs:
    azureSubscription: # string. Required. Azure subscription. 
    appType: # 'webApp' | 'webAppLinux'. Required. App type. 
    appName: # string. Required. App name. 
    #deployToSlotOrASE: false # boolean. Optional. Use when appType != "". Deploy to Slot or App Service Environment. Default: false.
    #resourceGroupName: # string. Required when deployToSlotOrASE = true. Resource group. 
    #slotName: 'production' # string. Required when deployToSlotOrASE = true. Slot. Default: production.
    package: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Required. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #customDeployFolder: # string. Optional. Use when package EndsWith .war. Custom Deploy Folder. 
    #runtimeStack: # string. Optional. Use when appType = webAppLinux. Runtime stack. 
    #startUpCommand: # string. Optional. Use when appType = webAppLinux. Startup command. 
  # Application and Configuration Settings
    #customWebConfig: # string. Optional. Use when appType != webAppLinux && package NotEndsWith .war. Generate web.config parameters for Python, Node.js, Go and Java apps. 
    #appSettings: # string. App settings. 
    #configurationStrings: # string. Configuration settings. 
  # Additional Deployment Options
    #deploymentMethod: 'auto' # 'auto' | 'zipDeploy' | 'runFromPackage'. Required when appType != webAppLinux && appType != "" && package NotEndsWith .war && package NotEndsWith .jar. Deployment method. Default: auto.

Input

azureSubscription - Sottoscrizione di Azure
string. Obbligatorio.

Specifica la connessione alla sottoscrizione di Azure Resource Manager per la distribuzione.

appType - Tipo di app
string. Obbligatorio. Valori consentiti: webApp (App Web in Windows), webAppLinux (App Web in Linux).

Specifica il tipo di app Web di Azure.

appName - Nome app
string. Obbligatorio.

Specifica il nome di un Servizio app di Azure esistente. Verranno elencati solo i servizi app basati sul tipo di app selezionato.

deployToSlotOrASE - Eseguire la distribuzione in slot o ambiente del servizio app
boolean. facoltativo. Usare quando appType != "". Valore predefinito: false.

Seleziona l'opzione per la distribuzione in uno slot di distribuzione esistente o in un ambiente di Servizio app di Azure.
Per entrambe le destinazioni, l'attività richiede un nome di gruppo di risorse.
Se la destinazione di distribuzione è uno slot, il valore predefinito è lo slot di produzione. È anche possibile specificare qualsiasi altro nome di slot esistente.
Se la destinazione di distribuzione è un ambiente di Servizio app di Azure, lasciare il nome dello slot "produzione" e specificare il nome del gruppo di risorse.

resourceGroupName - Gruppo di risorse
string. Obbligatorio quando deployToSlotOrASE = true.

Il nome del gruppo di risorse è necessario quando la destinazione di distribuzione è uno slot di distribuzione o un ambiente di Servizio app di Azure.
Specifica il gruppo di risorse di Azure che contiene il Servizio app di Azure indicato in precedenza.

slotName - Slot
string. Obbligatorio quando deployToSlotOrASE = true. Valore predefinito: production.

Specifica uno slot esistente, escluso lo slot di produzione.

package - Pacchetto o cartella
string. Obbligatorio. Valore predefinito: $(System.DefaultWorkingDirectory)/**/*.zip.

Percorso del file del pacchetto o della cartella che contiene servizio app contenuto generato da MSBuild, da un file ZIP compresso o da un file war. Sono supportate le variabili (versione | di compilazione) e i caratteri jolly. Ad esempio, $(System.DefaultWorkingDirectory)/**/*.zip o $(System.DefaultWorkingDirectory)/**/*.war.

customDeployFolder - Cartella di distribuzione personalizzata
string. facoltativo. Usare quando package EndsWith .war.

Specifica il nome della cartella personalizzata in cui si vuole eseguire la distribuzione.
Se il campo è vuoto, il pacchetto viene distribuito in <appname>.azurewebsites.net/<warpackagename>.
Se viene immesso ROOT, il pacchetto viene distribuito in <appname>.azurewebsited.net.
In tutte le altre istanze, viene distribuito in <appname>.azurewebsited.net/<customWarName>.

runtimeStack - Stack di runtime
string. facoltativo. Usare quando appType = webAppLinux.

App Web in Linux offre due diverse opzioni per pubblicare l'applicazione: distribuzione di immagini personalizzate (App Web per contenitori) e distribuzione di app con un'immagine della piattaforma predefinita (App Web in Linux). Questo parametro è disponibile solo quando l'app Web Linux è selezionata come tipo di app nell'attività.

startUpCommand - Comando di avvio
string. facoltativo. Usare quando appType = webAppLinux.

Specifica il comando di avvio.
Ad esempio:
dotnet run
dotnet filename.dll.

customWebConfig - Generare parametri web.config per le app Python, Node.js, Go e Java
string. facoltativo. Usare quando appType != webAppLinux && package NotEndsWith .war.

Un web.config standard verrà generato e distribuito in Servizio app di Azure se l'applicazione non ne ha una. I valori in web.config variano in base al framework dell'applicazione e possono essere modificati. Ad esempio, per l'applicazione node.js, web.config avrà un file di avvio e iis_node valori del modulo. Questa funzionalità di modifica è solo per il web.configgenerato .

appSettings - Impostazioni dell'app
string.

Specificare le impostazioni dell'applicazione dell'app Web usando la sintassi -key value , ad esempio . -Port 5000-RequestTimeout 5000-WEBSITE_TIME_ZONE Racchiudere i valori che contengono spazi tra virgolette doppie ( ad esempio: "Eastern Standard Time").

configurationStrings - Impostazioni di configurazione
string.

Specificare le impostazioni di configurazione dell'app Web usando la sintassi -key value , ad esempio . -phpVersion 5.6-linuxFxVersion: node|6.11 Racchiudere i valori che contengono spazi tra virgolette doppie.

deploymentMethod - Metodo di distribuzione
string. Obbligatorio quando appType != webAppLinux && appType != "" && package NotEndsWith .war && package NotEndsWith .jar. Valori consentiti: auto (rilevamento automatico), zipDeploy (Distribuzione zip), runFromPackage (Esegui dal pacchetto). Valore predefinito: auto.

Scegliere il metodo di distribuzione per l'app. I valori accettabili sono auto, zipDeploy e runFromPackage.

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

Questa attività definisce le variabili di output seguenti, che è possibile utilizzare nei passaggi downstream, nei processi e nelle fasi.

AppServiceApplicationUrl
URL dell'applicazione del Servizio app di Azure selezionato.

Commenti

Usare questa attività per distribuire applicazioni Web in Servizio app di Azure.

Metodi di distribuzione

In questa attività sono disponibili diversi metodi di distribuzione. Auto è l'opzione predefinita.

Per modificare l'opzione di distribuzione basata su pacchetti nell'attività di progettazione, espandere Opzioni di distribuzione aggiuntive e abilitare Seleziona metodo di distribuzione.

In base al tipo di Servizio app di Azure e all'agente di Azure Pipelines, l'attività sceglie una tecnologia di distribuzione appropriata. Le diverse tecnologie di distribuzione usate dall'attività sono:

• API REST Kudu
• Zip Deploy
• RunFromPackage

Per impostazione predefinita, l'attività tenta di selezionare la tecnologia di distribuzione appropriata in base al pacchetto di input, al tipo di servizio app e al sistema operativo dell'agente.

• Quando il tipo di servizio app è App Web in Un'app Linux, usare Zip Deploy
• Se viene fornito un file War, usare War Deploy
• Se viene fornito un file JAR, usare Run From Package
• Per tutti gli altri, usare Esegui da zip (tramite Zip Deploy)

In un agente non Windows (per qualsiasi tipo di servizio app), l'attività si basa sulle API REST Kudu per distribuire l'app Web.

API REST Kudu

Le API REST kudu funzionano sugli agenti di automazione Windows o Linux quando la destinazione è App Web in Windows, App Web in Linux (origine predefinita) o App per le funzioni. L'attività usa Kudu per copiare i file nella Servizio app di Azure.

Zip Deploy

Crea un pacchetto di distribuzione .zip del pacchetto o della cartella scelta. Il contenuto del file viene quindi distribuito nella cartella wwwroot dell'app per le funzioni in Servizio app di Azure. Questa opzione sovrascrive tutti i contenuti esistenti nella cartella wwwroot. Per altre informazioni, vedere Distribuzione zip per Funzioni di Azure.

RunFromPackage

Crea lo stesso pacchetto di distribuzione di Distribuzione zip. Tuttavia, anziché distribuire file nella cartella wwwroot, l'intero pacchetto viene montato dal runtime di Funzioni di Azure. Con questa opzione, i file nella cartella wwwroot diventano di sola lettura. Per altre informazioni, vedere Run your Azure Functions from a package file (Esecuzione di Funzioni di Azure da un file di pacchetto).

Errore: Non è stato possibile recuperare il token di accesso per Azure. Verificare se l'entità servizio utilizzata è valida e non scaduta.

L'attività usa l'entità servizio nella connessione al servizio per l'autenticazione con Azure. Se l'entità servizio è scaduta o non dispone delle autorizzazioni per il servizio app, l'attività ha esito negativo con questo errore. Verificare la validità dell'entità servizio usata e controllare che sia presente nella registrazione dell'app. Per altre informazioni, vedere Usare il controllo degli accessi in base al ruolo per gestire l'accesso alle risorse della sottoscrizione di Azure. Questo post di blog contiene anche altre informazioni sull'uso dell'autenticazione dell'entità servizio.

Errore SSL

Se si vuole usare un certificato in servizio app, il certificato deve essere firmato da un'autorità di certificazione attendibile. Se l'app Web visualizza errori di convalida del certificato, è probabile che si stia usando un certificato autofirmato. Impostare una variabile denominata VSTS_ARM_REST_IGNORE_SSL_ERRORS sul valore true nella pipeline di compilazione o versione per risolvere l'errore.

Una release resta bloccata a lungo e poi ha esito negativo

Questo problema potrebbe essere il risultato di capacità insufficiente nel piano di servizio app. Per risolvere questo problema, è possibile aumentare l'istanza di servizio app per aumentare la CPU, la RAM e lo spazio su disco disponibili oppure provare con un piano di servizio app diverso.

Codici errore 5xx

Se viene visualizzato un errore 5xx , controllare lo stato del servizio di Azure.

Funzione di Azure interrotta improvvisamente il funzionamento

Funzioni di Azure potrebbe interrompere improvvisamente il funzionamento se più di un anno è passato dall'ultima distribuzione. Se si distribuisce con "RunFromPackage" in "deploymentMethod", una firma di accesso condiviso con data di scadenza di 1 anno viene generata e impostata come valore di "WEBSITE_RUN_FROM_PACKAGE" nella configurazione dell'applicazione. Funzioni di Azure usa questa firma di accesso condiviso per fare riferimento al file del pacchetto per l'esecuzione della funzione, quindi se la firma di accesso condiviso è scaduta, la funzione non verrà eseguita. Per risolvere questo problema, distribuire di nuovo per generare una firma di accesso condiviso con una data di scadenza di un anno.

Errore: Non è stato trovato alcun pacchetto con il criterio specificato

Verificare se il pacchetto menzionato nell'attività viene pubblicato come artefatto nella compilazione o in una fase precedente e quindi scaricato nel processo corrente.

Errore: Pubblicare con l'opzione di distribuzione zip non è supportata per il tipo di pacchetto msBuild

I pacchetti Web creati tramite l'attività MSBuild (con argomenti predefiniti) hanno una struttura di cartelle annidata che può essere distribuita correttamente solo da Distribuzione Web. L'opzione di distribuzione pubblica a zip non può essere usata per distribuire tali pacchetti. Per convertire la struttura di creazione pacchetti, seguire questa procedura:

1. Nell'attività Compila soluzione modificare gli argomenti di MSBuild in /p:DeployOnBuild=true /p:DeployDefaultTarget=WebPublish /p:WebPublishMethod=FileSystem /p:DeleteExistingFiles=True /p:publishUrl="$(System.DefaultWorkingDirectory)\\WebAppContent":

   

2. Aggiungere un'attività Archivio e modificare i valori come indicato di seguito:

   1. Modificare la cartella radice o il file in cui archiviare in $(System.DefaultWorkingDirectory)\\WebAppContent.

   2. Deselezionare la casella di controllo Nome cartella radice prepend per archiviare i percorsi :

      

Domande frequenti

Qual è la differenza tra le AzureWebApp attività e AzureRmWebAppDeployment ?

L'attività App Web di Azure (AzureWebApp) è il modo più semplice per distribuire in un'app Web di Azure. Per impostazione predefinita, la distribuzione si verifica all'applicazione radice nell'app Web di Azure.

L'attività Distribuisci Servizio app di Azure (AzureRmWebAppDeployment) può gestire scenari più personalizzati, ad esempio:

• Modificare le impostazioni di configurazione all'interno di pacchetti Web e file di parametri XML.
• Distribuire con Distribuzione Web, se viene usato per il processo di distribuzione IIS.
• Distribuire nelle applicazioni virtuali.
• Distribuire in altri tipi di app, ad esempio app contenitore, app per le funzioni, processi Web o app per dispositivi mobili e API.

Nota

Le trasformazioni dei file e la sostituzione delle variabili sono supportate anche dall'attività Trasformazione file separata da usare in Azure Pipelines. È possibile usare l'attività Trasformazione file per applicare trasformazioni file e sostituzioni di variabili in qualsiasi file di configurazione e parametri.

La distribuzione dell'app Web in Windows ha avuto esito positivo, ma l'app non funziona

Ciò può essere dovuto al fatto che web.config non è presente nell'app. È possibile aggiungere un file web.config all'origine o generare automaticamente uno usando Le impostazioni di applicazione e configurazione.

• Fare clic sull'attività e passare a Genera parametri web.config per Python, Node.js, Go e Java app.

  

• Fare clic sul pulsante ... più per modificare i parametri.

  

• Selezionare il tipo di applicazione dall'elenco a discesa.

• Fare clic su OK. Verrà popolato i parametri di web.config necessari per generare web.config.

La distribuzione dell'app Web nell'ambiente del servizio app non funziona

• Assicurarsi che l'agente di compilazione Di Azure DevOps si trova nella stessa rete virtuale (subnet può essere diversa) del Load Balancer interno (ILB) dell'ambiente del servizio app. In questo modo l'agente eseguirà il pull del codice da Azure DevOps e la distribuzione in Ambiente del servizio app.
• Se si usa Azure DevOps, l'agente non deve essere accessibile da Internet, ma richiede solo l'accesso in uscita per connettersi al servizio Azure DevOps.
• Se si usa TFS/Azure DevOps Server distribuito in un Rete virtuale, l'agente può essere completamente isolato.
• L'agente di compilazione deve essere configurato con la configurazione DNS dell'app Web a cui deve essere distribuita. Le risorse private nel Rete virtuale non dispongono di voci in DNS di Azure, quindi è necessario aggiungere il file dell'host nel computer agente.
• Se viene usato un certificato autofirmato per la configurazione dell'ambiente del servizio app, l'opzione -allowUntrusted deve essere impostata nell'attività di distribuzione per MSDeploy. È anche consigliabile impostare la variabile VSTS_ARM_REST_IGNORE_SSL_ERRORS su true. Se per la configurazione del servizio app viene usato un certificato da un'autorità di certificazione, non è necessario.

Come configurare la connessione al servizio?

Questa attività richiede una connessione al servizio Resource Manager di Azure.

Come configurare la distribuzione dei processi Web con Application Insights?

Quando si esegue la distribuzione in un servizio app, se Application Insights è configurato e è stato abilitatoRemove additional files at destination, è necessario abilitare Exclude files from the App_Data folderanche . L'abilitazione di questa opzione mantiene l'estensione Application Insights in uno stato sicuro. Questo passaggio è necessario perché il processo Web continuo di Application Insights viene installato nella cartella App_Data.

Come è necessario configurare l'agente se è dietro un proxy durante la distribuzione in servizio app?

Se l'agente self-hosted richiede un proxy Web, è possibile informare l'agente sul proxy durante la configurazione. In questo modo, l'agente può connettersi ad Azure Pipelines o Azure DevOps Server tramite il proxy. Altre informazioni sull'esecuzione di un agente self-hosted dietro un proxy Web.

Esempio

Di seguito è riportato un frammento di codice YAML di esempio per distribuire l'applicazione Web nell'servizio app Web di Azure in esecuzione in Windows.

variables:
  azureSubscription: Contoso
  # To ignore SSL error uncomment the below variable
  # VSTS_ARM_REST_IGNORE_SSL_ERRORS: true

steps:

- task: AzureWebApp@1
  displayName: Azure Web App Deploy
  inputs:
    azureSubscription: $(azureSubscription)
    appName: samplewebapp
    package: $(System.DefaultWorkingDirectory)/**/*.zip

Per distribuire App Web in Linux, aggiungere il appType parametro e impostarlo su appType: webAppLinux.

Per specificare il metodo di distribuzione come Distribuzione zip, aggiungere il parametro deploymentMethod: zipDeploy. Un altro valore supportato per questo parametro è runFromPackage.

Se non specificato, auto è il valore predefinito.

Requisiti

Requisito	Descrizione
Tipi di pipeline	YAML, build classica, versione classica
Esecuzione 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