AzureWebApp@1 - Attività App Web di Azure v1

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.

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

Ingressi

Opzioni di controllo attività

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

Variabili di output

Osservazioni

Usare questa attività per distribuire applicazioni Web nel 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 Selezionare il 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
• Distribuzione zip
• 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 agente.

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

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

API REST Kudu

API REST Kudu funzionano su 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 nel servizio app di Azure.

Distribuzione zip

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 nel servizio app di Azure. Questa opzione sovrascrive tutto il contenuto esistente nella cartella wwwroot. Per altre informazioni, vedere distribuzione zip per Funzioni di Azure.

RunFromPackage

Crea lo stesso pacchetto di distribuzione di Zip Deploy. Tuttavia, invece di distribuire i 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 Eseguire Funzioni di Azure da un file di pacchetto.

Errore: Non è stato possibile recuperare il token di accesso per Azure. Verificare se l'entità servizio usata è 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à non riesce con questo errore. Verificare la validità dell'entità servizio usata e 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 nel servizio app, il certificato deve essere firmato da un'autorità di certificazione attendibile. Se l'app Web restituisce errori di convalida dei certificati, è 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 versione si blocca per molto tempo e quindi ha esito negativo

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

5xx codici di errore

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

La funzione di Azure ha improvvisamente smesso di funzionare

Funzioni di Azure può improvvisamente smettere di funzionare se sono trascorsi più di un anno dall'ultima distribuzione. Se si esegue la distribuzione con "RunFromPackage" in "deploymentMethod", viene generata una firma di accesso condiviso con data di scadenza di 1 anno 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, eseguire di nuovo la distribuzione per generare una firma di accesso condiviso con una data di scadenza di un anno.

Errore: nessun pacchetto trovato con il criterio specificato

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

Errore: l'opzione Publish using zip deploy non è supportata per il tipo di pacchetto msBuild

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

1. Nell'attività Compila soluzione modificare il 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à Archivia e modificare i valori nel modo seguente:

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

   2. Deselezionare la casella di controllo Nome cartella radice anteporta ai percorsi di archiviazione:

      

Domande frequenti

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

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

L''attività Distribuzione del 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 si usa il processo di distribuzione IIS.
• Distribuire in applicazioni virtuali.
• Eseguire la distribuzione in altri tipi di app, ad esempio app contenitore, app per le funzioni, processi Web o app per dispositivi mobili e API.

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

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

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

  

• Fare clic sul pulsante altro ... per modificare i parametri.

  

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

• Fare clic su OK. Verranno popolati i parametri di web.config necessari per generare web.config.

La distribuzione di 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) del servizio di bilanciamento del carico interno (ILB) dell'ambiente del servizio app. In questo modo l'agente potrà eseguire il pull del codice da Azure DevOps e distribuirlo nell'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 una rete virtuale, l'agente può essere completamente isolato.
• L'agente di compilazione deve essere configurato con la configurazione DNS dell'app Web in cui deve essere distribuito. Le risorse private nella rete virtuale non hanno voci in DNS di Azure, quindi è necessario aggiungerle al file dell'host nel computer agente.
• Se per la configurazione dell'ambiente del servizio app viene usato un certificato autofirmato, l'opzione -allowUntrusted deve essere impostata nell'attività di distribuzione per MSDeploy. È inoltre consigliabile impostare la variabile VSTS_ARM_REST_IGNORE_SSL_ERRORS su true. Se per la configurazione dell'ambiente del servizio app viene usato un certificato di un'autorità di certificazione, questo non deve essere necessario.

Come configurare la connessione al servizio?

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

Come configurare la distribuzione di processi Web con Application Insights?

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

Come si configura l'agente se è dietro un proxy durante la distribuzione nel 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 al server Azure DevOps tramite il proxy. Altre informazioni sull'esecuzione di un agente self-hosted dietro un proxy Web.

Esempi

Di seguito è riportato un frammento di codice YAML di esempio per distribuire l'applicazione Web nel 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 l'app Web in Linux, aggiungere il parametro appType e impostarlo su appType: webAppLinux.

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

Se non specificato, auto è il valore predefinito.

Fabbisogno