AzureFunctionApp@2 – Azure Functions – 2. verziós feladat üzembe helyezése

Függvényalkalmazás frissítése .NET, Python, JavaScript, PowerShell, Java-alapú webalkalmazásokkal.

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 - Azure Resource Manager-kapcsolat
Bemeneti alias: azureSubscription. string. Required.

Válassza ki az Azure Resource Manager kapcsolatot az üzembe helyezéshez. A szolgáltatáskapcsolatnak aktív Azure-előfizetéshez kell csatlakoznia.

appType - Alkalmazás típusa
string. Required. Engedélyezett értékek: functionApp (Függvényalkalmazás Windows rendszeren), functionAppLinux (Függvényalkalmazás Linux rendszeren).

Válassza ki az azure-függvényalkalmazás típusát az üzembe helyezéshez.

isFlexConsumption - A Függvényalkalmazás rugalmas használatú csomagban
boolean. Alapértelmezett érték: false.

Állítsa be, hogy a true függvényalkalmazás Flex Consumption-csomagban van-e.

appName - Azure Functions-alkalmazás neve
string. Required.

Adja meg egy meglévő Azure Functions-alkalmazás nevét. A felsorolt függvényalkalmazások a kiválasztott alkalmazástípuson alapulnak.

deployToSlotOrASE - Üzembe helyezés a Slot vagy az App Service-környezetben
boolean. Optional. Használja a appType != "" && isFlexConsumption = false. Alapértelmezett érték: false.

Üzembe helyezés meglévő üzembehelyezési ponton vagy Azure App Service-környezetben. Mindkét cél esetében a tevékenységnek erőforráscsoport-névre van szüksége.

Ha az üzembe helyezési cél egy tárolóhely, akkor alapértelmezés szerint az éles tárolóhely lesz. Bármely más meglévő pontnév is megadható.

Ha az üzembe helyezési cél egy Azure App Service Environment, hagyja meg a tárolóhely nevét éles környezetben , és adja meg az erőforráscsoport nevét.

resourceGroupName - Erőforráscsoport
string. deployToSlotOrASE = trueesetén kötelező.

Az erőforráscsoport nevére akkor van szükség, ha az üzembehelyezési cél egy üzembehelyezési pont vagy egy App Service-környezet.

Beírja vagy kiválasztja a fent megadott Azure App Service-t tartalmazó Azure-erőforráscsoportot.

slotName - Rés
string. deployToSlotOrASE = trueesetén kötelező. Alapértelmezett érték: production.

Beír vagy kiválaszt egy meglévő pontot, az éles pont kivételével.

package - Csomag vagy mappa
string. Required. Alapértelmezett érték: $(System.DefaultWorkingDirectory)/**/*.zip.

Az MSBuild vagy tömörített zip-fájl által létrehozott App Service-tartalmat tartalmazó csomag vagy mappa elérési útja. A változók ( Build | Release) és a helyettesítő karakterek támogatottak. Például $(System.DefaultWorkingDirectory)/**/*.zip.

runtimeStack - Futásidejű verem
string. Optional. Használja a appType = functionAppLinux && isFlexConsumption = false. Engedélyezett értékek: DOTNET|6.0, DOTNET-ISOLATED|6.0, DOTNET-ISOLATED|7.0DOTNET-ISOLATED|8.0DOTNET-ISOLATED|9.0JAVA|8JAVA|11JAVA|17JAVA|21NODE|14NODE|16NODE|18NODE|20PYTHON|3.8PYTHON|3.9PYTHON|3.10. PYTHON|3.11

Adja meg azt a keretrendszert és verziót, amelyen a függvényalkalmazás futni fog. A támogatott futtatókörnyezeti verziók bármelyikét használhatja. A régi értékek, például a DOCKER|microsoft/azure-functions-* elavultak. Az új értékek a feladatsegéd legördülő listájában jelennek meg. Ha egy keretrendszer újabb verziója érhető el a támogatott futtatókörnyezeti verziókban , akkor is megadhatja, ha nem szerepel a listában.

Note

Ez az érték jelenleg nem frissíti azt a linuxFxVersion-t , amelyen a webhely fut. Ez azt jelenti, hogy a verem nem frissíthető a 18. csomópontról a 20. csomópontra. A feladat jelenleg csak az alkalmazásbeállításokat frissíti.

appSettings - Alkalmazásbeállítások
string.

Adja meg az alkalmazásbeállításokat a -key value szintaxissal (például: -Port 5000-RequestTimeout 5000-WEBSITE_TIME_ZONE). A szóközöket tartalmazó értékeket dupla idézőjelek közé foglalja (például: "Eastern Standard Time").

