Azure Functions – fejlesztői útmutató

Az Azure Functionsben minden függvény alapvető technikai fogalmakat és összetevőket oszt meg, függetlenül az előnyben részesített nyelvtől vagy fejlesztési környezettől. Ez a cikk nyelvspecifikus. Válassza ki a kívánt nyelvet a cikk tetején.

Ez a cikk feltételezi, hogy már elolvasta az Azure Functions áttekintését.

Kódprojekt

Az Azure Functions lényege egy nyelvspecifikus kódprojekt, amely egy vagy több függvénynek nevezett kódvégrehajtási egységet implementál. A függvények egyszerűen olyan metódusok, amelyek események, HTTP-kérések vagy ütemezés alapján futnak az Azure-felhőben. Az Azure Functions-kódprojektet úgy tekintheti, mint egy mechanizmust az egyes függvények rendszerezésére, üzembe helyezésére és közös kezelésére a projektben, amikor azok az Azure-ban futnak. További információ: Függvények rendszerezése.

Minden függvénynek rendelkeznie kell egy eseményindítóval, amely meghatározza a függvény indításának módját, és képes bemenetet adni a függvénynek. A függvények opcionálisan definiálhatnak bemeneti és kimeneti kötéseket. Ezek a kötések egyszerűsítik a más szolgáltatásokhoz való kapcsolódást anélkül, hogy ügyféloldali SDK-kkal kellene dolgozniuk. További információkat az Azure Functions triggers and bindings concepts (Az Azure Functions eseményindítói és kötési alapelvei) témakörben talál.

Az Azure Functions nyelvspecifikus projekt- és függvénysablonokat biztosít, amelyek megkönnyítik új kódprojektek létrehozását és függvények hozzáadását a projekthez. Az Azure Functions fejlesztését támogató eszközök bármelyikével új alkalmazásokat és függvényeket hozhat létre ezekkel a sablonokkal.

Fejlesztési eszközök

Az alábbi eszközök integrált fejlesztési és közzétételi élményt nyújtanak az Azure Functions számára az Ön által előnyben részesített nyelven:

• Visual Studio Code

• Azure Functions Core Tools (parancssor)

Ezek az eszközök integrálhatók az Azure Functions Core Toolsszal, így a helyi számítógépen futtathatók és hibakeresést végezhetnek a Functions-futtatókörnyezettel. További információkért lásd az Azure Functions helyi kódját és tesztelését.

Üzembe helyezés

Amikor közzéteszi a kódprojektet az Azure-ban, lényegében üzembe helyezi a projektet egy meglévő függvényalkalmazás-erőforrásban. A függvényalkalmazások végrehajtási környezetet biztosítanak az Azure-ban, amelyben a függvények futnak. Ezért ez a függvények üzembe helyezésének és felügyeletének egysége. Az Azure-erőforrások szempontjából a függvényalkalmazások egyenértékűek a Azure-alkalmazás Service-ben található helyerőforrással (Microsoft.Web/sites), amely egy webalkalmazással egyenértékű.

A függvényalkalmazások egy vagy több különálló függvényből állnak, amelyek kezelése, üzembe helyezése és skálázása együtt történik. A függvényalkalmazások összes függvénye ugyanazt a tarifacsomagot, üzembe helyezési módszert és futtatókörnyezeti verziót használja. További információ: Függvényalkalmazások kezelése.

Ha a függvényalkalmazás és a többi szükséges erőforrás még nem létezik az Azure-ban, először létre kell hoznia ezeket az erőforrásokat, mielőtt üzembe helyezheti a projektfájlokat. Ezeket az erőforrásokat az alábbi módokon hozhatja létre:

• A Visual Studio Code használata

• Az Azure CLI, az Azure PowerShell, az ARM-sablonok vagy a Bicep-sablonok programozott használata

• Az Azure Portalon

Az eszközalapú közzététel mellett a Functions más technológiákat is támogat a forráskód meglévő függvényalkalmazásban való üzembe helyezéséhez. További információ: Üzembehelyezési technológiák az Azure Functionsben.

Kapcsolódás szolgáltatásokhoz

