A függvényalkalmazás kezelése

Az Azure Functionsben egy függvényalkalmazás biztosítja az egyes függvények végrehajtási környezetét. A függvényalkalmazások viselkedése egy adott függvényalkalmazás által üzemeltetett összes függvényre vonatkozik. A függvényalkalmazások összes függvényének azonos nyelvűnek kell lennie.

A függvényalkalmazások egyes függvényei együtt vannak üzembe helyezve, és együtt vannak skálázva. Az ugyanabban a függvényalkalmazásban lévő összes függvény példányonként megosztja az erőforrásokat, ahogy a függvényalkalmazás méretez.

A kapcsolati sztringek, a környezeti változók és az egyéb alkalmazásbeállítások külön vannak definiálva az egyes függvényalkalmazásokhoz. Minden olyan adatot, amelyet meg kell osztani a függvényalkalmazások között, külsőleg kell tárolni egy fenntartott tárolóban.

Első lépések az Azure Portalon

Feljegyzés

Az Azure Portal függvénykódjának szerkesztésére vonatkozó korlátozások miatt helyileg kell fejlesztenie a függvényeket, és közzé kell tennie a kódprojektet egy Azure-beli függvényalkalmazásban. További információ: Fejlesztési korlátozások az Azure Portalon

A függvényalkalmazás alkalmazásbeállításainak megtekintéséhez kövesse az alábbi lépéseket:

1. Jelentkezzen be az Azure Portalra Azure-fiókjával. Keresse meg a függvényalkalmazást, és válassza ki.

2. A függvényalkalmazás bal oldali ablaktábláján bontsa ki a Beállítások elemet, válassza a Környezeti változók lehetőséget, majd válassza az Alkalmazásbeállítások lapot.

   

Alkalmazásbeállítások használata

Az Azure Functions által előre definiált alkalmazásbeállítások mellett tetszőleges számú alkalmazásbeállítást is létrehozhat, a függvénykódnak megfelelően. További információkért tekintse meg az Azure Functions alkalmazásbeállításokra vonatkozó hivatkozását.

Ezek a beállítások titkosítva vannak tárolva. További információ: Alkalmazásbeállítások biztonsága.

Az alkalmazásbeállításokat az Azure Portalon, valamint az Azure CLI és az Azure PowerShell használatával kezelheti. Az alkalmazásbeállításokat a Visual Studio Code-ból és a Visual Studióból is kezelheti.

Azure Portal

Az alkalmazásbeállítások megtekintéséhez tekintse meg az Első lépések az Azure Portalon című témakört.

Az Alkalmazásbeállítások lap a függvényalkalmazás által használt beállításokat tartja karban:

1. Az alkalmazásbeállítások értékeinek megtekintéséhez válassza az Értékek megjelenítése lehetőséget.

2. Beállítás hozzáadásához válassza a + Hozzáadás lehetőséget, majd adja meg az új kulcs-érték pár nevét és értékét .

   

Azure CLI

A az functionapp config appsettings list parancs a meglévő alkalmazásbeállításokat adja vissza, például:

az functionapp config appsettings list --name <FUNCTION_APP_NAME> \
--resource-group <RESOURCE_GROUP_NAME>

A az functionapp config appsettings set parancs hozzáad vagy frissít egy alkalmazásbeállítást. Az alábbi példa létrehoz egy beállítást egy elnevezett CUSTOM_FUNCTION_APP_SETTING kulccsal és egy értékkel 12345:

az functionapp config appsettings set --name <FUNCTION_APP_NAME> \
--resource-group <RESOURCE_GROUP_NAME> \
--settings CUSTOM_FUNCTION_APP_SETTING=12345

Azure PowerShell

A Get-AzFunctionAppSetting parancsmag a meglévő alkalmazásbeállításokat adja vissza, például:

Get-AzFunctionAppSetting -Name <FUNCTION_APP_NAME> -ResourceGroupName <RESOURCE_GROUP_NAME>

A Update-AzFunctionAppSetting parancs hozzáad vagy frissít egy alkalmazásbeállítást. Az alábbi példa létrehoz egy beállítást egy elnevezett CUSTOM_FUNCTION_APP_SETTING kulccsal és egy értékkel 12345:

Update-AzFunctionAppSetting -Name <FUNCTION_APP_NAME> -ResourceGroupName <RESOURCE_GROUP_NAME> -AppSetting @{"CUSTOM_FUNCTION_APP_SETTING" = "12345"}

Alkalmazásbeállítások használata

A függvényalkalmazás beállításainak értékei környezeti változókként is olvashatók a kódban. További információkért tekintse meg az alábbi nyelvspecifikus referenciacikkek Környezeti változók szakaszát:

• C# előre lefordítva
• C# szkript (.csx)
• Java
• JavaScript
• PowerShell
• Python

Ha helyileg fejleszt függvényalkalmazást, ezeknek az értékeknek a helyi másolatát a local.settings.json projektfájlban kell megőriznie. További információt a Helyi beállítások fájlban talál.

FTPS üzembehelyezési beállítások

Az Azure Functions az FTPS használatával támogatja a projektkód üzembe helyezését a függvényalkalmazásban. Mivel ez az üzembe helyezési módszer megköveteli az eseményindítók szinkronizálását, nem ajánlott. A projektfájlok biztonságos átviteléhez mindig FTPS-t használjon, és ne FTP-t.

Az FTPS üzembe helyezéséhez szükséges hitelesítő adatok beszerzéséhez használja az alábbi módszerek egyikét:

Azure Portal

Az FTPS közzétételi hitelesítő adatait az Azure Portalon szerezheti be a függvényalkalmazás közzétételi profiljának letöltésével.

Fontos

A közzétételi profil fontos biztonsági hitelesítő adatokat tartalmaz. Mindig gondoskodjon a letöltött fájl védelméről a helyi számítógépen.

A függvényalkalmazás közzétételi profiljának letöltése:

1. Válassza a függvényalkalmazás Áttekintés lapját, majd válassza a Közzétételi profil lekérése lehetőséget.

   

2. Mentse és másolja a fájl tartalmát.

3. A fájlban keresse meg az publishProfile attribútumot publishMethod="FTP"tartalmazó elemet. Ebben az elemben a publishUrl, userNameés userPWD attribútumok tartalmazzák az FTPS-közzététel cél URL-címét és hitelesítő adatait.

Azure CLI

Futtassa ezt az Azure CLI-parancsot, amely visszaadja az FTPS-hitelesítő adatokat a közzétételi profilból.

az functionapp deployment list-publishing-profiles --name <APP_NAME> --resource-group <GROUP_NAME> --query "[?publishMethod=='FTP'].{URL:publishUrl, username:userName, password:userPWD}" -o table

Ebben a példában cserélje le <APP_NAME> a függvényalkalmazás nevét és <GROUP_NAME> az erőforráscsoportot. A visszaadott URL, usernameés password az oszlopok tartalmazzák az FTPS-közzététel cél URL-címét és hitelesítő adatait.

Azure PowerShell

Futtassa ezt az Azure PowerShell-parancsot, amely visszaadja az FTPS-hitelesítő adatokat a közzétételi profilból.

$profile = [xml](Get-AzWebAppPublishingProfile -ResourceGroupName "<GROUP_NAME>" -Name "<APP_NAME>" -Format "Ftp") 
$profile.publishData.publishProfile | Where-Object -Property publishMethod -eq Ftp | Select-Object -Property @{Name="URL"; Expression = {$_.publishUrl}}, 
@{Name="username"; Expression = {$_.userName}}, @{Name="password"; Expression = {$_.userPWD}} | Format-Table

Ebben a példában cserélje le <APP_NAME> a függvényalkalmazás nevét és <GROUP_NAME> az erőforráscsoportot. A visszaadott URL, usernameés password az oszlopok tartalmazzák az FTPS-közzététel cél URL-címét és hitelesítő adatait.

Üzemeltetési terv típusa

Függvényalkalmazás létrehozásakor egy üzemeltetési tervet is létrehoz, amelyben az alkalmazás fut. Egy csomag egy vagy több függvényalkalmazással is rendelkezhet. A függvények funkciói, skálázása és díjszabása a csomag típusától függ. További információt az Azure Functions üzemeltetési lehetőségeit ismertető cikkben talál.

A függvényalkalmazás által használt terv típusát az Azure Portalon, vagy az Azure CLI vagy az Azure PowerShell API-k használatával határozhatja meg.

A következő értékek jelzik a terv típusát:

Konstrukció típusa	Azure Portal	Azure CLI/PowerShell
Fogyasztás	Fogyasztás	Dynamic
Prémium	ElasticPremium	ElasticPremium
Dedikált (App Service)	Különböző	Különböző

Azure Portal

1. A függvényalkalmazás által használt terv típusának meghatározásához tekintse meg az App Service-csomagot a függvényalkalmazás Áttekintés lapján az Azure Portalon.

   

2. A tarifacsomag megtekintéséhez válassza ki az App Service-csomag nevét, majd a bal oldali panelen válassza a Beállítások > tulajdonságai lehetőséget .

Azure CLI

Futtassa a következő Azure CLI-parancsot az üzemeltetési csomag típusának lekéréséhez:

functionApp=<FUNCTION_APP_NAME>
resourceGroup=FunctionMonitoringExamples
appServicePlanId=$(az functionapp show --name $functionApp --resource-group $resourceGroup --query appServicePlanId --output tsv)
az appservice plan list --query "[?id=='$appServicePlanId'].sku.tier" --output tsv

Az előző példában cserélje le és <FUNCTION_APP_NAME> írja be <RESOURCE_GROUP> az erőforráscsoport és a függvényalkalmazás nevét.

Azure PowerShell

Futtassa a következő Azure PowerShell-parancsot az üzemeltetési csomag típusának lekéréséhez:

$FunctionApp = '<FUNCTION_APP_NAME>'
$ResourceGroup = '<RESOURCE_GROUP>'

$PlanID = (Get-AzFunctionApp -ResourceGroupName $ResourceGroup -Name $FunctionApp).AppServicePlan
(Get-AzFunctionAppPlan -Name $PlanID -ResourceGroupName $ResourceGroup).SkuTier

Az előző példában cserélje le és <FUNCTION_APP_NAME> írja be <RESOURCE_GROUP> az erőforráscsoport és a függvényalkalmazás nevét.

Migrálás tervezése

A függvényalkalmazásokat áttelepítheti egy Használati csomag és egy Prémium szintű csomag között Windows rendszeren. A tervek közötti migrálás során tartsa szem előtt a következő szempontokat:

• A dedikált (App Service-) csomagba való közvetlen migrálás nem támogatott.
• A migrálás Linuxon nem támogatott.
• A forrástervnek és a céltervnek ugyanabban az erőforráscsoportban és földrajzi régióban kell lennie. További információ: Alkalmazás áthelyezése másik App Service-csomagba.
• Az adott PARANCSSOR-parancsok a migrálás irányától függenek.
• A függvényvégrehajtások állásideje a függvényalkalmazás csomagok közötti migrálása során következik be.
• Az állapot- és egyéb alkalmazásspecifikus tartalmak megmaradnak, mivel az alkalmazás ugyanazt az Azure Files-megosztást használja a migrálás előtt és után is.

A csomagot az alábbi eszközökkel migrálhatja:

Azure Portal

Az Azure Portal használatával másik csomagra válthat.

Azure CLI

Az Azure CLI-parancsokkal manuálisan hozhat létre új csomagot, átválthatja az alkalmazást az új csomag használatára, és törölheti az eredeti csomagot.

Azure PowerShell

Az Azure PowerShell-parancsokkal manuálisan hozhat létre új csomagot, módosíthatja az alkalmazást az új csomag használatára, és törölheti az eredeti csomagot.

Válassza ki az alkalmazás áttelepítési irányát Windows rendszeren.

Használat a prémium verzióhoz

1. Az Azure Portalon lépjen a Használat csomag alkalmazásra, és válassza az App Service-csomag módosítása lehetőséget az App Service-csomag alatt.

2. Válassza a Prémium lehetőséget a Csomag típusa csoportban, hozzon létre egy új Prémium csomagot, és válassza az OK gombot.

További információ: Alkalmazás áthelyezése másik App Service-csomagba.

Prémium szintű felhasználás