További információ az alkalmazásbeállításokról: Környezeti változók és alkalmazásbeállítások az Azure App Service-ben.

deploymentMethod - Üzembe helyezési módszer
string. appType != "" && isFlexConsumption = false && package NotEndsWith .war && Package NotEndsWith .jaresetén kötelező. Engedélyezett értékek: auto (automatikus észlelés), zipDeploy (Zip-üzembe helyezés), runFromPackage (Zip-üzembe helyezés csomagból futtatással). Alapértelmezett érték: auto.

Megadja az alkalmazás üzembe helyezési módját . A Linux-használatú alkalmazások nem támogatják ezt a konfigurációt.

Az Azure Web Jobs Storage alkalmazásbeállításait be kell állítani a zip-alapú környezetekhez, ha a termékváltozat Linux-használat. A Zip-környezetek egy tárfiók használatával töltik fel és csatlakoztatják az alkalmazás kódját.

Tevékenységvezérlési beállítások

Minden tevékenység a tevékenységbemeneteken kívül vezérlési lehetőségekkel is rendelkezik. További információ: Vezérlési beállítások és gyakori feladattulajdonságok.

Kimeneti változók

Ez a feladat a következő kimeneti változókat határozza meg, amelyeket lefelé irányuló lépésekben, feladatokban és szakaszokban használhat fel.

AppServiceApplicationUrl
kiválasztott Azure-függvényalkalmazás alkalmazás URL-címe.

Remarks

Az Azure-függvények üzembe helyezése feladat a Azure Functions frissítésére szolgál a Functions Azure-ban való üzembe helyezéséhez. A feladat Windows, Linux vagy Mac rendszert futtató, platformfüggetlen Azure Pipelines-ügynökökön működik, és a RunFromPackage, a Zip Deploy és a Kudu REST API-k mögöttes üzembehelyezési technológiáit használja.

A feladat a Azure Functions támogatott nyelveken működik.

A feladat előfeltételei

A feladat megfelelő működéséhez a következő előfeltételeket kell beállítani a célgép(ek)ben.

Azure-függvény

A feladat egy Azure Functions-projekt üzembe helyezésére szolgál egy meglévő Azure-függvényben. Az Azure-függvényalkalmazásnak léteznie kell a feladat futtatása előtt. Az Azure-függvényalkalmazás a Azure Portal. Másik lehetőségként az Azure PowerShell-feladat használható AzureRM PowerShell-szkriptek futtatására az Azure-függvényalkalmazás kiépítéséhez és konfigurálásához.

A feladat Azure Functions (Windows/Linux) üzembe helyezésére használható.

Azure-előfizetés

Az Azure-ban való üzembe helyezéshez egy Azure-előfizetést az Azure Pipelineshoz kell kapcsolni a Fiókfelügyelet szakasz Szolgáltatások lapján. Adja hozzá a Build vagy a Release Management definícióban használni kívánt Azure-előfizetést a Fiókfelügyelet képernyő megnyitásával (fogaskerék ikon a képernyő jobb felső sarkában), majd kattintson a Szolgáltatások fülre.

Hozza létre az ARM-szolgáltatásvégpontot , és használja a Azure Resource Manager végponttípust. További részletekért kövesse az itt található linken felsorolt lépéseket.

A feladat nem működik a klasszikus Azure szolgáltatásvégponttal, és nem listázni fogja ezeket a kapcsolatokat a tevékenység paraméterei között.

Üzembe helyezési módszerek

Ebben a feladatban számos üzembe helyezési módszer érhető el.

Ha módosítani szeretné a csomagalapú üzembe helyezési beállítást egy tervezői feladatban, bontsa ki a További üzembehelyezési beállítások elemet , és engedélyezze a Telepítési módszer kiválasztása lehetőséget.

Az Azure App Service és az Azure Pipelines-ügynök típusa alapján a feladat egy megfelelő üzembehelyezési technológiát használ. A feladatok által használt üzembehelyezési technológiák a következők:

• Kudu REST API-
• Zip üzembe helyezése
• Futtatás csomagból

Alapértelmezés szerint a feladat megpróbálja kiválasztani a megfelelő üzembehelyezési technológiát a bemeneti csomag, az App Service típusa és az ügynök operációs rendszere alapján.

• Ha az üzembe helyezés utáni szkript van megadva, használja a Zip Deploy parancsot.
• Ha az App Service-típus Web App linuxos, használja a Zip Deploy szolgáltatást.
• Ha .war fájl van megadva, használja a War Deploy parancsot.
• Ha .jar fájl van megadva, használja a Run-From-Zip parancsot.
• Minden más feladathoz használja a Futtatás csomagból parancsot (Zip Deploy használatával).

