AzureFunctionApp@2 – Azure Functions Deploy v2-uppgift

2025-10-07

Uppdatera en funktionsapp med .NET, Python, JavaScript, PowerShell, Java-baserade webbprogram.

Syntax

# Azure Functions Deploy v2
# Update a function app with .NET, Python, JavaScript, PowerShell, Java based web applications.
- task: AzureFunctionApp@2
  inputs:
    connectedServiceNameARM: # string. Alias: azureSubscription. Required. Azure Resource Manager connection. 
    appType: # 'functionApp' | 'functionAppLinux'. Required. App type. 
    #isFlexConsumption: false # boolean. Is Function App on Flex Consumption Plan. Default: false.
    appName: # string. Required. Azure Functions App name. 
    #deployToSlotOrASE: false # boolean. Optional. Use when appType != "" && isFlexConsumption = false. 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: # 'DOTNET|6.0' | 'DOTNET-ISOLATED|6.0' | 'DOTNET-ISOLATED|7.0' | 'DOTNET-ISOLATED|8.0' | 'DOTNET-ISOLATED|9.0' | 'JAVA|8' | 'JAVA|11' | 'JAVA|17' | 'JAVA|21' | 'NODE|14' | 'NODE|16' | 'NODE|18' | 'NODE|20' | 'PYTHON|3.8' | 'PYTHON|3.9' | 'PYTHON|3.10' | 'PYTHON|3.11'. Optional. Use when appType = functionAppLinux && isFlexConsumption = false. Runtime stack. 
  # Application and Configuration Settings
    #appSettings: # string. App settings. 
  # Additional Deployment Options
    #deploymentMethod: 'auto' # 'auto' | 'zipDeploy' | 'runFromPackage'. Required when appType != "" && isFlexConsumption = false && package NotEndsWith .war && Package NotEndsWith .jar. Deployment method. Default: auto.

# Azure Functions Deploy v2
# Update a function app with .NET, Python, JavaScript, PowerShell, Java based web applications.
- task: AzureFunctionApp@2
  inputs:
    connectedServiceNameARM: # string. Alias: azureSubscription. Required. Azure Resource Manager connection. 
    appType: # 'functionApp' | 'functionAppLinux'. Required. App type. 
    #isFlexConsumption: false # boolean. Is Function App on Flex Consumption Plan. Default: false.
    appName: # string. Required. Azure Functions App name. 
    #deployToSlotOrASE: false # boolean. Optional. Use when appType != "" && isFlexConsumption = false. 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: # 'DOTNET|6.0' | 'DOTNET-ISOLATED|6.0' | 'DOTNET-ISOLATED|7.0' | 'DOTNET-ISOLATED|8.0' | 'JAVA|8' | 'JAVA|11' | 'JAVA|17' | 'JAVA|21' | 'NODE|14' | 'NODE|16' | 'NODE|18' | 'NODE|20' | 'PYTHON|3.8' | 'PYTHON|3.9' | 'PYTHON|3.10' | 'PYTHON|3.11'. Optional. Use when appType = functionAppLinux && isFlexConsumption = false. Runtime stack. 
  # Application and Configuration Settings
    #appSettings: # string. App settings. 
  # Additional Deployment Options
    #deploymentMethod: 'auto' # 'auto' | 'zipDeploy' | 'runFromPackage'. Required when appType != "" && isFlexConsumption = false && package NotEndsWith .war && Package NotEndsWith .jar. Deployment method. Default: auto.

# Azure Functions Deploy v2
# Update a function app with .NET, Python, JavaScript, PowerShell, Java based web applications.
- task: AzureFunctionApp@2
  inputs:
    connectedServiceNameARM: # string. Alias: azureSubscription. Required. Azure Resource Manager connection. 
    appType: # 'functionApp' | 'functionAppLinux'. Required. App type. 
    appName: # string. Required. Azure Functions 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: # 'DOTNET|2.2' | 'DOTNET|3.1' | 'DOTNET|6.0' | 'DOTNET-ISOLATED|7.0' | 'JAVA|8' | 'JAVA|11' | 'NODE|8' | 'NODE|10' | 'NODE|12' | 'NODE|14' | 'NODE|16' | 'NODE|18' | 'PYTHON|3.6' | 'PYTHON|3.7' | 'PYTHON|3.8' | 'PYTHON|3.9' | 'PYTHON|3.10'. Optional. Use when appType = functionAppLinux. Runtime stack. 
  # Application and Configuration Settings
    #appSettings: # string. App settings. 
  # Additional Deployment Options
    #deploymentMethod: 'auto' # 'auto' | 'zipDeploy' | 'runFromPackage'. Required when appType != "" && package NotEndsWith .war && Package NotEndsWith .jar. Deployment method. Default: auto.