1. Az Azure Portalon lépjen a Prémium csomag alkalmazásra, és válassza az App Service-csomag módosítása lehetőséget az App Service-csomag alatt.

2. Válassza a Felhasználás lehetőséget a Csomag típusa csoportban, hozzon létre egy új használati tervet, és válassza az OK gombot.

További információ: Alkalmazás áthelyezése másik App Service-csomagba.

Használat a prémium verzióhoz

A következő eljárással migrálhat egy használatalapú csomagból egy Prémium csomagba Windows rendszeren:

1. Futtassa az az functionapp create parancsot az alábbiak szerint egy új App Service-csomag (Elastic Premium) létrehozásához ugyanabban a régióban és erőforráscsoportban, mint a meglévő függvényalkalmazás:

   az functionapp plan create --name <NEW_PREMIUM_PLAN_NAME> --resource-group <MY_RESOURCE_GROUP> --location <REGION> --sku EP1
   

2. Futtassa az az functionapp update parancsot az alábbiak szerint a meglévő függvényalkalmazás új Prémium csomagba való migrálásához:

   az functionapp update --name <MY_APP_NAME> --resource-group <MY_RESOURCE_GROUP> --plan <NEW_PREMIUM_PLAN>
   

3. Ha már nincs szüksége az alkalmazás által eredetileg használt Fogyasztási csomagra, törölje az eredeti csomagot, miután meggyőződött arról, hogy sikeresen migrált az újra. Futtassa az az functionapp plan list parancsot az alábbiak szerint az erőforráscsoport összes fogyasztási csomagjának listájának lekéréséhez:

   az functionapp plan list --resource-group <MY_RESOURCE_GROUP> --query "[?sku.family=='Y'].{PlanName:name,Sites:numberOfSites}" -o table
   

   Biztonságosan törölheti a csomagot nulla helytel, amelyről migrált.

4. Futtassa az az functionapp plan delete parancsot az alábbiak szerint a migrált használati terv törléséhez.

   az functionapp plan delete --name <CONSUMPTION_PLAN_NAME> --resource-group <MY_RESOURCE_GROUP>
   

Prémium szintű felhasználás

A következő eljárással migrálhat prémium csomagból használati csomagba Windows rendszeren:

1. Futtassa az az functionapp create parancsot az alábbiak szerint egy új függvényalkalmazás (Használat) létrehozásához ugyanabban a régióban és erőforráscsoportban, mint a meglévő függvényalkalmazás. Ez a parancs egy új használati tervet is létrehoz, amelyben a függvényalkalmazás fut:

   az functionapp create --resource-group <MY_RESOURCE_GROUP> --name <NEW_CONSUMPTION_APP_NAME> --consumption-plan-location <REGION> --runtime <LANGUAGE_RUNTIME> --functions-version 4 --storage-account <STORAGE_NAME>
   

2. Futtassa az az functionapp show parancsot az alábbi módon az új függvényalkalmazással létrehozott használatterv nevének lekéréséhez:

   az functionapp show --resource-group <MY_RESOURCE_GROUP> --name <NEW_CONSUMPTION_APP_NAME> --query "{appServicePlanId}" -o tsv
   

   A használati terv neve a visszaadott teljes erőforrás-azonosító utolsó szegmense.

3. Futtassa az az functionapp update parancsot az alábbiak szerint a meglévő függvényalkalmazás új használati csomagba való migrálásához:

   az functionapp update --name <MY_APP_NAME> --resource-group <MY_RESOURCE_GROUP> --plan <NEW_CONSUMPTION_PLAN> --force
   

4. Futtassa az az functionapp delete parancsot az 1. lépésben létrehozott függvényalkalmazás törléséhez, mivel csak a meglévő függvényalkalmazás futtatásához létrehozott csomagra van szüksége:

   az functionapp delete --name <NEW_CONSUMPTION_APP_NAME> --resource-group <MY_RESOURCE_GROUP>
   

