AzureWebApp@1 - Azure Web App v1-taak

Met deze taak wordt een Azure-web-app voor Linux of Windows geïmplementeerd.

Syntax

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

Invoerwaarden

azureSubscription - Azure-abonnement
string. Vereist.

Hiermee geeft u de Azure Resource Manager-abonnementsverbinding voor de implementatie.

appType - App-type
string. Vereist. Toegestane waarden: webApp (Web-app in Windows), webAppLinux (web-app op Linux).

Hiermee geeft u het type Azure-web-app op.

appName - App-naam
string. Vereist.

Hiermee geeft u de naam van een bestaande Azure App Service. Alleen app-services die zijn gebaseerd op het geselecteerde app-type worden weergegeven.

deployToSlotOrASE - Implementeren op site of App Service Environment
boolean. Optioneel. Gebruik wanneer appType != "". Standaardwaarde: false.

Selecteert de optie om te implementeren naar een bestaande implementatiesite of een Azure App Service-omgeving.
Voor beide doelen heeft de taak een resourcegroepnaam nodig.
Als het implementatiedoel een site is, is de standaardwaarde de productiesite. Elke andere bestaande sitenaam kan ook worden opgegeven.
Als het implementatiedoel een Azure App Service-omgeving is, laat u de sitenaam op productie staan en geeft u de naam van de resourcegroep op.

resourceGroupName - Resourcegroep
string. Vereist wanneer deployToSlotOrASE = true.

De naam van de resourcegroep is vereist wanneer het implementatiedoel een implementatiesite of een Azure App Service-omgeving is.
Hiermee geeft u de Azure-resourcegroep op die de hierboven aangegeven Azure App Service bevat.

slotName - Sleuf
string. Vereist wanneer deployToSlotOrASE = true. Standaardwaarde: production.

Hiermee geeft u een bestaande site, met uitzondering van de productiesite.

package - Pakket of map
string. Vereist. Standaardwaarde: $(System.DefaultWorkingDirectory)/**/*.zip.

Het bestandspad naar het pakket of de map die App Service inhoud bevat die is gegenereerd door MSBuild, een gecomprimeerd zip-bestand of een war-bestand. Variabelen (buildrelease | ) en jokertekens worden ondersteund. Bijvoorbeeld $(System.DefaultWorkingDirectory)/**/*.zip of $(System.DefaultWorkingDirectory)/**/*.war.

customDeployFolder - Aangepaste implementatiemap
string. Optioneel. Gebruik wanneer package EndsWith .war.

Hiermee geeft u de naam van de aangepaste map op waarnaar u wilt implementeren.
Als het veld leeg is, wordt het pakket geïmplementeerd in <appname>.azurewebsites.net/<warpackagename>.
Als ROOT is ingevoerd, wordt het pakket geïmplementeerd in <appname>.azurewebsited.net.
In alle andere gevallen wordt deze geïmplementeerd in <appname>.azurewebsited.net/<customWarName>.

runtimeStack - Runtimestack
string. Optioneel. Gebruik wanneer appType = webAppLinux.

Web App in Linux biedt twee verschillende opties om uw toepassing te publiceren: implementatie van aangepaste installatiekopieën (Web App for Containers) en app-implementatie met een ingebouwde platforminstallatiekopie (web-app op Linux). Deze parameter is alleen beschikbaar wanneer Linux Web App is geselecteerd als een app-type in de taak.

startUpCommand - Opstartopdracht
string. Optioneel. Gebruik wanneer appType = webAppLinux.

Hiermee geeft u de opstartopdracht op.
Bijvoorbeeld:
dotnet run
dotnet filename.dll.

customWebConfig - web.config parameters genereren voor Python-, Node.js-, Go- en Java-apps
string. Optioneel. Gebruik wanneer appType != webAppLinux && package NotEndsWith .war.

Er wordt een standaard web.config gegenereerd en geïmplementeerd op Azure App Service als de toepassing er geen heeft. De waarden in web.config variëren op basis van het toepassingsframework en kunnen worden bewerkt. Voor de node.js-toepassing hebt web.config bijvoorbeeld een opstartbestand en iis_node modulewaarden. Deze bewerkingsfunctie is alleen voor de gegenereerde web.config.

