AzureFunctionApp@2 – Úloha Nasazení služby Azure Functions v2

Aktualizujte aplikaci funkcí pomocí .NET, Pythonu, JavaScriptu, PowerShellu, webových aplikací založených na Javě.

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.

Inputs

connectedServiceNameARM - připojení Azure Resource Manageru
Vstupní alias: azureSubscription. string. Required.

Vyberte připojení Azure Resource Manager pro nasazení. Připojení služby musí být připojené k aktivnímu předplatnému Azure.

appType - Typ aplikace
string. Required. Povolené hodnoty: functionApp (aplikace funkcí ve Windows), functionAppLinux (aplikace funkcí v Linuxu).

Vyberte typ aplikace Funkcí Azure pro nasazení.

isFlexConsumption - je aplikace funkcí v plánu Flex Consumption
boolean. Výchozí hodnota: false.

Nastavte, true jestli je aplikace funkcí v plánu Flex Consumption.

appName - Název aplikace Azure Functions
string. Required.

Zadejte název existující aplikace Azure Functions. Uvedené aplikace funkcí budou založené na vybraném typu aplikace.

deployToSlotOrASE - Nasazení do slotu nebo služby App Service Environment
boolean. Optional. Používá se při appType != "" && isFlexConsumption = false. Výchozí hodnota: false.

Nasadí se do existujícího slotu nasazení nebo azure App Service Environment. Pro oba cíle úkol potřebuje název skupiny prostředků.

Pokud je cílem nasazení slot, použije se ve výchozím nastavení produkční slot. Můžete také zadat jakýkoli jiný název existujícího slotu.

Pokud je cílem nasazení Azure App Service Environment, ponechte název slotu jako produkční a zadejte název skupiny prostředků.

skupiny prostředků
string. Požadováno při deployToSlotOrASE = true.

Název skupiny prostředků se vyžaduje, pokud je cílem nasazení slot nasazení nebo app Service Environment.

Zadá nebo vybere skupinu prostředků Azure, která obsahuje službu Azure App Service uvedenou výše.

slotName - Štěrbina
string. Požadováno při deployToSlotOrASE = true. Výchozí hodnota: production.

Zadá nebo vybere existující slot s výjimkou produkčního slotu.

package - Balíček nebo složka
string. Required. Výchozí hodnota: $(System.DefaultWorkingDirectory)/**/*.zip.

Cesta k souboru balíčku nebo složky, která obsahuje obsah služby App Service vygenerovaný nástrojem MSBuild nebo komprimovaným souborem ZIP. Podporovány jsou proměnné ( Build | Release) a zástupné znaky. Například $(System.DefaultWorkingDirectory)/**/*.zip.

runtimeStack - Zásobník za běhu
string. Optional. Používá se při appType = functionAppLinux && isFlexConsumption = false. Povolené hodnoty: DOTNET|6.0, DOTNET-ISOLATED|6.0, DOTNET-ISOLATED|7.0, DOTNET-ISOLATED|8.0DOTNET-ISOLATED|9.0JAVA|8JAVA|11JAVA|17JAVA|21NODE|14NODE|16NODE|18NODE|20PYTHON|3.8PYTHON|3.9PYTHON|3.10PYTHON|3.11.

Zadejte architekturu a verzi, na které bude vaše aplikace funkcí běžet. Můžete použít některou z podporovaných verzí modulu runtime. Staré hodnoty, jako je DOCKER|microsoft/azure-functions-*, jsou zastaralé. Nové hodnoty jsou uvedeny v rozevíracím seznamu v pomocníkovi úlohami. Pokud je k dispozici novější verze architektury v podporovaných verzích modulu runtime , můžete ji zadat i v případě, že není v seznamu.

Note

Tato hodnota v současné době neaktualizuje linuxFxVersion , na kterém je web spuštěn. To znamená, že nemůžete aktualizovat zásobník z Node 18 na Node 20. Úloha aktuálně aktualizuje jenom nastavení aplikace.

appSettings - Nastavení aplikace
string.

Zadejte nastavení aplikace pomocí -key value syntaxe (například: -Port 5000-RequestTimeout 5000-WEBSITE_TIME_ZONE). Uzavřete hodnoty, které obsahují mezery v dvojitých uvozovkách (například: "Eastern Standard Time").