5. Ha már nincs szüksége az alkalmazás által eredetileg használt Prémium csomagra, törölje az eredeti csomagot, miután meggyőződött arról, hogy sikeresen migrált az újra. A Prémium csomag törléséig továbbra is fizetnie kell érte. Futtassa az az functionapp plan list parancsot az alábbiak szerint az erőforráscsoportban található összes Prémium csomag listájának lekéréséhez:

   az functionapp plan list --resource-group <MY_RESOURCE_GROUP> --query "[?sku.family=='EP'].{PlanName:name,Sites:numberOfSites}" -o table
   

6. Futtassa az az functionapp plan delete parancsot az alábbiak szerint az áttelepített Prémium csomag törléséhez:

   az functionapp plan delete --name <PREMIUM_PLAN> --resource-group <MY_RESOURCE_GROUP>
   

Használat a prémium verzióhoz

A következő eljárással migrálhat egy használatalapú csomagból egy Prémium csomagba Windows rendszeren:

1. A New-AzFunctionAppPlan parancs futtatásával hozzon létre egy új App Service-csomagot (Elastic Premium) ugyanabban a régióban és erőforráscsoportban, mint a meglévő függvényalkalmazás:

   New-AzFunctionAppPlan -Name <NEW_PREMIUM_PLAN_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -Location <REGION> -Sku EP1 -WorkerType Windows
   

2. Futtassa az Update-AzFunctionApp parancsot az alábbiak szerint a meglévő függvényalkalmazás áttelepítéséhez az új Prémium csomagba:

   Update-AzFunctionApp -Name <MY_APP_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -PlanName <NEW_PREMIUM_PLAN> -Force
   

3. Ha már nincs szüksége az alkalmazás által eredetileg használt Fogyasztási csomagra, a Remove-AzFunctionAppPlan parancsot az alábbiak szerint futtatva törölheti a migrált használati csomagot:

   Remove-AzFunctionAppPlan -Name <CONSUMPTION_PLAN_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -Force
   

Prémium szintű felhasználás

A következő eljárással migrálhat prémium csomagból használati csomagba Windows rendszeren:

1. A New-AzFunctionApp parancs futtatásával hozzon létre egy új függvényalkalmazást (Használat) ugyanabban a régióban és erőforráscsoportban, mint a meglévő függvényalkalmazás. Ez a parancs egy új használati tervet is létrehoz, amelyben a függvényalkalmazás fut:

   New-AzFunctionApp -Name <NEW_CONSUMPTION_APP_NAME> -StorageAccountName <STORAGE_NAME> -Location <REGION> -ResourceGroupName <MY_RESOURCE_GROUP> -Runtime <LANGUAGE_RUNTIME> -RuntimeVersion <LANGUAGE_VERSION> -FunctionsVersion 4 -OSType Windows
   

2. Futtassa a Get-AzFunctionApp parancsot az alábbi módon az új függvényalkalmazással létrehozott használatterv nevének lekéréséhez:

   Get-AzFunctionApp -ResourceGroupName <MY_RESOURCE_GROUP> -Name <NEW_CONSUMPTION_APP_NAME> | Select-Object -Property AppServicePlan | Format-List
   

3. Futtassa az Update-AzFunctionApp parancsot az alábbiak szerint a meglévő függvényalkalmazás áttelepítéséhez az új Használat csomagba:

   Update-AzFunctionApp -Name <MY_APP_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -PlanName <NEW_CONSUMPTION_PLAN> -Force
   

4. Ha már nincs szüksége az alkalmazás által eredetileg használt Fogyasztási csomagra, a Remove-AzFunctionAppPlan parancsot az alábbiak szerint futtatva törölheti a migrált használati csomagot:

   Remove-AzFunctionAppPlan -Name <CONSUMPTION_PLAN_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -Force
   

A függvény hozzáférési kulcsának lekérése

A HTTP által aktivált függvények általában a következő formátumú URL-címmel hívhatók meg: https://<APP_NAME>.azurewebsites.net/api/<FUNCTION_NAME>. Ha a függvény hitelesítése nem anonymousérték, akkor a kérésben meg kell adnia egy hozzáférési kulcsot is. A hozzáférési kulcs megadható az URL-címben a lekérdezési sztring ?code= használatával vagy a kérelem fejlécében. További információ: Függvényelérési kulcsok. A hozzáférési kulcsokat többféleképpen is lekérheti.

Azure Portal