appSettings - App-instellingen
string.

Geef de web-app-toepassingsinstellingen op met behulp van de syntaxis -key value (bijvoorbeeld:-RequestTimeout 5000-Port 5000-WEBSITE_TIME_ZONE ). Plaats waarden die spaties tussen dubbele aanhalingstekens bevatten (bijvoorbeeld: "Eastern Standard Time").

configurationStrings - Configuratie-instellingen
string.

Geef de configuratie-instellingen voor de web-app op met behulp van de syntaxis -key value (bijvoorbeeld: -phpVersion 5.6-linuxFxVersion: node|6.11). Plaats waarden die spaties tussen dubbele aanhalingstekens bevatten.

deploymentMethod - Implementatiemethode
string. Vereist wanneer appType != webAppLinux && appType != "" && package NotEndsWith .war && package NotEndsWith .jar. Toegestane waarden: auto (Automatisch detecteren), zipDeploy (Zip Deploy), runFromPackage (Uitvoeren vanuit pakket). Standaardwaarde: auto.

Kies de implementatiemethode voor de app. Acceptabele waarden zijn auto, zipDeploy en runFromPackage.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Besturingsopties en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Deze taak definieert de volgende uitvoervariabelen, die u kunt gebruiken in downstreamstappen, taken en fasen.

AppServiceApplicationUrl
De toepassings-URL van de geselecteerde Azure App Service.

Opmerkingen

Gebruik deze taak om webtoepassingen te implementeren voor Azure App Service.

Implementatiemethoden

Er zijn verschillende implementatiemethoden beschikbaar in deze taak. Auto is de standaardoptie.

Als u de implementatieoptie op basis van pakketten in de ontwerptaak wilt wijzigen, vouwt u Extra implementatieopties uit en schakelt u Implementatiemethode selecteren in.

Op basis van het type Azure App Service en Azure Pipelines-agent kiest de taak een geschikte implementatietechnologie. De verschillende implementatietechnologieën die door de taak worden gebruikt, zijn:

• Kudu REST API's
• Zip Deploy
• RunFromPackage

De taak probeert standaard de juiste implementatietechnologie te selecteren op basis van het invoerpakket, het app-servicetype en het besturingssysteem van de agent.

• Wanneer het app-servicetype Web-app in Linux-app is, gebruikt u Zip Deploy
• Als er een war-bestand is opgegeven, gebruikt u War Deploy
• Als er een JAR-bestand is opgegeven, gebruikt u Uitvoeren van pakket
• Voor alle andere gebruikt u Uitvoeren vanuit zip (via Zip Deploy)

Op een niet-Windows-agent (voor elk type app-service) is de taak afhankelijk van Kudu REST API's om de web-app te implementeren.

Kudu REST API's

Kudu REST API's werken op Windows- of Linux-automatiseringsagents als het doel web-app in Windows, web-app op Linux (ingebouwde bron) of functie-app is. De taak gebruikt Kudu om bestanden naar de Azure App Service te kopiëren.

Zip Deploy

Hiermee maakt u een .zip implementatiepakket van het gekozen pakket of de gekozen map. De bestandsinhoud wordt vervolgens geïmplementeerd in de map wwwroot van de functie-app in Azure App Service. Met deze optie wordt alle bestaande inhoud in de map wwwroot overschreven. Zie Zip-implementatie voor Azure Functions voor meer informatie.

RunFromPackage

Hiermee maakt u hetzelfde implementatiepakket als Zip Deploy. In plaats van bestanden te implementeren in de map wwwroot, wordt het hele pakket echter gekoppeld door de Azure Functions runtime. Met deze optie worden bestanden in de map wwwroot alleen-lezen. Zie voor meer informatie Uw Azure Functions uitvoeren vanuit een pakketbestand.

Fout: kan toegangstoken voor Azure niet ophalen. Controleer of de gebruikte service-principal geldig is en niet is verlopen.

De taak gebruikt de service-principal in de serviceverbinding om te verifiëren met Azure. Als de service-principal is verlopen of geen machtigingen heeft voor de App Service, mislukt de taak met deze fout. Controleer de geldigheid van de service-principal die wordt gebruikt en of deze aanwezig is in de appregistratie. Voor meer informatie raadpleegt u Op rollen gebaseerd toegangsbeheer gebruiken voor het beheer van de toegang tot de resources van uw Azure-abonnement. Dit blogbericht bevat ook meer informatie over het gebruik van verificatie van service-principals.

SSL-fout

Als u een certificaat in App Service wilt gebruiken, moet het certificaat zijn ondertekend door een vertrouwde certificeringsinstantie. Als uw web-app certificaatvalidatiefouten geeft, gebruikt u waarschijnlijk een zelfondertekend certificaat. Stel een variabele met de naam VSTS_ARM_REST_IGNORE_SSL_ERRORS in op de waarde true in de build- of release-pijplijn om de fout op te lossen.

Een release blijft lange tijd hangen en mislukt vervolgens

Dit probleem kan het gevolg zijn van onvoldoende capaciteit in uw App Service-abonnement. U kunt dit probleem oplossen door het App Service-exemplaar omhoog te schalen om de beschikbare CPU, RAM en schijfruimte te vergroten of het te proberen met een ander App Service abonnement.

5xx-foutcodes

Als u een 5xx-fout ziet, controleert u de status van uw Azure-service.

Azure-functie werkt plotseling niet meer

Azure Functions kan plotseling stoppen met werken als er meer dan één jaar is verstreken sinds de laatste implementatie. Als u implementeert met 'RunFromPackage' in 'deploymentMethod', wordt een SAS met een vervaldatum van 1 jaar gegenereerd en ingesteld als de waarde van 'WEBSITE_RUN_FROM_PACKAGE' in de toepassingsconfiguratie. Azure Functions gebruikt deze SAS om te verwijzen naar het pakketbestand voor het uitvoeren van de functie, dus als de SAS is verlopen, wordt de functie niet uitgevoerd. U kunt dit probleem oplossen door opnieuw te implementeren om een SAS te genereren met een vervaldatum van één jaar.

Fout: er is geen pakket gevonden met het opgegeven patroon

Controleer of het pakket dat wordt vermeld in de taak, is gepubliceerd als een artefact in de build of een eerdere fase, en is gedownload in de huidige taak.

Fout: publiceren met behulp van zip-implementatieoptie wordt niet ondersteund voor msBuild-pakkettype

Webpakketten die zijn gemaakt via de taak MSBuild (met standaardargumenten) hebben een geneste mapstructuur die alleen correct kan worden geïmplementeerd door Web Deploy. De implementatieoptie publiceren naar zip kan niet worden gebruikt om deze pakketten te implementeren. Voer de volgende stappen uit om de verpakkingsstructuur te converteren:

1. Wijzig in de taak Oplossing bouwen de MSBuild-argumenten in /p:DeployOnBuild=true /p:DeployDefaultTarget=WebPublish /p:WebPublishMethod=FileSystem /p:DeleteExistingFiles=True /p:publishUrl="$(System.DefaultWorkingDirectory)\\WebAppContent":

   

2. Voeg een archieftaak toe en wijzig de waarden als volgt:

   1. Wijzig de hoofdmap of het bestand om te archiveren in $(System.DefaultWorkingDirectory)\\WebAppContent.

   2. Schakel het selectievakje Naam van hoofdmap prepend om paden te archiveren uit:

      

Veelgestelde vragen

Wat is het verschil tussen de AzureWebApp taken en AzureRmWebAppDeployment ?

De Azure Web App-taak (AzureWebApp) is de eenvoudigste manier om te implementeren in een Azure-web-app. Uw implementatie vindt standaard plaats in de hoofdtoepassing in de Azure-web-app.

De Azure App Service De taak Implementeren (AzureRmWebAppDeployment) kan meer aangepaste scenario's verwerken, zoals:

• Configuratie-instellingen wijzigen in webpakketten en XML-parametersbestanden.
• Implementeren met Web Deploy, als u gewend bent aan het IIS-implementatieproces.
• Implementeren in virtuele toepassingen.
• Implementeer naar andere app-typen, zoals Container-apps, Functie-apps, WebJobs of API- en mobiele apps.

Notitie