Další informace o nastavení aplikace najdete v tématu Proměnné prostředí a nastavení aplikace ve službě Azure App Service.

deploymentMethod - Způsob nasazení
string. Požadováno při appType != "" && isFlexConsumption = false && package NotEndsWith .war && Package NotEndsWith .jar. Povolené hodnoty: auto (autodetekce), zipDeploy (zip deploy), runFromPackage (Zip Deploy with Run From Package). Výchozí hodnota: auto.

Určuje metodu nasazení aplikace. Aplikace Consumption pro Linux tuto konfiguraci nepodporují.

Nastavení aplikace Azure Web Jobs Storage je potřeba nastavit pro nasazení zip, pokud je skladová položka Spotřeba Linuxu. Nasazení zip používají účet úložiště k nahrání a připojení kódu aplikace do aplikace.

Možnosti řízení úkolů

Všechny úkoly mají kromě vstupů úkolů také možnosti řízení. Další informace naleznete v tématu Možnosti ovládacího prvku a běžné vlastnosti úlohy.

Výstupní proměnné

Tato úloha definuje následující výstupní proměnné, které můžete využívat v podřízených krocích, úlohách a fázích.

AppServiceApplicationUrl
adresu URL aplikace vybrané aplikace Funkcí Azure.

Remarks

Úloha nasazení funkce Azure se používá k aktualizaci služby Azure Functions za účelem nasazení služby Functions do Azure. Úloha funguje na agentech Azure Pipelines pro různé platformy se systémem Windows, Linux nebo Mac a používá základní technologie nasazení rozhraní RunFromPackage, Zip Deploy a Kudu REST API.

Tato úloha funguje pro jazyky podporované službou Azure Functions.

Požadavky pro úlohu

Aby úloha fungovala správně, musí být v cílových počítačích nastavená následující předpoklady.

Funkce Azure

Úloha se používá k nasazení projektu Azure Functions do existující funkce Azure Functions. Aplikace Funkcí Azure by měla existovat před spuštěním úlohy. Azure Function App je možné vytvořit z webu Azure Portal. Alternativně můžete úlohu Azure PowerShellu použít ke spuštění skriptů AzureRM PowerShellu ke zřízení a konfiguraci aplikace Azure Functions.

Úlohu je možné použít k nasazení služby Azure Functions (Windows/Linux).

Předplatné Azure

Pokud chcete nasadit do Azure, musí být předplatné Azure propojené se službou Azure Pipelines pomocí karty Služby v části Správa účtu. Přidejte předplatné Azure, které se má použít v definici Build or Release Management, otevřením obrazovky Správa účtu (ikona ozubeného kolečka v pravém horním rohu obrazovky) a potom klikněte na kartu Služby.

Vytvořte koncový bod služby ARM a použijte typ koncového bodu Azure Resource Manager . Další podrobnosti získáte podle kroků uvedených v odkazu zde.

Úloha nefunguje s koncovým bodem služby Azure Classic a nebude tato připojení vypisovat v parametrech v úloze.

Metody nasazení

V této úloze je k dispozici několik metod nasazení.

Pokud chcete změnit možnost nasazení na základě balíčku v úloze návrháře, rozbalte další možnosti nasazení a povolte možnost Vybrat metodu nasazení.

Úloha na základě typu agenta Azure App Service a Azure Pipelines používá vhodnou technologii nasazení. Technologie nasazení používané úlohami jsou následující:

• rozhraní REST API Kudu
• Nasazení zipu
• Spustit z balíčku

Ve výchozím nastavení se úloha pokusí vybrat příslušnou technologii nasazení na základě vstupního balíčku, typu služby App Service a operačního systému agenta.

• Pokud je k dispozici skript po nasazení, použijte zip Deploy.
• Pokud je typem služby App Service webová aplikace v Linuxu, použijte nástroj Zip Deploy.
• Pokud je k dispozici soubor .war, použijte War Deploy.
• Pokud je k dispozici soubor .jar, použijte příkaz Spustit ze souboru ZIP.
• Pro všechny ostatní úlohy použijte balíček Spustit z (prostřednictvím příkazu Zip Deploy).