1. Jelentkezzen be az Azure Portalra, majd keresse meg és válassza a függvényalkalmazást.

2. Jelölje ki az ellenőrizni kívánt függvényt.

3. A bal oldali panelen bontsa ki a Functions elemet, majd válassza az Alkalmazáskulcsok lehetőséget.

   Megjelenik az Alkalmazáskulcsok lap. Ezen a lapon megjelennek a gazdagépkulcsok, amelyek az alkalmazás bármely függvényének eléréséhez használhatók. Megjelenik a rendszerkulcs is, amely rendszergazdai szintű hozzáférést biztosít az összes függvényalkalmazás API-hoz.

A minimális jogosultságot is gyakorolhatja egy adott függvény kulcsával. Ehhez válassza a Függvénykulcsok lehetőséget a HTTP-aktivált függvény Fejlesztőeszközök területén.

Azure CLI

Futtassa a következő szkriptet az Azure Cloud Shellben, amelynek kimenete az alapértelmezett (gazdagép) kulcs , amely a függvényalkalmazás bármely HTTP-aktivált függvényének eléréséhez használható.

subName='<SUBSCRIPTION_ID>'
resGroup=AzureFunctionsContainers-rg
appName=glengagtestdocker
path=/subscriptions/$subName/resourceGroups/$resGroup/providers/Microsoft.Web/sites/$appName/host/default/listKeys?api-version=2018-11-01
az rest --method POST --uri $path --query functionKeys.default --output tsv

Ebben a szkriptben cserélje le <SUBSCRIPTION_ID> az előfizetés azonosítóját és <APP_NAME> a függvényalkalmazás nevét. Ez a szkript Bash-en fut a Cloud Shellben. A windowsos parancssorban való futtatáshoz módosítani kell.

Azure PowerShell

Futtassa a következő szkriptet, amelynek kimenete az alapértelmezett (gazdagép)kulcs , amely a függvényalkalmazás bármely HTTP-aktivált függvényének eléréséhez használható.

$subName = '<SUBSCRIPTION_ID>'
$rGroup = 'AzureFunctionsContainers-rg'
$appName = '<APP_NAME>'
$path = "/subscriptions/$subName/resourceGroups/$rGroup/providers/Microsoft.Web/sites/$appName/host/default/listKeys?api-version=2018-11-01"
((Invoke-AzRestMethod -Path $path -Method POST).Content | ConvertFrom-JSON).functionKeys.default

Ebben a szkriptben cserélje le <SUBSCRIPTION_ID> az <APP_NAME> előfizetés azonosítóját és a függvényalkalmazás nevét.

Fejlesztési korlátozások az Azure Portalon

Vegye figyelembe ezeket a korlátozásokat, amikor függvényeket fejleszt az Azure Portalon:

• A portálon belüli szerkesztés csak az Azure Portalon létrehozott vagy legutóbb módosított függvények esetében támogatott.
• A portálon belüli szerkesztés csak JavaScript-, PowerShell-, Python- és C#-szkriptfüggvényekhez támogatott.
• A portálon belüli szerkesztés nem támogatott a Flex Consumption csomag előzetes kiadásában.
• Amikor kódot helyez üzembe egy függvényalkalmazásban az Azure Portalon kívülről, a továbbiakban nem szerkesztheti az adott függvényalkalmazás kódját a portálon. Ebben az esetben csak folytassa a helyi fejlesztést.
• Lefordított C#-függvényekhez és Java-függvényekhez létrehozhatja a függvényalkalmazást és a kapcsolódó erőforrásokat a portálon. A függvénykódprojektet azonban helyileg kell létrehoznia, majd közzé kell tennie az Azure-ban.

Ha lehetséges, helyileg fejlesztheti a függvényeket, és közzéteheti a kódprojektet egy Azure-beli függvényalkalmazásban. További információkért lásd az Azure Functions helyi kódját és tesztelését.

Bővítmények manuális telepítése

