Rövid útmutató: Az első C#-függvény létrehozása az Azure-ban a Visual Studióval
Azure Functions lehetővé teszi, hogy a Visual Studióval helyi C#-függvényprojekteket hozzon létre, majd egyszerűen közzétegye a projektet, hogy skálázható kiszolgáló nélküli környezetben fusson az Azure-ban. Ha a C#-alkalmazásokat helyileg szeretné fejleszteni a Visual Studio Code használatával, akkor inkább a jelen cikk Visual Studio Code-alapú verzióját érdemes figyelembe vennie.
Ez a cikk alapértelmezés szerint bemutatja, hogyan hozhat létre olyan C#-függvényeket, amelyek a .NET 6-on futnak ugyanabban a folyamatban, mint a Functions-gazdagép. Ezek a folyamaton belüli C# függvények csak a hosszú távú támogatás (LTS) .NET-verzióiban támogatottak, például a .NET 6-ban. A projekt létrehozásakor dönthet úgy, hogy egy .NET 6-on futó függvényt hoz létre egy elkülönített feldolgozófolyamatban. Az elkülönített munkavégző folyamat támogatja a .NET LTS- és standard kifejezéstámogatási (STS) verzióit is. További információ: A .NET Functions izolált feldolgozófolyamat-útmutatójának támogatott verziói .
Ebben a cikkben az alábbiakkal ismerkedhet meg:
- C#-osztálytárprojekt létrehozása a Visual Studióval.
- Hozzon létre egy függvényt, amely válaszol a HTTP-kérésekre.
- Futtassa a kódot helyileg a függvény működésének ellenőrzéséhez.
- Telepítse a kódprojektet a Azure Functions.
Ennek a rövid útmutatónak a végrehajtása néhány DOLLÁRcent vagy annál kisebb költséggel jár az Azure-fiókjában.
Előfeltételek
Visual Studio 2022. Győződjön meg arról, hogy a telepítés során ki kell választania az Azure fejlesztési számítási feladatát.
Azure-előfizetés. Ha még nincs fiókja, a kezdés előtt hozzon létre egy ingyenes fiókot .
Függvényalkalmazás-projekt létrehozása
A Visual Studio Azure Functions projektsablonja létrehoz egy C#-osztálytárprojektet, amelyet közzétehet egy függvényalkalmazásban az Azure-ban. A függvényalkalmazásokkal logikai egységként csoportosíthatja a függvényeket az erőforrások egyszerűbb kezelése, üzembe helyezése, skálázása és megosztása érdekében.
A Visual Studio menüjében válassza azÚj>projekt fájlja> lehetőséget.
Az Új projekt létrehozása területen írja be a függvényeket a keresőmezőbe, válassza ki a Azure Functions sablont, majd válassza a Tovább gombot.
Az Új projekt konfigurálása területen adja meg a projekt projektnevét , majd válassza a Tovább gombot. A függvényalkalmazás nevének egy C#-névtérként is érvényesnek kell lennie, ezért ne használjon aláhúzásjeleket, kötőjeleket vagy más nem alfanumerikus karaktereket.
A További információk területen válasszon a Functions-feldolgozó alábbi lehetőségei közül:
Beállítás .NET-verzió Feldolgozási modell Description .NET 6.0 (hosszú távú támogatás) .NET 6 Folyamatban Folyamatban A C#-függvények csak a hosszú távú támogatás (LTS) .NET-verzióiban támogatottak. A függvénykód ugyanabban a folyamatban fut, mint a Functions-gazdagép. .NET 6.0 izolált (hosszú távú támogatás) .NET 6 Izolált feldolgozói folyamat A függvények a .NET 6-on futnak, de a Függvények gazdagéptől eltérő folyamatban. .NET 7.0 Izolált .NET 7 Izolált feldolgozói folyamat Mivel a .NET 7 nem a .NET LTS-verziója, a függvényeknek egy elkülönített folyamat során kell futniuk a .NET 7-en. .NET-keretrendszer Izolált v4 .NET-keretrendszer 4.8 Izolált feldolgozói folyamat Akkor válassza ezt a lehetőséget, ha a függvényeknek csak a .NET-keretrendszer támogatott kódtárakat kell használniuk. .NET Core 3.1 (hosszú távú támogatás) .NET Core 3.1 Folyamatban A .NET Core 3.1 már nem a .NET támogatott verziója, és a Functions 4.x verziója nem támogatja. Használja helyette a .NET 6.0-t. .NET-keretrendszer v1 .NET-keretrendszer Folyamatban Akkor válassza ezt a lehetőséget, ha a függvényeknek csak a .NET-keretrendszer régebbi verzióiban támogatott kódtárakat kell használniuk. A Functions-futtatókörnyezet 1.x-es verziójára van szükség. A két folyamatmodell különböző API-kat használ, és mindegyik folyamatmodell egy másik sablont használ a függvény projektkódjának létrehozásakor. Ha nem látja a .NET 6.0-s és újabb .NET-futtatókörnyezeti verzióinak beállításait, előfordulhat, hogy frissítenie kell a Azure Functions eszközök telepítését.
A további további információbeállításokhoz használja az alábbi táblázatban található értékeket:
Beállítás Érték Leírás Függvény HTTP-eseményindító Ez az érték létrehoz egy HTTP-kérés által aktivált függvényt. Az Azurite használata futtatókörnyezeti tárfiókhoz (AzureWebJobsStorage) Engedélyezés Mivel az Azure-ban egy függvényalkalmazáshoz tárfiók szükséges, a rendszer hozzárendel vagy létrehoz egyet, amikor közzéteszi a projektet az Azure-ban. A HTTP-eseményindítók nem használnak Azure Storage-fiókot kapcsolati sztring; minden más eseményindító-típushoz érvényes Azure Storage-fiók kapcsolati sztring szükséges. Ha ezt a lehetőséget választja, a rendszer az Azurite emulátort használja. Engedélyszint Névtelen A létrehozott függvényt bármely ügyfél elindíthatja, kulcs megadása nélkül. Ez az engedélyezési beállítás megkönnyíti az új függvény tesztelését. További információ a kulcsokról és az engedélyezésről: Engedélyezési kulcsok , HTTP- és webhookkötések. Győződjön meg arról, hogy az Engedélyezési szintetNévtelen értékre állítja. Ha a függvény alapértelmezett szintjét választja, a függvénykulcsot be kell mutatnia az Azure-beli függvényvégpont eléréséhez szükséges kérésekben.
Válassza a Létrehozás lehetőséget a függvényprojekt és a HTTP-eseményindító függvény létrehozásához.
A Visual Studio létrehoz egy projektet és osztályt, amely sablonkódot tartalmaz a HTTP-eseményindító függvény típusához. A sablonkód elküld egy HTTP-választ, amely tartalmaz egy értéket a kérelem szövegtörzséből vagy a lekérdezési sztringből. Az HttpTrigger
attribútum azt határozza meg, hogy a függvényt EGY HTTP-kérés aktiválja.
A függvény átnevezése
A FunctionName
metódusattribútum a függvény nevét állítja be, amely alapértelmezés szerint a következőként Function1
jön létre: . Mivel az eszközhasználat nem teszi lehetővé, hogy felülbírálja az alapértelmezett függvénynevet a projekt létrehozásakor, egy perc alatt jobb nevet hozhat létre a függvényosztálynak, fájlnak és metaadatoknak.
A Fájlkezelő kattintson a jobb gombbal a Function1.cs fájlra, és nevezze át a fájlnak
HttpExample.cs
.A kódban nevezze át a Function1 osztályt a következőre:
HttpExample
.A nevű
Run
metódusbanHttpTrigger
nevezze át a metódusattribútumot aFunctionName
következőre:HttpExample
.
A függvénydefiníciónak a következő kódhoz hasonlóan kell kinéznie:
[FunctionName("HttpExample")]
public static async Task<IActionResult> Run(
[HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)] HttpRequest req,
ILogger log)
Most, hogy átnevezte a függvényt, tesztelheti a helyi számítógépen.
A függvény helyi futtatása
A Visual Studio integrálható a Azure Functions Core Tools szolgáltatással, így a függvényeket helyileg tesztelheti a teljes Azure Functions futtatókörnyezet használatával.
A függvény futtatásához nyomja le az F5 billentyűt a Visual Studióban. Előfordulhat, hogy engedélyeznie kell egy tűzfalkivételt, hogy az eszközök kezelni tudják a HTTP-kéréseket. A rendszer soha nem kényszeríti ki az engedélyezési szinteket, amikor helyileg futtat egy függvényt.
Másolja a függvény URL-címét az Azure-függvény futtatókörnyezetéből.
Illessze be a HTTP-kérelem URL-címét a böngésző címsorába. Fűzze hozzá a lekérdezési sztringet
?name=<YOUR_NAME>
ehhez az URL-címhez, és futtassa a kérést. Az alábbi képen a böngészőben a függvény által visszaadott helyi GET kérésre adott válasz látható:A hibakeresés leállításához nyomja le a Shift+F5 billentyűkombinációt a Visual Studióban.
Miután ellenőrizte, hogy a függvény megfelelően fut a helyi számítógépen, tegye közzé a projektet az Azure-ban.
A projekt közzététele az Azure-ban
A Visual Studio közzéteheti a helyi projektet az Azure-ban. A projekt közzététele előtt rendelkeznie kell egy függvényalkalmazással az Azure-előfizetésében. Ha még nem rendelkezik függvényalkalmazással az Azure-ban, a Visual Studio közzétételi szolgáltatása létrehoz egyet a projekt első közzétételekor. Ebben a cikkben egy függvényalkalmazást és a kapcsolódó Azure-erőforrásokat fog létrehozni.
A Megoldáskezelőben kattintson a jobb gombbal a projektre, és válassza a Publish (Közzététel) lehetőséget. A Cél területen válassza az Azure , majd a Tovább lehetőséget.
Válassza az Azure-függvényalkalmazás (Windows) lehetőséget az Adott célhoz, amely létrehoz egy Windowson futó függvényalkalmazást, majd válassza a Tovább gombot.
A függvénypéldányban válassza az Új Azure-függvény létrehozása... lehetőséget.
Hozzon létre egy új példányt a következő táblázatban megadott értékekkel:
Beállítás Érték Leírás Név Globálisan egyedi név Az új függvényalkalmazást azonosító egyedi név. Fogadja el ezt a nevet, vagy írjon be egy új nevet. Az érvényes karakterek a következők: a-z
,0-9
és-
.Előfizetés Az Ön előfizetése A használandó előfizetés. Fogadja el ezt az előfizetést, vagy válasszon egy újat a legördülő listából. Erőforráscsoport Az erőforráscsoport neve Az erőforráscsoport, amelyben létre szeretné hozni a függvényalkalmazást. Válasszon ki egy meglévő erőforráscsoportot a legördülő listából, vagy válassza az Új lehetőséget egy új erőforráscsoport létrehozásához. Csomag típusa Használat Amikor egy használatalapú csomagban futó függvényalkalmazásban teszi közzé a projektet, csak a függvényalkalmazás végrehajtásáért kell fizetnie. Más üzemeltetési csomagok magasabb költségekkel járnak. Hely Az App Service helye Válasszon egy Helyet egy Önhöz közeli régióban vagy a függvények által elért egyéb szolgáltatások közül. Azure Storage Általános célú tárfiók A Functions futtatókörnyezetének szüksége van egy Azure Storage-fiókra. Általános célú tárfiók konfigurálásához válassza az Új lehetőséget. Választhat olyan meglévő fiókot is, amely megfelel a tárfiók követelményeinek. A Létrehozás lehetőséget választva hozzon létre egy függvényalkalmazást és annak kapcsolódó erőforrásait az Azure-ban. Az erőforrás-létrehozás állapota az ablak bal alsó sarkában látható.
A Functions-példányban ellenőrizze, hogy a Futtatás csomagfájlból jelölőnégyzet be van-e jelölve. A függvényalkalmazás a Zip Deploy használatával van üzembe helyezve, és engedélyezve van a Csomagból futtatás mód. A Zip Deploy az ajánlott üzembe helyezési módszer a függvényprojekthez, amely jobb teljesítményt eredményez.
Válassza a Befejezés lehetőséget, majd a Közzététel lapon válassza a Közzététel lehetőséget a projektfájlokat tartalmazó csomag üzembe helyezéséhez az Új függvényalkalmazásban az Azure-ban.
Az üzembe helyezés befejezése után az Azure-beli függvényalkalmazás gyökér URL-címe megjelenik a Közzététel lapon.
A Közzététel lap Üzemeltetés szakaszában válassza a Megnyitás Azure Portal lehetőséget. Ezzel megnyitja az új függvényalkalmazás Azure-erőforrását a Azure Portal.
A függvény ellenőrzése az Azure-ban
A Cloud Explorerben ki kell választania az új függvényalkalmazást. Ha nem, bontsa ki az előfizetése >App Services elemét, és válassza ki az új függvényalkalmazást.
Kattintson a jobb gombbal a függvényalkalmazásra, és válassza a Megnyitás böngészőben parancsot. Ez megnyitja a függvényalkalmazás gyökerét az alapértelmezett webböngészőben, és megjeleníti azt a lapot, amely jelzi, hogy a függvényalkalmazás fut.
A böngésző címsorában fűzze hozzá a sztringet
/api/HttpExample?name=Functions
az alap URL-címhez, és futtassa a kérést.A HTTP-eseményindító függvényt meghívó URL-cím formátuma a következő:
http://<APP_NAME>.azurewebsites.net/api/HttpExample?name=Functions
Nyissa meg ezt az URL-címet, és megjelenik egy válasz a böngészőben a függvény által visszaadott távoli GET kérésre, amely az alábbi példához hasonlóan néz ki:
Az erőforrások eltávolítása
Az erőforrások kifejezés az Azure-ban például függvényalkalmazásokra, függvényekre vagy tárfiókokra utal. Ezek erőforráscsoportokba vannak csoportosítva, és a csoport törlésével törölheti a csoport összes elemét.
Ehhez a rövid útmutatóhoz Azure-erőforrásokat hozott létre. Fiókjának állapotától és a szolgáltatási díjszabástól függően lehetséges, hogy az erőforrások használata díjköteles. Az ebben a gyűjteményben lévő többi rövid útmutató erre a rövid útmutatóra épül. Ha további rövid útmutatókkal, oktatóanyagokkal vagy az ebben a rövid útmutatóban létrehozott szolgáltatásokkal szeretne dolgozni, ne törölje az erőforrásokat.
Az alábbi lépésekkel törölheti a függvényalkalmazást és annak kapcsolódó erőforrásait, hogy elkerülje a további költségek felmerülését.
A Visual Studio Közzététel párbeszédpanel Üzemeltetés szakaszában válassza a Megnyitás Azure Portal lehetőséget.
A függvényalkalmazás oldalán válassza az Áttekintés lapot, majd válassza az Erőforráscsoport alatti hivatkozást.
Az Erőforráscsoport lapon tekintse át a belefoglalt erőforrások listáját, és ellenőrizze, hogy ezeket szeretné-e törölni.
Válassza az Erőforráscsoport törlése elemet, majd kövesse az utasításokat.
A törlés eltarthat néhány percig. Amint a művelet befejeződött, néhány másodpercre egy értesítés jelenik meg. Az értesítést úgy is megtekintheti, ha kiválasztja a harang ikont az oldal tetején.
Következő lépések
Ebben a rövid útmutatóban a Visual Studióval létrehozott és közzétett egy C#-függvényalkalmazást az Azure-ban egy egyszerű HTTP-eseményindító függvénnyel.
A következő cikk a választott folyamatmodelltől függ.
Ha többet szeretne megtudni a Functions-gazdagépen folyamatban futó C#-függvényekkel való munkáról, olvassa el a C#-osztálytárfüggvények fejlesztése Azure Functions használatával című témakört.
Folytassa a következő cikkel, amelyből megtudhatja, hogyan adhat hozzá Azure Storage-üzenetsor-kötést a függvényhez: