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.

1. A Visual Studio menüjében válassza azÚj>projekt fájlja> lehetőséget.

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

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

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

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

6. 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 Function1jö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.

1. A Fájlkezelő kattintson a jobb gombbal a Function1.cs fájlra, és nevezze át a fájlnakHttpExample.cs.

2. A kódban nevezze át a Function1 osztályt a következőre: HttpExample.

3. A nevű Runmetódusban HttpTrigger nevezze át a metódusattribútumot a FunctionName következőre: HttpExample.

A függvénydefiníciónak a következő kódhoz hasonlóan kell kinéznie:

Folyamatban

[FunctionName("HttpExample")]
public static async Task<IActionResult> Run(
    [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)] HttpRequest req,
    ILogger log)

Izolált folyamat

[Function("HttpExample")]
public static HttpResponseData Run([HttpTrigger(AuthorizationLevel.Anonymous, "get", "post")] HttpRequestData req,
    FunctionContext executionContext)

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.

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

2. Másolja a függvény URL-címét az Azure-függvény futtatókörnyezetéből.

   

3. 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ó:

   

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

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

   

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

   

3. A függvénypéldányban válassza az Új Azure-függvény létrehozása... lehetőséget.

   

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

   

5. 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ó.

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

   

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

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

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

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

   

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

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

1. A Visual Studio Közzététel párbeszédpanel Üzemeltetés szakaszában válassza a Megnyitás Azure Portal lehetőséget.

2. A függvényalkalmazás oldalán válassza az Áttekintés lapot, majd válassza az Erőforráscsoport alatti hivatkozást.

   

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

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

Folyamatban

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:

Azure Storage-üzenetsor-kötés hozzáadása a függvényhez

Izolált folyamat

Az elkülönített feldolgozói folyamatban futó C#-függvények használatával kapcsolatos további információkért lásd: Útmutató a C# Azure Functions izolált feldolgozói folyamatban való futtatásához. Tekintse meg a .NET által támogatott verziókat , ha meg szeretné tekinteni a támogatott .NET-verziók más verzióit egy elkülönített feldolgozói folyamatban.

Folytassa a következő cikkel, amelyből megtudhatja, hogyan adhat hozzá Azure Storage-üzenetsor-kötést a függvényhez:

Azure Storage-üzenetsor-kötés hozzáadása a függvényhez