A C# osztálytárfüggvények közvetlenül az osztálytárprojektben tartalmazhatják a kötési bővítmények NuGet-csomagjait. Más non-.NET nyelvekhez és C#-szkriptekhez bővítménycsomagokat kell használnia. Ha manuálisan kell telepítenie a bővítményeket, ezt az Azure Functions Core Tools helyi használatával teheti meg. Ha nem tud bővítménycsomagokat használni, és csak a portálon tud dolgozni, akkor az Advanced Tools (Kudu) használatával manuálisan kell létrehoznia a extensions.csproj fájlt közvetlenül a webhelyen. Először távolítsa el az elemet a extensionBundle host.json fájlból.

Ugyanez a folyamat minden más fájl esetében működik, amit hozzá kell adnia az alkalmazáshoz.

Fontos

Ha lehetséges, ne szerkessze közvetlenül a fájlokat a függvényalkalmazásban az Azure-ban. Javasoljuk, hogy töltse le az alkalmazásfájlokat helyileg, a Core Tools használatával bővítményeket és más csomagokat telepíthet, érvényesítse a módosításokat, majd tegye közzé újra az alkalmazást a Core Tools vagy a többi támogatott telepítési módszer használatával.

Az Azure Portal beépített Functions-szerkesztője lehetővé teszi a függvénykód és a konfigurációs fájlok frissítését közvetlenül a portálon:

1. Válassza ki a függvényalkalmazást, majd a Függvények területen válassza a Függvények lehetőséget.

2. Válassza ki a függvényt, és válassza a Kód + teszt lehetőséget a Fejlesztőeszközök területen.

3. Válassza ki a szerkeszteni kívánt fájlt, majd a Befejezéskor válassza a Mentés lehetőséget.

Az alkalmazás gyökerében lévő fájlokat( például function.proj vagy extensions.csproj) a Speciális eszközök (Kudu) használatával kell létrehozni és szerkeszteni:

1. Válassza ki a függvényalkalmazást, bontsa ki a fejlesztői eszközöket, majd válassza a Speciális eszközök>ugrása lehetőséget.

2. Ha a rendszer kéri, jelentkezzen be a Source Control Manager (SCM) webhelyre az Azure-beli hitelesítő adataival.

3. A hibakeresési konzol menüjében válassza a CMD lehetőséget.

4. Lépjen a lap .\site\wwwroottetejére, válassza a plusz (+) gombot, majd az Új fájlt.

5. Adjon nevet a fájlnak, például extensions.csproj, majd nyomja le az Enter billentyűt.

6. Válassza az új fájl melletti szerkesztés gombot, adja hozzá vagy frissítse a fájlban a kódot, majd válassza a Mentés lehetőséget.

7. A bővítményprojekt újraépítéséhez futtassa a következő parancsot egy olyan projektfájl esetében, mint a extensions.csproj:

   dotnet build extensions.csproj
   

Platformfunkciók

A függvényalkalmazások a Azure-alkalmazás szolgáltatásplatformon futnak, amely fenntartja őket. Így a függvényalkalmazások hozzáférhetnek az Azure alapvető webes üzemeltetési platformjának legtöbb funkciójához. Az Azure Portal használatakor a bal oldali panelen érheti el az App Service-platform számos funkcióját, amelyet a függvényalkalmazásokban használhat.

Az alábbi mátrix az Azure Portal szolgáltatástámogatását jelzi üzemeltetési terv és operációs rendszer alapján:

Szolgáltatás	Használatalapú csomag	Prémium szintű csomag	Dedikált terv
Speciális eszközök (Kudu)	Windows: ✔ Linux: X	✔	✔
App Service-szerkesztő	Windows: ✔ Linux: X	Windows: ✔ Linux: X	Windows: ✔ Linux: X
Biztonsági másolatok	X	X	✔
Console	Windows: parancssor Linux: X	Windows: parancssor Linux: SSH	Windows: parancssor Linux: SSH

A cikk további része a portál alábbi funkcióival foglalkozik, amelyek hasznosak a függvényalkalmazások számára:

• App Service-szerkesztő
• Console
• Speciális eszközök (Kudu)
• Üzembe helyezési lehetőségek
• CORS
• Hitelesítés

További információ az App Service-beállítások használatáról: Azure-alkalmazás szolgáltatásbeállítások konfigurálása.

App Service-szerkesztő