U agenta mimo Windows (pro jakýkoli typ služby App Service) úloha spoléhá na rozhraní Kudu REST API k nasazení webové aplikace.

Kudu REST API

Rozhraní Kudu REST API funguje na agentech automatizace pro Windows i Linux, pokud cílem je webová aplikace ve Windows, webová aplikace v Linuxu (integrovaný zdroj) nebo aplikace funkcí. Úloha pomocí Kudu kopíruje soubory do služby Azure App Service.

Nasazení zipu

Zip Deploy vytvoří balíček pro nasazení .zip z vybraného balíčku nebo složky. Potom nasadí obsah souboru do složky wwwroot aplikace funkcí App Service v Azure. Tato možnost přepíše veškerý existující obsah ve složce wwwroot. Další informace najdete v tématu Nasazení zip pro Azure Functions.

Spustit z balíčku

Spustit z balíčku vytvoří stejný balíček nasazení jako Zip Deploy. Místo nasazení souborů do složky wwwroot připojí modul runtime Functions celý balíček. Při použití této možnosti se soubory ve složce wwwroot stanou jen pro čtení. Další informace najdete v tématu Spuštění služby Azure Functions ze souboru balíčku.

Troubleshooting

Chyba: Nepodařilo se načíst přístupový token pro Azure. Ověřte, jestli použitý instanční objekt je platný a nevypršela jeho platnost.

Úloha používá instanční objekt v připojení ke službě k ověření v Azure. Pokud vypršela platnost instančního objektu nebo nemá oprávnění ke službě App Service, úloha selže s touto chybou. Ověřte platnost použitého instančního objektu a ověřte, že se nachází v registraci aplikace. Další informace najdete v tématu Použití řízení přístupu na základě role ke správě přístupu k prostředkům předplatného Azure. Tento blogový příspěvek obsahuje také další informace o použití ověřování instančního objektu.

Chyba protokolu SSL

Pokud chcete použít certifikát ve službě App Service, musí být certifikát podepsaný důvěryhodnou certifikační autoritou. Pokud vaše webová aplikace poskytuje chyby ověření certifikátu, pravděpodobně používáte certifikát podepsaný svým držitelem. Pokud chcete chybu vyřešit, nastavte proměnnou s názvem VSTS_ARM_REST_IGNORE_SSL_ERRORS na hodnotu true v kanálu buildu nebo verze.

Verze po dlouhou dobu přestane reagovat a pak selže.

Tento problém může být důsledkem nedostatečné kapacity v plánu služby App Service. Pokud chcete tento problém vyřešit, můžete vertikálně navýšit kapacitu instance služby App Service, abyste zvýšili dostupné využití procesoru, paměti RAM a místa na disku nebo zkuste použít jiný plán služby App Service.

5xx chybové kódy

Pokud se vám zobrazuje chyba 5xx , zkontrolujte stav své služby Azure.

Funkce Azure Najednou přestala fungovat

Azure Functions může náhle přestat fungovat, pokud uplynulo více než jeden rok od posledního nasazení. Pokud nasadíte s parametrem RunFromPackage v části deploymentMethod, vygeneruje se SAS s datem vypršení platnosti 1 rok a nastaví se jako hodnota "WEBSITE_RUN_FROM_PACKAGE" v konfiguraci aplikace. Azure Functions používá tento SAS k odkazování na soubor balíčku pro spuštění funkce, takže pokud vypršela platnost SAS, funkce se nespustí. Pokud chcete tento problém vyřešit, nasaďte ho znovu a vygenerujte SAS s datem vypršení platnosti jednoho roku.

Chyba: Nebyl nalezen žádný balíček se zadaným vzorem.

Zkontrolujte, jestli se balíček uvedený v úloze publikuje jako artefakt v sestavení nebo předchozí fázi a stáhne se v aktuální úloze.

Chyba: Publikování pomocí možnosti nasazení zip není podporováno pro typ balíčku msBuild.

