AzureFunctionApp@1 – Azure Functions v1 feladat

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

Syntax

# Azure Functions Deploy v1
# Update a function app with .NET, Python, JavaScript, PowerShell, Java based web applications.
- task: AzureFunctionApp@1
  inputs:
    azureSubscription: # string. Required. Azure Resource Manager connection. 
    appType: # 'functionApp' | 'functionAppLinux'. Required. App type. 
    appName: # string. Required. Azure Functions App name. 
    #deployToSlotOrASE: false # boolean. 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. Runtime stack. 
    #startUpCommand: # string. Optional. Use when appType = functionAppLinux. Startup command. 
  # Application and Configuration Settings
    #customWebConfig: # string. Optional. Use when appType != functionAppLinux && 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 != functionAppLinux && appType != "" && package NotEndsWith .war && Package NotEndsWith .jar. Deployment method. Default: auto.

Inputs

azureSubscription - Azure Resource Manager-kapcsolat
string. Required.

Kiválasztja az üzembe helyezéshez szükséges Azure Resource Manager-előfizetést.

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

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

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

deployToSlotOrASE - Üzembe helyezés pont- vagy App Service-környezetben
boolean. 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 által létrehozott App Service-tartalmat, tömörített zip-fájlt vagy háborús fájlt 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 or $(System.DefaultWorkingDirectory)/**/*.war.

runtimeStack - Futásidejű verem
string. Optional. Használja a appType = functionAppLinux. 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.

startUpCommand - Indítási parancs
string. Optional. Használja a appType = functionAppLinux.

Beírja az indítási parancsot. Például:

dotnet run
dotnet filename.dll

customWebConfig - Python-, Node.js-, Go- és Java-alkalmazásokhoz web.config-paraméterek létrehozása
string. Optional. Használja a appType != functionAppLinux && package NotEndsWith .war.

Egy szabványos Web.config fog létrehozni és üzembe helyezni az Azure App Service-ben, ha az alkalmazás nem rendelkezik ilyenrel. Az web.config értékei az alkalmazás keretrendszerétől függően változnak, és szerkeszthetők. Az node.js alkalmazás esetében például a web.config egy indítási fájllal és iis_node modulértékekkel fog rendelkezni. Ez a szerkesztési funkció csak a generált web.configvonatkozik.

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.

configurationStrings - Konfigurációs beállítások
string.

Adja meg a konfigurációs sztringeket a -key value szintaxissal (például: -phpVersion 5.6-linuxFxVersion: node|6.11). Olyan értékeket foglal össze, amelyek szóközöket tartalmaznak dupla idézőjelekben.

deploymentMethod - Üzembe helyezési módszer
string. appType != functionAppLinux && appType != "" && 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.

Kiválasztja az alkalmazás üzembe helyezési mó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ők é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
A kijelölt App Service alkalmazás URL-címe.

Remarks

Az Azure-függvényalkalmazás feladattal függvényeket helyezhet üzembe az Azure-ban.

Üzembe helyezési módszerek

Ebben a feladatban számos üzembe helyezési módszer érhető el. Az alapértelmezett érték a auto.

Ha módosítani szeretné a csomagalapú üzembe helyezési lehetőséget egy tervezői feladatban, bontsa ki További üzembehelyezési beállítások, és engedélyezze Telepítési módszer kiválasztásalehető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- 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 üzembe helyezése az 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ót 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 gyökérmappát vagy fájlt úgy, hogy archiválja $(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ásainak használatával.

1. Válassza ki a feladatot, és lépjen Python-, Node.js-, Go- és Java-alkalmazásokweb.config paramétereinek létrehozása:

   

2. A paraméterek szerkesztéséhez válassza a Továbbiak gombot (...) 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áskapcsolatiszü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ó a saját üzemeltetésű ügynök webproxy mögötti 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@1
  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 Java buildelése és üzembe helyezése az Azure Functions.

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