Inputs

connectedServiceNameARM - Azure Resource Manager-anslutning
Indataalias: azureSubscription. string. Required.

Välj Azure Resource Manager-anslutningen för distributionen. Tjänstanslutningen måste vara ansluten till en aktiv Azure-prenumeration.

appType - Typ av app
string. Required. Tillåtna värden: functionApp (funktionsapp i Windows), functionAppLinux (funktionsapp i Linux).

Välj azure-funktionsapptypen för distributionen.

isFlexConsumption - Är funktionsapp på Flex Consumption Plan
boolean. Standardvärde: false.

Ange till true om funktionsappen finns i en Flex Consumption-plan.

appName - Namn på Azure Functions-app
string. Required.

Ange namnet på en befintlig Azure Functions-app. Funktionsapparna i listan baseras på den valda apptypen.

deployToSlotOrASE - Distribuera till fack eller App Service-miljö
boolean. Optional. Använd när appType != "" && isFlexConsumption = false. Standardvärde: false.

Distribuerar till ett befintligt distributionsfack eller Azure App Service Environment. För båda målen behöver aktiviteten ett resursgruppsnamn.

Om distributionsmålet är ett fack används produktionsplatsen som standard. Alla andra befintliga facknamn kan också anges.

Om distributionsmålet är en Azure App Service-miljön lämnar du facknamnet som produktion och anger resursgruppens namn.

deployToSlotOrASE - Distribuera till fack eller App Service-miljö
boolean. Optional. Använd när appType != "". Standardvärde: false.

Distribuerar till ett befintligt distributionsfack eller Azure App Service Environment. För båda målen behöver aktiviteten ett resursgruppsnamn.

Om distributionsmålet är ett fack används produktionsplatsen som standard. Alla andra befintliga facknamn kan också anges.

Om distributionsmålet är en Azure App Service-miljön lämnar du facknamnet som produktion och anger resursgruppens namn.

resourceGroupName - resursgrupp
string. Krävs när deployToSlotOrASE = true.

Resursgruppens namn krävs när distributionsmålet antingen är ett distributionsfack eller en App Service-miljö.

Anger eller väljer den Azure-resursgrupp som innehåller Azure App Service som anges ovan.

slotName - Springa
string. Krävs när deployToSlotOrASE = true. Standardvärde: production.

Anger eller väljer ett befintligt fack, exklusive produktionsplatsen.

slotName - Springa
string. Krävs när deployToSlotOrASE = true. Standardvärde: production.

Ange eller välj en annan plats än produktionsplatsen.

package - Paket eller mapp
string. Required. Standardvärde: $(System.DefaultWorkingDirectory)/**/*.zip.

Filsökvägen till paketet eller mappen som innehåller App Service-innehåll som genererats av MSBuild eller en komprimerad zip-fil. Variabler ( Build | Release) och jokertecken stöds. Till exempel $(System.DefaultWorkingDirectory)/**/*.zip.

Ange det ramverk och den version som funktionsappen ska köras på. Du kan använda någon av de körningsversioner som stöds. Gamla värden som DOCKER|microsoft/azure-functions-* är inaktuella. Nya värden listas i rullgardinslistan i aktivitetsassistenten. Om det finns en nyare version av ett ramverk som är tillgängligt i de körningsversioner som stöds kan du ange det även om det inte finns i listan.

Note

Det här värdet uppdaterar för närvarande inte den linuxFxVersion som webbplatsen körs på. Det innebär att du inte kan uppdatera stacken från Nod 18 till Nod 20. Uppgiften uppdaterar för närvarande endast appinställningarna.