Egy nem Windows-ügynökön (bármely App Service-típus esetében) a feladat a Kudu REST API-ra támaszkodik a webalkalmazás üzembe helyezéséhez.

Kudu REST API

A Kudu REST API Windows- és Linux-automatizálási ügynökökön is működik, ha a cél egy Windows-alapú webalkalmazás, egy Linux-alapú webalkalmazás (beépített forrás) vagy egy függvényalkalmazás. A feladat a Kudu használatával másolja a fájlokat az Azure App Service-be.

Zip üzembe helyezése

A Zip Deploy létrehoz egy .zip üzembehelyezési csomagot a kiválasztott csomagból vagy mappából. Ezután üzembe helyezi a fájl tartalmát az App Service névfüggvényalkalmazás wwwroot mappájába az Azure-ban. Ez a beállítás felülírja a wwwroot mappában lévő összes meglévő tartalmat. További információ: Zip deployment for Azure Functions.

Futtatás csomagból

A Run From Package ugyanazt az üzembehelyezési csomagot hozza létre, mint a Zip Deploy. Ahelyett, hogy fájlokat helyez üzembe a wwwroot mappában, a Functions-futtatókörnyezet a teljes csomagot csatlakoztatja. Ha ezt a beállítást használja, a wwwroot mappában lévő fájlok írásvédettek lesznek. További információ: Az Azure Functions futtatása csomagfájlból.

Troubleshooting

Hiba: Nem sikerült lekérni az Azure hozzáférési jogkivonatát. Ellenőrizze, hogy a használt szolgáltatásnév érvényes-e, és nem járt-e le.

A feladat a szolgáltatáskapcsolatban lévő szolgáltatásnevet használja az Azure-ral való hitelesítéshez. Ha a szolgáltatásnév lejárt, vagy nincs engedélye az App Service-hez, a feladat ezzel a hibával meghiúsul. Ellenőrizze a használt szolgáltatásnév érvényességét, és hogy szerepel-e az alkalmazásregisztrációban. További információ: Szerepköralapú hozzáférés-vezérlés használata az Azure-előfizetés erőforrásaihoz való hozzáférés kezeléséhez. Ez a blogbejegyzés további információkat is tartalmaz a szolgáltatásnév-hitelesítés használatáról.

SSL hiba

Ha tanúsítványt szeretne használni az App Service-ben, a tanúsítványt megbízható hitelesítésszolgáltatónak kell aláírnia. Ha a webalkalmazás tanúsítványérvényesítési hibákat jelez, valószínűleg önaláírt tanúsítványt használ. Állítson be egy VSTS_ARM_REST_IGNORE_SSL_ERRORS nevű változót a buildelési vagy kiadási folyamat true értékére a hiba megoldásához.

A kiadás hosszú ideig lefagy, majd meghiúsul

Ez a probléma az App Service-csomag kapacitásának elégtelensége lehet. A probléma megoldásához felskálázhatja az App Service-példányt a rendelkezésre álló processzor-, RAM- és lemezterület növeléséhez, vagy kipróbálhat egy másik App Service-csomagot.

5xx hibakód

Ha 5xx hibaüzenetet lát, ellenőrizze az Azure-szolgáltatás állapotát.

Az Azure-függvény hirtelen leállt

Az Azure Functions hirtelen leállhat, ha az utolsó üzembe helyezés óta több mint egy év telt el. Ha a "RunFromPackage" használatával telepít a "deploymentMethod" fájlban, a rendszer létrehoz egy 1 éves lejárati dátumú SAS-t, és az alkalmazáskonfigurációban a "WEBSITE_RUN_FROM_PACKAGE" értékként van beállítva. Az Azure Functions ezzel az SAS-szel hivatkozik a csomagfájlra a függvény végrehajtásához, így ha az SAS lejárt, a függvény nem lesz végrehajtva. A probléma megoldásához telepítse újra a telepítést, hogy létrehoz egy SAS-t egyéves lejárati dátummal.

Hiba: Nem található megadott mintával rendelkező csomag

Ellenőrizze, hogy a feladatban említett csomag összetevőként van-e közzétéve a buildben vagy az előző szakaszban, és letöltődik-e az aktuális feladatba.

Hiba: Az msBuild csomagtípus esetében nem támogatott a zip-alapú üzembe helyezési beállítással való közzététel

Az MSBuild feladaton (alapértelmezett argumentumokkal) létrehozott webcsomagok beágyazott mappastruktúrával rendelkeznek, amelyet csak a Web Deploy helyezhet üzembe megfelelően. A közzététel a zip-hez üzembe helyezési lehetőséggel nem telepíthetők. A csomagolási struktúra átalakításához hajtsa végre az alábbi lépéseket:

1. A Megoldás összeállítása feladatban módosítsa az MSBuild argumentumokat a következőre:/p:DeployOnBuild=true /p:DeployDefaultTarget=WebPublish /p:WebPublishMethod=FileSystem /p:DeleteExistingFiles=True /p:publishUrl="$(System.DefaultWorkingDirectory)\\WebAppContent"

   

2. Adjon hozzá egy archív feladatot, és módosítsa az értékeket az alábbiak szerint:

   1. Módosítsa a gyökérmappát vagy a fájlt archiválásra$(System.DefaultWorkingDirectory)\\WebAppContent.

   2. Törölje az Előpend gyökérmappa nevét az elérési utak archiválásához jelölőnégyzetből:

      

A függvényalkalmazás üzembe helyezése Windows rendszeren sikeres, de az alkalmazás nem működik

Ez a probléma akkor fordulhat elő, ha egy web.config fájl nem található az alkalmazásban. Hozzáadhat egy web.config fájlt a forráshoz, vagy automatikusan létrehozhat egyet a feladat alkalmazás- és konfigurációs beállításaival .

1. Válassza ki a feladatot, és válassza a Python-, Node.js-, Go- és Java-alkalmazásokhoz készült web.config-paraméterek létrehozása lehetőséget:

   

2. A paraméterek szerkesztéséhez válassza a Továbbiak gombot (...) a Python, Node.js, Go és Java-alkalmazások web.config paramétereinek létrehozásához :

   

3. Válassza ki az alkalmazás típusát az Alkalmazás-keretrendszer listában.

4. Kattintson az OK gombra. Ezzel feltölti a web.config fájl létrehozásához szükséges web.config paramétereket.

FAQs

Hogyan konfigurálhatom a szolgáltatáskapcsolatot?

Ehhez a feladathoz Azure Resource Manager-szolgáltatáskapcsolat szükséges.

Hogyan konfigurálhatom a webes feladatok üzembe helyezését az Application Insights használatával?

Ha App Service-be telepít, ha konfigurálta az Application Insights-t , és engedélyezte Remove additional files at destination, engedélyeznie Exclude files from the App_Data folderkell a következőt is. Ennek a beállításnak az engedélyezése biztonságos állapotban tartja az Application Insights bővítményt. Erre a lépésre azért van szükség, mert az Application Insights folyamatos webfeladata telepítve van a App_Data mappába.

Hogyan konfiguráljam az ügynökömet, ha proxy mögött van az App Service-ben való üzembe helyezés során?

Ha a saját üzemeltetésű ügynökhöz webproxy szükséges, a konfiguráció során tájékoztathatja az ügynököt a proxyról. Így az ügynök a proxyn keresztül csatlakozhat az Azure Pipelineshoz vagy az Azure DevOps Serverhez. További információ egy saját üzemeltetésű ügynök webproxy mögött való futtatásáról.

Nem tudok belső App Service-környezetben üzembe helyezni egy Azure Resource Manager-szolgáltatáskapcsolat és egy Microsoft által üzemeltetett ügynök használatával

A Microsoft által üzemeltetett ügynök nem működik az App Service-környezettel. Ehelyett egy privát ügynököt kell konfigurálnia egy olyan virtuális gépen, amely ugyanabban a virtuális hálózaton található, mint az App Service Environment. Emellett állítson be egy privát DNS-zónát az erőforrások közötti kommunikáció engedélyezéséhez.

Examples

Íme egy minta YAML-kódrészlet, amely üzembe helyezi az Azure-függvényeket Windows rendszeren:

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

Ha linuxos függvényt szeretne üzembe helyezni, adja hozzá a appType paramétert, és állítsa be appType: functionAppLinux. Ha nem ad meg értéket, functionApp az alapértelmezett érték.

Az üzembe helyezési módszer Zip Deployként való explicit megadásához adja hozzá a deploymentMethod: zipDeployparamétert. A paraméter egy másik támogatott értéke a runFromPackage. Ha nem ad meg értéket, auto az alapértelmezett érték.

A CI/CD-folyamatok létrehozásának módját bemutató útmutatót a Java buildelése és üzembe helyezése az Azure Functionsben című témakörben talál.

Requirements

Requirement	Description
Folyamattípusok	YAML, klasszikus build, klasszikus kiadás
Futtatás:	Ügynök, DeploymentGroup
Demands	None
Capabilities	Ez a tevékenység nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek.
parancskorlátozások	Any
Változók beállítása	Any
Ügynök verzió	2.104.1 vagy újabb
Tevékenységkategória	Deploy