Webové balíčky vytvořené prostřednictvím úlohy MSBuild (s výchozími argumenty) mají vnořenou strukturu složek, kterou lze správně nasadit pouze nasazením webu. Možnost nasazení typu publish-to-zip se nedá použít k nasazení těchto balíčků. Pokud chcete převést strukturu balení, postupujte takto:

1. V úloze Sestavit řešení změňte argumenty MSBuild na /p:DeployOnBuild=true /p:DeployDefaultTarget=WebPublish /p:WebPublishMethod=FileSystem /p:DeleteExistingFiles=True /p:publishUrl="$(System.DefaultWorkingDirectory)\\WebAppContent":

   

2. Přidejte úlohu Archiv a následujícím způsobem změňte hodnoty:

   1. Změňte kořenovou složku nebo soubor tak, aby se archivovat na $(System.DefaultWorkingDirectory)\\WebAppContent.

   2. Zrušte zaškrtnutí políčka Předpřipravený název kořenové složky pro archivaci cest :

      

Nasazení aplikace funkcí ve Windows proběhne úspěšně, ale aplikace nefunguje

K tomuto problému může dojít, pokud soubor web.config není v aplikaci. Do zdroje můžete buď přidat web.config soubor, nebo ho automaticky vygenerovat pomocí nastavení aplikace a konfigurace úlohy.

1. Vyberte úlohu a přejděte na Vygenerovat parametry web.config pro Python, Node.js, Go a aplikace v Javě:

   

2. Vyberte tlačítko Další (...) v části Vygenerovat parametry web.config pro Python, Node.js, Go a Java a upravte parametry:

   

3. Vyberte typ aplikace v seznamu Application framework .

4. Vyberte OK. Tím se naplní parametry web.config potřebné k vygenerování souboru web.config.

FAQs

Jak mám nakonfigurovat připojení ke službě?

Tato úloha vyžaduje připojení služby Azure Resource Manager.

Jak mám nakonfigurovat nasazení webové úlohy pomocí Application Insights?

Pokud máte při nasazování do služby App Service nakonfigurovanou službu Application Insights a povolili Remove additional files at destinationjste ji, musíte také povolit Exclude files from the App_Data foldermožnost . Povolením této možnosti zůstane rozšíření Application Insights v bezpečném stavu. Tento krok je povinný, protože nepřetržitá webová úloha Application Insights je nainstalovaná do složky App_Data.

Jak mám nakonfigurovat agenta, pokud je za proxy serverem během nasazování do služby App Service?

Pokud váš agent v místním prostředí vyžaduje webový proxy server, můžete agenta informovat o proxy serveru během konfigurace. To umožňuje vašemu agentu připojit se k Azure Pipelines nebo Azure DevOps Serveru přes proxy server. Přečtěte si další informace o spuštění agenta v místním prostředí za webovým proxy serverem.

Nejde nasadit do interního prostředí App Service Environment pomocí připojení služby Azure Resource Manager a agenta hostovaného Microsoftem

Agent hostovaný Microsoftem nebude s prostředím App Service Environment fungovat. Místo toho musíte nakonfigurovat privátního agenta na virtuálním počítači, který je ve stejné virtuální síti jako App Service Environment. Nastavte také privátní zónu DNS tak, aby umožňovala komunikaci mezi prostředky.

Examples

Tady je ukázkový fragment kódu YAML, který nasazuje funkce Azure Functions ve 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

Pokud chcete nasadit funkci v Linuxu, přidejte parametr appType a nastavte ho na appType: functionAppLinux. Pokud nezadáte hodnotu, functionApp je výchozí.

Pokud chcete explicitně zadat metodu nasazení jako Zip Deploy, přidejte parametr deploymentMethod: zipDeploy. Další podporovaná hodnota pro tento parametr je runFromPackage. Pokud nezadáte hodnotu, auto je výchozí.

Návod, který ukazuje, jak vytvořit kanál CI/CD, najdete v tématu Sestavení a nasazení Javy do Azure Functions.

Requirements

Requirement	Description
Typy kanálů	YAML, klasické sestavení, klasická verze
Spouští se na	Agent, skupina nasazení
Demands	None
Capabilities	Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
omezení příkazů	Any
nastavitelné proměnné	Any
Verze agenta	2.104.1 nebo vyšší
Kategorie úkolu	Deploy