Az App Service-szerkesztő egy speciális portálon belüli szerkesztő, amellyel ugyanúgy módosíthatja a JSON-konfigurációs fájlokat és a kódfájlokat. Ha ezt a lehetőséget választja, egy külön böngészőlapot indít el egy alapszintű szerkesztővel. Ez a szerkesztő lehetővé teszi a Git-adattár integrálását, a kód futtatását és hibakeresését, valamint a függvényalkalmazás beállításainak módosítását. Ez a szerkesztő továbbfejlesztett fejlesztési környezetet biztosít a függvényekhez a beépített függvényszerkesztőhöz képest.

Javasoljuk, hogy fontolja meg a függvények fejlesztését a helyi számítógépen. A helyi fejlesztéskor és az Azure-ban való közzétételkor a projektfájlok írásvédettek lesznek az Azure Portalon. További információkért lásd az Azure Functions helyi kódját és tesztelését.

Console

A portálon belüli konzol ideális fejlesztői eszköz, ha inkább a parancssorból szeretné használni a függvényalkalmazást. A gyakori parancsok közé tartozik a címtár és a fájllétrehozás és a navigáció, valamint a kötegelt fájlok és szkriptek végrehajtása.

Helyi fejlesztéskor az Azure Functions Core Tools és az Azure CLI használatát javasoljuk.

Speciális eszközök (Kudu)

Az App Service speciális eszközei (más néven Kudu) hozzáférést biztosítanak a függvényalkalmazás speciális felügyeleti funkcióihoz. A Kuduban rendszerinformációkat, alkalmazásbeállításokat, környezeti változókat, webhelybővítményeket, HTTP-fejléceket és kiszolgálóváltozókat kezelhet. A Kudu elindításához keresse meg a függvényalkalmazás SCM-végpontját, például: https://<myfunctionapp>.scm.azurewebsites.net/.

Üzembe helyezési központ

Ha forrásvezérlő megoldást használ a függvénykód fejlesztésére és karbantartására, az Üzembe helyezési központ lehetővé teszi a forrásvezérlőből történő buildelést és üzembe helyezést. A projekt létrehozása és üzembe helyezése az Azure-ban frissítések készítésekor történik. További információ: Üzembehelyezési technológiák az Azure Functionsben.

Eltérő eredetű erőforrások megosztása

Annak érdekében, hogy megakadályozza a rosszindulatú kódfuttatást az ügyfélen, a modern böngészők letiltják a webalkalmazások kéréseit egy külön tartományban futó erőforrásokra. A forrásközi erőforrásmegosztás (CORS) lehetővé teszi, hogy a Access-Control-Allow-Origin fejléc deklarálja, hogy mely források hívhatják meg a végpontokat a függvényalkalmazásban.

Azure Portal

Amikor konfigurálja a függvényalkalmazás engedélyezett forráslistáját , a rendszer automatikusan hozzáadja a Access-Control-Allow-Origin fejlécet a függvényalkalmazás HTTP-végpontjaitól érkező összes válaszhoz.

Ha van egy másik tartománybejegyzés, a helyettesítő karakter (*) figyelmen kívül lesz hagyva.

Azure CLI

az functionapp cors add A paranccsal tartományt vehet fel az engedélyezett forráslistára. Az alábbi példa hozzáadja a contoso.com tartományt:

az functionapp cors add --name <FUNCTION_APP_NAME> \
--resource-group <RESOURCE_GROUP_NAME> \
--allowed-origins https://contoso.com

az functionapp cors show A parancs használatával listázhatja az aktuálisan engedélyezett forrásokat.

Azure PowerShell

A CORS-beállítások jelenleg nem frissíthetők az Azure PowerShell használatával.

Hitelesítés

Ha a függvények HTTP-eseményindítót használnak, megkövetelheti a hívások hitelesítését. Az App Service támogatja a Microsoft Entra hitelesítést és a közösségi szolgáltatókkal való bejelentkezést, például a Facebookot, a Microsoftot és a Twittert. Az egyes hitelesítésszolgáltatók konfigurálásával kapcsolatos információkért tekintse meg Azure-alkalmazás szolgáltatáshitelesítés áttekintését.

Kapcsolódó tartalom

• App Service-alkalmazás konfigurálása
• Azure Functions – folyamatos üzembe helyezés