AzureFunctionApp@2 - Azure Functions Deploy v2-taak

2025-08-05

Een functie-app bijwerken met .NET, Python, JavaScript, PowerShell, Op Java gebaseerde webtoepassingen.

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. 
    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-verbinding
Input alias: azureSubscription. string. Required.

Selecteer het Azure Resource Manager-abonnement voor de implementatie.

appType - App type
string. Required. Toegestane waarden: functionApp (functie-app in Windows), functionAppLinux (functie-app op Linux).

Selecteer het type Azure-functie-app voor de implementatie.

isFlexConsumption - Is functie-app in flexverbruiksabonnement
boolean. Standaardwaarde: false.

Ingesteld op true of de functie-app zich in een Flex Consumption-abonnement bevindt.

appName - Naam van Azure Functions-app
string. Required.

Geef de naam op van een bestaande Azure Functions-app. De weergegeven functie-apps zijn gebaseerd op het geselecteerde app-type.

deployToSlotOrASE - Implementeren in site- of App Service-omgeving
boolean. Optional. Gebruiken wanneer appType != "" && isFlexConsumption = false. Standaardwaarde: false.

Wordt geïmplementeerd in een bestaande implementatiesite of Azure App Service Environment. Voor beide doelen heeft de taak een resourcegroepnaam nodig.

If the deployment target is a slot, it will default to the production slot. Elke andere bestaande sitenaam kan ook worden opgegeven.

If the deployment target is an Azure App Service Environment, leave the slot name as production and specify the Resource group name.

deployToSlotOrASE - Implementeren in site- of App Service-omgeving
boolean. Optional. Gebruiken wanneer appType != "". Standaardwaarde: false.

Wordt geïmplementeerd in een bestaande implementatiesite of Azure App Service Environment. Voor beide doelen heeft de taak een resourcegroepnaam nodig.

If the deployment target is a slot, it will default to the production slot. Elke andere bestaande sitenaam kan ook worden opgegeven.

If the deployment target is an Azure App Service Environment, leave the slot name as production and specify the Resource group name.

resourceGroupName - Resource group
string. Vereist wanneer deployToSlotOrASE = true.

De naam van de resourcegroep is vereist wanneer het implementatiedoel een implementatiesite of een App Service-omgeving is.

Hiermee voert u de Azure-resourcegroep in of selecteert die de Azure App Service bevat die hierboven is opgegeven.

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

Hiermee voert u een bestaande site in of selecteert u deze, met uitzondering van de productiesite.

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

Voer een andere site in of selecteer deze dan de productiesite.

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

Het bestandspad naar het pakket of de map die App Service-inhoud bevat die is gegenereerd door MSBuild of een gecomprimeerd zip-bestand. Variables ( Build | Release) and wildcards are supported. Bijvoorbeeld $(System.DefaultWorkingDirectory)/**/*.zip.

Geef het framework en de versie op waarop uw functie-app wordt uitgevoerd. U kunt een van de ondersteunde runtimeversies gebruiken. Oude waarden zoals DOCKER|microsoft/azure-functions-* zijn afgeschaft. New values are listed in the drop-down list in the task assistant. Als er een nieuwere versie van een framework beschikbaar is in de ondersteunde runtimeversies , kunt u deze opgeven, zelfs als dit niet in de lijst staat.

Note

This value currently doesn't update the linuxFxVersion that the site is running on. Dit betekent dat u de stack niet kunt bijwerken van Node 18 naar Node 20. De taak werkt momenteel alleen de app-instellingen bij.

appSettings - App settings
string.

Voer de toepassingsinstellingen in met behulp van de syntaxis -key value (bijvoorbeeld: -Port 5000-RequestTimeout 5000-WEBSITE_TIME_ZONE). Plaats waarden tussen spaties tussen dubbele aanhalingstekens (bijvoorbeeld: "Eastern Standard Time").

Zie Omgevingsvariabelen en app-instellingen in Azure App Service voor meer informatie over app-instellingen.

deploymentMethod - Deployment method
string. Vereist wanneer appType != "" && isFlexConsumption = false && package NotEndsWith .war && Package NotEndsWith .jar. Toegestane waarden: auto (automatisch detecteren), zipDeploy (Zip Deploy), runFromPackage (Zip Deploy with Run From Package). Standaardwaarde: auto.

Specifies the deployment method for the app. Linux Consumption-apps bieden geen ondersteuning voor deze configuratie.

De instellingen van de Azure Web Jobs Storage-app moeten worden ingesteld voor zip-implementaties wanneer de SKU Linux-verbruik is. Zip-implementaties gebruiken een opslagaccount om toepassingscode in de app te uploaden en te koppelen.

deploymentMethod - Deployment method
string. Vereist wanneer appType != "" && package NotEndsWith .war && Package NotEndsWith .jar. Toegestane waarden: auto (automatisch detecteren), zipDeploy (Zip Deploy), runFromPackage (Zip Deploy with Run From Package). Standaardwaarde: auto.

Specifies the deployment method for the app. Linux Consumption-apps bieden geen ondersteuning voor deze configuratie.

Chooses the deployment method for the app. Linux Consumption-apps bieden geen ondersteuning voor deze configuratie.

Opties voor taakbeheer

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

Output variables

This task defines the following output variables, which you can consume in downstream steps, jobs, and stages.

AppServiceApplicationUrl
toepassings-URL van de geselecteerde Azure-functie-app.

Remarks

The Azure Function Deployment task is used to update Azure Functions to deploy Functions to Azure. De taak werkt op platformoverschrijdende Azure Pipelines-agents met Windows, Linux of Mac en maakt gebruik van de onderliggende implementatietechnologieën van RunFromPackage, Zip Deploy en Kudu REST API's.

The task works for the Azure Functions supported languages.

Vereisten voor de taak

De volgende vereisten moeten worden ingesteld op de doelcomputer(s) om de taak goed te laten werken.

Azure Function

De taak wordt gebruikt om een Azure Functions-project te implementeren in een bestaande Azure-functie. De Azure Function-app moet bestaan voordat de taak wordt uitgevoerd. The Azure Function App can be created from the Azure portal. U kunt ook de Azure PowerShell-taak gebruiken om AzureRM PowerShell-scripts uit te voeren om de Azure Function-app in te richten en te configureren.

The task can be used to deploy Azure Functions (Windows/Linux).

Azure Subscription

Als u wilt implementeren in Azure, moet een Azure-abonnement worden gekoppeld aan Azure Pipelines met behulp van het tabblad Services in de sectie Accountbeheer. Voeg het Azure-abonnement toe dat u wilt gebruiken in de definitie build- of releasebeheer door het scherm Accountbeheer te openen (tandwielpictogram rechtsboven in het scherm) en klik vervolgens op het tabblad Services.

Create the ARM service endpoint and use Azure Resource Manager endpoint type. For more details, follow the steps listed in the link here.

De taak werkt niet met het klassieke Azure-service-eindpunt en geeft deze verbindingen niet weer in de parameters in de taak.

Deployment methods

Er zijn verschillende implementatiemethoden beschikbaar in deze taak.

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

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

Kudu REST API-
Zip Deploy
Uitvoeren vanuit pakket

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

Als er een script na de implementatie is opgegeven, gebruikt u Zip Deploy.
Als het App Service-type web-app op Linux 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 Run-From-Zip.
Voor alle andere taken gebruikt u Uitvoeren vanuit pakket (via Zip Deploy).

Voor een niet-Windows-agent (voor elk App Service-type) is de taak afhankelijk van de Kudu REST API om de web-app te implementeren.

Kudu REST API

De Kudu REST API werkt op zowel Windows- als Linux-automatiseringsagents wanneer het doel een web-app in Windows, een web-app op Linux (ingebouwde bron) of een functie-app is. De taak maakt gebruik van Kudu om bestanden te kopiëren naar Azure App Service.

Zip Deploy

Zip Deploy maakt een .zip implementatiepakket op basis van het gekozen pakket of de gekozen map. Vervolgens wordt de bestandsinhoud geïmplementeerd in de wwwroot-map van de App Service-naamfunctie-app in Azure. Met deze optie worden alle bestaande inhoud in de map wwwroot overschreven. Zie Zip-implementatie voor Azure Functions voor meer informatie.

Uitvoeren vanuit pakket

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

Troubleshooting