Note

appSettings - App-inställningar
string.

Ange programinställningarna med hjälp av syntaxen -key value (till exempel: -Port 5000-RequestTimeout 5000-WEBSITE_TIME_ZONE). Omslut värden som innehåller blanksteg med dubbla citattecken (till exempel: "Eastern Standard Time").

Mer information om appinställningar finns i Miljövariabler och appinställningar i Azure App Service.

deploymentMethod - Metod för distribution
string. Krävs när appType != "" && isFlexConsumption = false && package NotEndsWith .war && Package NotEndsWith .jar. Tillåtna värden: auto (identifiera automatiskt), zipDeploy (Zip Deploy), runFromPackage (Zip Deploy with Run From Package). Standardvärde: auto.

Anger distributionsmetoden för appen. Linux-förbrukningsappar stöder inte den här konfigurationen.

Appinställningarna för Azure Web Jobs Storage måste anges för zip-distributioner när SKU:n är Linux-förbrukning. Zip-distributioner använder ett lagringskonto för att ladda upp och montera programkod i appen.

deploymentMethod - Metod för distribution
string. Krävs när appType != "" && package NotEndsWith .war && Package NotEndsWith .jar. Tillåtna värden: auto (identifiera automatiskt), zipDeploy (Zip Deploy), runFromPackage (Zip Deploy with Run From Package). Standardvärde: auto.

Anger distributionsmetoden för appen. Linux-förbrukningsappar stöder inte den här konfigurationen.

Väljer distributionsmetod för appen. Linux-förbrukningsappar stöder inte den här konfigurationen.

Alternativ för aktivitetskontroll

Alla aktiviteter har kontrollalternativ utöver sina uppgiftsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Den här uppgiften definierar följande utdatavariabler, som du kan använda i underordnade steg, jobb och faser.

AppServiceApplicationUrl
program-URL för den valda Azure-funktionsappen.

Remarks

Uppgiften Azure-funktionsdistribution används för att uppdatera Azure Functions för att distribuera Functions till Azure. Uppgiften fungerar på plattformsoberoende Azure Pipelines-agenter som kör Windows, Linux eller Mac och använder de underliggande distributionsteknikerna för RunFromPackage, Zip Deploy och Kudu REST API:er.

Uppgiften fungerar för de språk som Azure Functions stöds.

Förutsättningar för uppgiften

Följande förutsättningar måste vara konfigurerade på måldatorerna för att uppgiften ska fungera korrekt.

Azure-funktion

Uppgiften används för att distribuera ett Azure Functions-projekt till en befintlig Azure-funktion. Azure-funktionsappen bör finnas innan aktiviteten körs. Azure-funktionsappen kan skapas från Azure Portal. Du kan också använda Azure PowerShell-uppgiften för att köra AzureRM PowerShell-skript för att etablera och konfigurera Azure-funktionsappen.

Uppgiften kan användas för att distribuera Azure Functions (Windows/Linux).

Azure-prenumeration

För att distribuera till Azure måste en Azure-prenumeration länkas till Azure Pipelines med hjälp av fliken Tjänster i avsnittet Kontoadministration. Lägg till den Azure-prenumeration som ska användas i definitionen Skapa eller Versionshantering genom att öppna skärmen Kontoadministration (kugghjulsikonen längst upp till höger på skärmen) och klicka sedan på fliken Tjänster.

Skapa ARM-tjänstslutpunkten och använd Azure Resource Manager slutpunktstyp. För mer information, följ stegen som anges i länken här.

Uppgiften fungerar inte med den klassiska Azure-tjänstslutpunkten och de här anslutningarna visas inte i parametrarna i aktiviteten.

Distributionsmetoder

Det finns flera distributionsmetoder i den här uppgiften.

Om du vill ändra det paketbaserade distributionsalternativet i en designeruppgift expanderar du Ytterligare distributionsalternativ och aktiverar Välj distributionsmetod.

Baserat på typen av Azure App Service- och Azure Pipelines-agent använder uppgiften en lämplig distributionsteknik. De distributionstekniker som används av uppgifter är följande:

Kudu REST API
Zip-distribution
Kör från paket