A felhőalapú számítási szolgáltatások egyik fő követelménye az adatok olvasása és más felhőszolgáltatásokba való írása. A Functions számos kötést biztosít, amelyek megkönnyítik a szolgáltatásokhoz való csatlakozást anélkül, hogy ügyféloldali SDK-kkal kellene dolgoznia.

Akár a Functions által biztosított kötésbővítményeket használja, akár közvetlenül az ügyféloldali SDK-kkal dolgozik, biztonságosan tárolja a kapcsolati adatokat, és nem foglalja bele azokat a kódba. További információ: Csatlakozás.

Kötések

A Functions számos Azure-szolgáltatáshoz és néhány külső szolgáltatáshoz biztosít kötéseket, amelyek bővítményként vannak implementálva. További információkért tekintse meg a támogatott kötések teljes listáját.

A kötésbővítmények támogatják a bemeneteket és a kimeneteket is, és számos eseményindító bemeneti kötésként is működik. A kötések lehetővé teszik a szolgáltatásokhoz való csatlakozás konfigurálását, hogy a Functions-gazdagép kezelje az Ön számára az adathozzáférést. További információkat az Azure Functions triggers and bindings concepts (Az Azure Functions eseményindítói és kötési alapelvei) témakörben talál.

Ha problémákat tapasztal a kötésekből eredő hibákkal kapcsolatban, tekintse meg az Azure Functions kötési hibakódjainak dokumentációját .

Ügyfél-SDK-k

Bár a Functions kötéseket biztosít a függvénykód adathozzáférésének egyszerűsítéséhez, a projektben lévő ügyféloldali SDK-val továbbra is közvetlenül hozzáférhet egy adott szolgáltatáshoz, ha szeretné. Előfordulhat, hogy közvetlenül ügyféloldali SDK-kat kell használnia, ha a függvényekhez a mögöttes SDK olyan funkciója szükséges, amelyet a kötésbővítmény nem támogat.

Ügyféloldali SDK-k használatakor ugyanazt a folyamatot kell használnia a kötésbővítmények által használt kapcsolati sztring tárolásához és eléréséhez.

Kapcsolatok

Biztonsági szempontból ajánlott eljárásként az Azure Functions kihasználja a Azure-alkalmazás Szolgáltatás alkalmazásbeállítási funkcióit, hogy biztonságosabban tárolhassa a más szolgáltatásokhoz való csatlakozáshoz szükséges sztringeket, kulcsokat és egyéb jogkivonatokat. Az Azure-ban az alkalmazásbeállítások titkosítva vannak tárolva, és az alkalmazás futásidőben, környezeti változópárokként namevalue érhető el. Kapcsolati tulajdonságot igénylő eseményindítók és kötések esetén az alkalmazásbeállítás nevét kell megadnia a tényleges kapcsolati sztring helyett. Közvetlenül kapcsolati sztring vagy kulccsal nem konfigurálhat kötést.

Vegyük például egy tulajdonságot tartalmazó triggerdefiníciót connection . A kapcsolati sztring helyett a kapcsolati sztring tartalmazó környezeti változó nevét kell megadniaconnection. A titkos kódok hozzáférési stratégiájának használatával az alkalmazások biztonságosabbak, és megkönnyítik a környezetek közötti kapcsolatok módosítását. A még nagyobb biztonság érdekében identitásalapú kapcsolatokat is használhat.

Az alapértelmezett konfigurációszolgáltató környezeti változókat használ. Ezeket a változókat az alkalmazásbeállítások határozzák meg, amikor az Azure-ban és a helyi beállításfájlban futnak helyi fejlesztéskor.

Csatlakozás ion értékek

Amikor a kapcsolat neve egyetlen pontos értékre oldódik fel, a futtatókörnyezet az értéket kapcsolati sztring azonosítja, amely általában egy titkos kulcsot tartalmaz. A kapcsolati sztring részletei attól függenek, hogy melyik szolgáltatáshoz csatlakozik.

A kapcsolatnevek azonban több konfigurációelem gyűjteményére is hivatkozhatnak, amelyek az identitásalapú kapcsolatok konfigurálásához hasznosak. A környezeti változók gyűjteményként kezelhetők dupla aláhúzásjelekkel __végződő megosztott előtaggal. A csoportra ezután hivatkozhat úgy, hogy a kapcsolat nevét erre az előtagra állítja.