Bestandstransformaties en vervanging van variabelen worden ook ondersteund door de afzonderlijke bestandstransformatietaak voor gebruik in Azure Pipelines. U kunt de taak Bestandstransformatie gebruiken om bestandstransformaties en vervangingen van variabelen toe te passen op configuratie- en parametersbestanden.

De web-app-implementatie in Windows is voltooid, maar de app werkt niet

Dit kan komen doordat web.config niet aanwezig is in uw app. U kunt een web.config-bestand toevoegen aan uw bron of automatisch een bestand genereren met behulp van Toepassings- en configuratie-instellingen.

• Klik op de taak en ga naar Parameters voor web.config genereren voor Python-, Node.js-, Go- en Java-apps.

  

• Klik op de knop ... Meer om de parameters te bewerken.

  

• Selecteer uw toepassingstype in de vervolgkeuzelijst.

• Klik op OK. Hiermee worden de web.config parameters ingevuld die nodig zijn om web.config te genereren.

Web-app-implementatie in ASE (App Service Environment) werkt niet

• Zorg ervoor dat de Azure DevOps-buildagent zich op hetzelfde VNET bevindt (subnet kan verschillen) als de Interne Load Balancer (ILB) van ASE. Hierdoor kan de agent code ophalen uit Azure DevOps en implementeren naar ASE.
• Als u Azure DevOps gebruikt, hoeft de agent niet toegankelijk te zijn via internet, maar heeft deze alleen uitgaande toegang nodig om verbinding te maken met Azure DevOps Service.
• Als u TFS/Azure DevOps Server gebruikt die in een Virtual Network zijn geïmplementeerd, kan de agent volledig worden geïsoleerd.
• De buildagent moet worden geconfigureerd met de DNS-configuratie van de web-app waarvoor deze moet worden geïmplementeerd. De privéresources in de Virtual Network hebben geen vermeldingen in Azure DNS, dus deze moet worden toegevoegd aan het hostbestand op de agentcomputer.
• Als een zelfondertekend certificaat wordt gebruikt voor de ASE-configuratie, moet de -allowUntrusted optie worden ingesteld in de implementatietaak voor MSDeploy. Het wordt ook aanbevolen om de variabele VSTS_ARM_REST_IGNORE_SSL_ERRORS in te stellen op true. Als een certificaat van een certificeringsinstantie wordt gebruikt voor ASE-configuratie, is dit niet nodig.

Hoe moet ik mijn serviceverbinding configureren?

Voor deze taak is een Azure Resource Manager-serviceverbinding vereist.

Hoe moet ik de implementatie van webtaken configureren met Application Insights?

Wanneer u implementeert in een App Service en u Application Insights hebt geconfigureerd en u hebt ingeschakeldRemove additional files at destination, moet u ook inschakelenExclude files from the App_Data folder. Als u deze optie inschakelt, blijft de Application Insights-extensie veilig. Deze stap is vereist omdat de continue WebJob van Application Insights is geïnstalleerd in de map App_Data.

Hoe moet ik mijn agent configureren als deze zich achter een proxy bevindt terwijl ik in App Service implementeer?

Als voor uw zelf-hostende agent een webproxy is vereist, kunt u de agent tijdens de configuratie informeren over de proxy. Hierdoor kan uw agent verbinding maken met Azure Pipelines of Azure DevOps Server via de proxy. Meer informatie over het uitvoeren van een zelf-hostende agent achter een webproxy.

Voorbeelden

Hieronder volgt een voorbeeld van een YAML-fragment voor het implementeren van een webtoepassing in de Azure-web-App Service die wordt uitgevoerd 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

Als u een web-app wilt implementeren in Linux, voegt u de appType parameter toe en stelt u deze in op appType: webAppLinux.

Als u de implementatiemethode wilt opgeven als Zip Deploy, voegt u de parameter deploymentMethod: zipDeploytoe. Een andere ondersteunde waarde voor deze parameter is runFromPackage.

Als dit niet is opgegeven, auto is de standaardwaarde.

Vereisten

Vereiste	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Agent, DeploymentGroup
Eisen	Geen
Functies	Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen	Alle
Instelbare variabelen	Alle
Agentversie	2.104.1 of hoger
Taakcategorie	Implementeren