Som standard försöker uppgiften välja lämplig distributionsteknik baserat på indatapaketet, App Service-typen och agentoperativsystemet.

Om du har angett ett skript efter distributionen använder du Zip Deploy.
Om App Service-typen är webbapp i Linux använder du Zip Deploy.
Om en .war-fil tillhandahålls använder du War Deploy.
Om en .jar fil tillhandahålls använder du Run-From-Zip.
Använd Kör från-paket (via Zip Deploy) för alla andra uppgifter.

På en icke-Windows-agent (för alla App Service-typer) förlitar sig uppgiften på Kudu REST API för att distribuera webbappen.

Kudu REST API

Kudu REST API fungerar på både Windows- och Linux-automationsagenter när målet är en webbapp i Windows, en webbapp i Linux (inbyggd källa) eller en funktionsapp. Uppgiften använder Kudu för att kopiera filer till Azure App Service.

Zip-distribution

Zip Deploy skapar ett .zip distributionspaket från det valda paketet eller mappen. Sedan distribueras filinnehållet till mappen wwwroot i apptjänstens namnfunktionsapp i Azure. Det här alternativet skriver över allt befintligt innehåll i mappen wwwroot. Mer information finns i Zip-distribution för Azure Functions.

Kör från paket

Kör från paket skapar samma distributionspaket som Zip Deploy. I stället för att distribuera filer till mappen wwwroot monterar Functions-körningen hela paketet. När du använder det här alternativet blir filer i mappen wwwroot skrivskyddade. Mer information finns i Kör dina Azure Functions från en paketfil.

Troubleshooting

Fel: Det gick inte att hämta åtkomsttoken för Azure. Kontrollera om tjänstens huvudnamn som används är giltigt och inte har upphört att gälla.

Uppgiften använder tjänstens huvudnamn i tjänstanslutningen för att autentisera med Azure. Om tjänstens huvudnamn har upphört att gälla eller inte har behörighet till App Service misslyckas uppgiften med det här felet. Kontrollera giltigheten för tjänstens huvudnamn som används och att det finns i appregistreringen. Mer information finns i Använda rollbaserad åtkomstkontroll för att hantera åtkomst till dina Azure-prenumerationsresurser. Det här blogginlägget innehåller också mer information om hur du använder autentisering med tjänstens huvudnamn.

SSL-fel

Om du vill använda ett certifikat i App Service måste certifikatet signeras av en betrodd certifikatutfärdare. Om webbappen ger dig certifikatverifieringsfel använder du förmodligen ett självsignerat certifikat. Ange en variabel med namnet VSTS_ARM_REST_IGNORE_SSL_ERRORS till värdet true i bygg- eller versionspipelinen för att lösa felet.

En version låser sig under lång tid och misslyckas sedan

Det här problemet kan bero på otillräcklig kapacitet i Din App Service-plan. För att lösa det här problemet kan du skala upp App Service-instansen för att öka tillgängligt processor-, RAM-minne- och diskutrymme eller prova med en annan App Service-plan.

5xx felkoder

Om du ser ett 5xx-felkontrollerar du statusen för din Azure-tjänst.

Azure-funktionen slutade plötsligt fungera

Azure Functions kan plötsligt sluta fungera om mer än ett år har passerat sedan den senaste distributionen. Om du distribuerar med "RunFromPackage" i "deploymentMethod" genereras en SAS med ett förfallodatum på 1 år och anges som värdet "WEBSITE_RUN_FROM_PACKAGE" i programkonfigurationen. Azure Functions använder denna SAS för att referera till paketfilen för funktionskörning, så om SAS har upphört att gälla körs inte funktionen. Lös problemet genom att distribuera igen för att generera en SAS med ett förfallodatum på ett år.

Fel: Inget paket hittades med angivet mönster

Kontrollera om paketet som nämns i uppgiften publiceras som en artefakt i bygget eller i en tidigare fas och laddas ned i det aktuella jobbet.

Fel: Alternativet Publicera med zip-distribution stöds inte för msBuild-pakettypen