Előfordulhat például, hogy egy connection Azure Blob-eseményindító definíciójának tulajdonsága .Storage1 Mindaddig, amíg egy névvel ellátott Storage1környezeti változó nem konfigurál egyetlen sztringértéket, egy elnevezett Storage1__blobServiceUri környezeti változóval tájékoztathatja a blobServiceUri kapcsolat tulajdonságát. A kapcsolat tulajdonságai minden szolgáltatás esetében eltérőek. Tekintse meg a kapcsolatot használó összetevő dokumentációját.

Identitásalapú kapcsolat konfigurálása

Az Azure Functions egyes kapcsolatai úgy konfigurálhatók, hogy titkos kulcs helyett identitást használjanak. A támogatás a kapcsolatot használó bővítménytől függ. Bizonyos esetekben előfordulhat, hogy a Függvényekben továbbra is szükség van egy kapcsolati sztring, annak ellenére, hogy a szolgáltatás, amelyhez csatlakozik, támogatja az identitásalapú kapcsolatokat. A függvényalkalmazások felügyelt identitásokkal való konfigurálásáról szóló oktatóanyagot az identitásalapú kapcsolatokkal rendelkező függvényalkalmazások létrehozásáról szóló oktatóanyagban tekintheti meg.

Az alábbi összetevők támogatják az identitásalapú kapcsolatokat:

Az Azure Functions szolgáltatásban üzemeltetett identitásalapú kapcsolatok felügyelt identitást használnak. A rendszer alapértelmezés szerint a rendszer által hozzárendelt identitást használja, bár a felhasználó által hozzárendelt identitás megadható a credential tulajdonságokkal együtt clientID . Vegye figyelembe, hogy a felhasználó által hozzárendelt identitás erőforrás-azonosítóval való konfigurálása nem támogatott. Ha más környezetekben, például helyi fejlesztésben fut, a rendszer ehelyett a fejlesztői identitást használja, bár ez testre szabható. Lásd: Helyi fejlesztés identitásalapú kapcsolatokkal.

Engedély megadása az identitáshoz

Bármilyen identitást is használ, rendelkeznie kell a kívánt műveletek végrehajtásához szükséges engedélyekkel. A legtöbb Azure-szolgáltatás esetében ez azt jelenti, hogy egy szerepkört kell hozzárendelnie az Azure RBAC-ben beépített vagy egyéni szerepkörökkel, amelyek biztosítják ezeket az engedélyeket.

Az egyes összetevők engedélyeinek megismeréséhez válassza az alábbi lapok egyikét:

Identitásalapú kapcsolatok gyakori tulajdonságai

Az Azure-szolgáltatások identitásalapú kapcsolatai a következő gyakori tulajdonságokat fogadják el, ahol <CONNECTION_NAME_PREFIX> a tulajdonság értéke connection szerepel az eseményindító vagy a kötés definíciójában:

Egy adott kapcsolattípus esetében más lehetőségek is támogatottak lehetnek. Tekintse meg a kapcsolatot létesítő összetevő dokumentációját.

Helyi fejlesztés identitásalapú kapcsolatokkal

Amikor helyileg futtatja a függvényprojektet, a fenti konfiguráció arra utasítja a futtatókörnyezetet, hogy használja a helyi fejlesztői identitást. A kapcsolat a következő helyekről próbál jogkivonatot lekérni, sorrendben:

• Microsoft-alkalmazások között megosztott helyi gyorsítótár
• Az aktuális felhasználói környezet a Visual Studióban
• Az aktuális felhasználói környezet a Visual Studio Code-ban
• Az Azure CLI aktuális felhasználói környezete

Ha egyik lehetőség sem sikeres, hiba történik.