Fout: kan het 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 gebruikte service-principal en of deze aanwezig is in de app-registratie. Zie Op rollen gebaseerd toegangsbeheer gebruiken om de toegang tot uw Azure-abonnementsresources te beheren voor meer informatie. Dit blogbericht bevat ook meer informatie over het gebruik van service-principal-verificatie.

SSL error

Als u een certificaat in App Service wilt gebruiken, moet het certificaat worden ondertekend door een vertrouwde certificeringsinstantie. Als uw web-app u 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 loopt lang vast en mislukt

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

5xx error codes

If you're seeing a 5xx error, check the status of your Azure service.

Azure Function werkt plotseling niet meer

Azure Functions werkt mogelijk plotseling niet meer 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 'WEBSITE_RUN_FROM_PACKAGE' in de toepassingsconfiguratie. Azure Functions gebruikt deze SAS om te verwijzen naar het pakketbestand voor de uitvoering van de functie. Als de SAS is verlopen, wordt de functie dus 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 in de taak wordt vermeld, is gepubliceerd als een artefact in de build of een vorige fase en is gedownload in de huidige taak.

Fout: Publiceren met de optie zip deploy wordt niet ondersteund voor het pakkettype msBuild

Webpakketten die zijn gemaakt via de MSBuild-taak (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:

In the Build solution task, change the MSBuild Arguments to /p:DeployOnBuild=true /p:DeployDefaultTarget=WebPublish /p:WebPublishMethod=FileSystem /p:DeleteExistingFiles=True /p:publishUrl="$(System.DefaultWorkingDirectory)\\WebAppContent":
Voeg een archieftaak toe en wijzig de waarden als volgt:
1. Wijzig de hoofdmap of het hoofdbestand om te archiveren in $(System.DefaultWorkingDirectory)\\WebAppContent.
2. Schakel het selectievakje Prepend-hoofdmapnaam uit om paden te archiveren :

Implementatie van functie-apps in Windows slaagt, maar de app werkt niet

Dit probleem kan optreden als een web.config bestand niet aanwezig is in uw app. U kunt een web.config bestand toevoegen aan uw bron of automatisch een bestand genereren met behulp van de toepassings- en configuratie-instellingen van de taak.

Selecteer de taak en ga naar Parameters genereren web.config voor Python, Node.js, Go en Java-apps:
Selecteer de knop Meer (...) onder Parameters genereren web.config voor Python, Node.js, Go en Java-apps om de parameters te bewerken:
Select your application type in the Application framework list.
Select OK. Als u dit doet, worden de web.config parameters ingevuld die nodig zijn om het web.config-bestand te genereren.

FAQs

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?

When you're deploying to an App Service, if you have Application Insights configured and you've enabled Remove additional files at destination, you also need to enable Exclude files from the App_Data folder. Als u deze optie inschakelt, blijft de Application Insights-extensie veilig. Deze stap is vereist omdat de continue webtaak 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 implementeer in App Service?

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

Ik kan niet implementeren in een interne App Service-omgeving met behulp van een Azure Resource Manager-serviceverbinding en een door Microsoft gehoste agent

Een door Microsoft gehoste agent werkt standaard niet met een App Service Environment. In plaats daarvan moet u een privéagent configureren op een virtuele machine die zich in hetzelfde virtuele netwerk bevindt als de App Service Environment. Stel ook een privé-DNS-zone in om communicatie tussen de resources mogelijk te maken.

Examples

Hier volgt een voorbeeld van een YAML-fragment waarmee Azure-functies in Windows worden geïmplementeerd:


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

Als u een functie in Linux wilt implementeren, voegt u de parameter appType toe en stelt u deze in op appType: functionAppLinux. Als u geen waarde opgeeft, is functionApp de standaardwaarde.

Als u de implementatiemethode expliciet wilt opgeven als Zip Deploy, voegt u de parameter toe deploymentMethod: zipDeploy. Een andere ondersteunde waarde voor deze parameter is runFromPackage. Als u geen waarde opgeeft, is auto de standaardwaarde.

Zie Java bouwen en implementeren in Azure Functions voor een overzicht van het maken van een CI/CD-pijplijn.

Requirements

Requirement	Description
Pipeline types	YAML, klassieke build, klassieke release
Runs on	Agent, DeploymentGroup
Demands	None
Capabilities	Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
Command restrictions	Any
Settable variables	Any
Agent version	2.104.1 of hoger
Task category	Deploy