Webbpaket som skapats via MSBuild-aktiviteten (med standardargument) har en kapslad mappstruktur som endast kan distribueras korrekt av Web Deploy. Distributionsalternativet publish-to-zip kan inte användas för att distribuera dessa paket. Utför följande steg för att konvertera paketeringsstrukturen:

I uppgiften Skapa lösning ändrar du MSBuild-argumenten till /p:DeployOnBuild=true /p:DeployDefaultTarget=WebPublish /p:WebPublishMethod=FileSystem /p:DeleteExistingFiles=True /p:publishUrl="$(System.DefaultWorkingDirectory)\\WebAppContent":
Lägg till en arkivaktivitet och ändra värdena enligt följande:
1. Ändra rotmappen eller filen till arkivera till $(System.DefaultWorkingDirectory)\\WebAppContent.
2. Avmarkera kryssrutan Prepend root folder name to archive paths (Prepend root folder name to archive paths ):

Distributionen av funktionsappen i Windows lyckas men appen fungerar inte

Det här problemet kan uppstå om en web.config fil inte finns i din app. Du kan antingen lägga till en web.config fil i källan eller automatiskt generera en med hjälp av program- och konfigurationsinställningarna för uppgiften.

Välj uppgiften och gå till Generera web.config parametrar för Python, Node.js, Go och Java-appar:
Välj knappen Mer (...) under Generera web.config parametrar för Python, Node.js, Go och Java-appar för att redigera parametrarna:
Välj din programtyp i listan Programramverk .
Välj OK. Om du gör det fylls de web.config parametrar som krävs för att generera web.config-filen.

FAQs

Hur ska jag konfigurera min tjänstanslutning?

Den här uppgiften kräver en Azure Resource Manager-tjänstanslutning.

Hur ska jag konfigurera distribution av webbjobb med Application Insights?

När du distribuerar till en Serviço de Aplicativo måste du också aktivera om du har konfigurerat Remove additional files at destination och du har aktiverat Exclude files from the App_Data folder. Om du aktiverar det här alternativet hålls Application Insights-tillägget i ett säkert tillstånd. Det här steget krävs eftersom Application Insights kontinuerliga webbjobb är installerat i mappen App_Data.

Hur ska jag konfigurera min agent om den finns bakom en proxy när jag distribuerar till App Service?

Om din lokala agent kräver en webbproxy kan du informera agenten om proxyn under konfigurationen. På så sätt kan din agent ansluta till Azure Pipelines eller Azure DevOps Server via proxyn. Läs mer om att köra en lokalt installerad agent bakom en webbproxy.

Jag kan inte distribuera till en intern App Service-miljö med hjälp av en Azure Resource Manager-tjänstanslutning och en Microsoft-värdbaserad agent

En Microsoft-värdbaserad agent fungerar inte med en App Service-miljö. I stället måste du konfigurera en privat agent på en virtuell dator som finns i samma virtuella nätverk som App Service-miljön. Ange också en privat DNS-zon för att aktivera kommunikation mellan resurserna.

Examples

Här är ett YAML-exempelfragment som distribuerar Azure-funktioner i Windows:


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

steps:
- task: AzureFunctionApp@2
  displayName: Azure Function App Deploy
  inputs:
    azureSubscription: $(azureSubscription)
    appName: samplefunctionapp
    appType: functionApp
    package: $(System.DefaultWorkingDirectory)/**/*.zip

Om du vill distribuera en funktion i Linux lägger du till parametern appType och ställer in den på appType: functionAppLinux. Om du inte anger något värde är functionApp standardvärdet.

Om du uttryckligen vill ange distributionsmetoden som Zip Deploy lägger du till parametern deploymentMethod: zipDeploy. Ett annat värde som stöds för den här parametern är runFromPackage. Om du inte anger något värde är auto standardvärdet.

En genomgång som visar hur du skapar en CI/CD-pipeline finns i Skapa och distribuera Java till Azure Functions.

Requirements

Requirement	Description
Pipelinetyper	YAML, klassisk version, klassisk version
Körs på	Agent, DeploymentGroup
Demands	None
Capabilities	Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Kommandobegränsningar	Any
variabler som kan	Any
Agentversion	2.104.1 eller senare
Aktivitetskategori	Deploy

Feedback

Var den här sidan till hjälp?