Előfordulhat, hogy az identitása már rendelkezik bizonyos szerepkör-hozzárendelésekkel a fejlesztéshez használt Azure-erőforrásokhoz, de előfordulhat, hogy ezek a szerepkörök nem biztosítják a szükséges adathozzáférést. A tulajdonoshoz hasonló felügyeleti szerepkörök nem elegendőek. Ellenőrizze, hogy milyen engedélyek szükségesek az egyes összetevők kapcsolataihoz, és győződjön meg arról, hogy azokat saját magához rendelte.

Bizonyos esetekben előfordulhat, hogy más identitás használatát szeretné megadni. Hozzáadhat konfigurációs tulajdonságokat a kapcsolathoz, amelyek a Microsoft Entra szolgáltatásnév ügyfélazonosítója és titkos ügyfélkódja alapján másodlagos identitásra mutatnak. Ez a konfigurációs beállítás nem támogatott az Azure Functions szolgáltatásban való üzemeltetés esetén. Ha azonosítót és titkos kulcsot szeretne használni a helyi gépen, adja meg a kapcsolatot a következő további tulajdonságokkal:

Íme egy példa az local.settings.json Azure Blobokkal való identitásalapú kapcsolathoz szükséges tulajdonságokra:

{
  "IsEncrypted": false,
  "Values": {
    "<CONNECTION_NAME_PREFIX>__blobServiceUri": "<blobServiceUri>",
    "<CONNECTION_NAME_PREFIX>__queueServiceUri": "<queueServiceUri>",
    "<CONNECTION_NAME_PREFIX>__tenantId": "<tenantId>",
    "<CONNECTION_NAME_PREFIX>__clientId": "<clientId>",
    "<CONNECTION_NAME_PREFIX>__clientSecret": "<clientSecret>"
  }
}

Csatlakozás gazdagépre identitással

Az Azure Functions-gazdagép a be van állítva AzureWebJobsStorage tárolókapcsolatot használja olyan alapvető viselkedések engedélyezéséhez, mint például az időzítő eseményindítók egyszeri végrehajtásának koordinálása és az alapértelmezett alkalmazáskulcs-tárolás. Ez a kapcsolat identitás használatára is konfigurálható.

Identitásalapú kapcsolat AzureWebJobsStoragehasználatához konfigurálja a következő alkalmazásbeállításokat:

Az identitásalapú kapcsolatok általános tulajdonságai is beállíthatók .

Ha AzureWebJobsStorage olyan tárfiókot használ, amely a globális Azure alapértelmezett DNS-utótagját és szolgáltatásnevét használja, a https://<accountName>.[blob|queue|file|table].core.windows.net formátumot követve ehelyett beállíthatja AzureWebJobsStorage__accountName a tárfiók nevét. Az egyes tárolási szolgáltatások végpontjai erre a fiókra következtetnek. Ez nem működik, ha a tárfiók szuverén felhőben van, vagy egyéni DNS-sel rendelkezik.

Létre kell hoznia egy szerepkör-hozzárendelést, amely hozzáférést biztosít az "AzureWebJobsStorage" tárfiókjához futásidőben. A tulajdonoshoz hasonló felügyeleti szerepkörök nem elegendőek. A Storage Blob Data Owner szerepkör lefedi a Functions gazdagéptároló alapvető igényeit – a futtatókörnyezetnek olvasási és írási hozzáférést kell biztosítania a blobokhoz, valamint tárolókat kell létrehoznia. Több bővítmény is ezt a kapcsolatot használja alapértelmezett helyként blobok, üzenetsorok és táblák esetében, és ezek a használatok követelményeket is tartalmazhatnak az alábbi táblázatban leírtak szerint. További engedélyekre lehet szüksége, ha az "AzureWebJobsStorage"-t bármilyen más célra használja.

Jelentéskészítési problémák

Nyílt forráskódú adattárak

Az Azure Functions kódja nyílt forráskód, és az alábbi GitHub-adattárakban találja a legfontosabb összetevőket:

• Azure Functions

• Azure Functions-gazdagép

• Azure Functions-portál

• Azure Functions-sablonok

• Azure WebJobs SDK

• Azure WebJobs SDK-bővítmények

További lépések

További információkat találhat az alábbi forrásokban:

• Azure Functions-forgatókönyvek
• Az Azure Functions helyi kódolása és tesztelése
• Azure Functions – ajánlott eljárások