Rövid útmutató: Az első C#-függvény létrehozása az Azure-ban a Visual Studióval

Az 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 inkább helyileg szeretné fejleszteni a C#-alkalmazásokat 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 .NET 8-on futnak egy izolált feldolgozói folyamatban. Az izolált feldolgozói folyamatban futó függvényalkalmazások a .NET minden olyan verziójában támogatottak, amelyeket a Functions támogat. További információ: Támogatott verziók.

Ebben a cikkben az alábbiakkal ismerkedhet meg:

• C#-osztálytárprojekt létrehozása a Visual Studióval.
• HTTP-kérelmekre válaszoló függvény létrehozása.
• Futtassa helyileg a kódot a függvény viselkedésének ellenőrzéséhez.
• A kódprojekt üzembe helyezése az Azure Functionsben.

Ennek a gyors kezdési útmutatónak a befejezése néhány cent (USD) vagy még kevesebb költséggel jár az Azure-fiókjában.

Ez a videó bemutatja, hogyan hozhat létre C# függvényt az Azure-ban.

A videó lépéseit a következő szakaszokban is ismertetjük.

Előfeltételek

• Visual Studio 2022. A telepítés során mindenképpen válassza ki az Azure fejlesztési számítási feladatát.

• Azure-előfizetés. Ha még nem rendelkezik fiókkal, 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 a Fájl>Új>Projekt lehetőséget.

2. Új projekt létrehozásakor írja be a függvényeket a keresőmezőbe, válassza ki az 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 fennmaradó további információbeállítások esetében:

   Beállítás	Érték	Leírás
   Függvények feldolgozója	.NET 8.0 izolált (hosszú távú támogatás)	A függvények a .NET 8-on futnak egy izolált feldolgozói folyamatban.
   Függvény	HTTP-eseményindító	Ez az érték egy HTTP-kérés által aktivált függvényt hoz létre.
   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ókra van szükség, a rendszer hozzárendel vagy létrehoz egyet, amikor közzéteszi a projektet az Azure-ban. A HTTP-eseményindító nem használ Azure Storage-fiók kapcsolati sztringet; 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ó: Engedélyezési szint.

   

   Győződjön meg arról, hogy az engedélyezési szintet névtelenre állítja. Ha a függvény alapértelmezett szintjét választja, a függvénykulcsot be kell mutatnia a függvényvégpont azure-beli eléréséhez szükséges kérelmekben.

5. 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 a HTTP-eseményindító függvénytípushoz tartozó sablonkódot tartalmazza. 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 HTTP-kérés aktiválja.

A függvény átnevezése

A Function metódusattribútum beállítja a függvény nevét, amely alapértelmezés szerint a következőképpen jön létre Function1. Mivel az eszközhasználat nem teszi lehetővé az alapértelmezett függvénynév felülbírálását a projekt létrehozásakor, eltarthat egy percig, amíg jobb nevet hoz létre a függvényosztály, a fájl és a metaadatok számára.

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

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

3. A Run nevű metódusban nevezze át a Function metódusattribútumot erre: HttpExample.

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

[Function("HttpExample")]
public IActionResult Run([HttpTrigger(AuthorizationLevel.Anonymous, "get", "post")] HttpRequest req)
{
    _logger. LogInformation("C# HTTP trigger function processed a request.");
    return new OkObjectResult("Hello, functions");
}

Most, hogy átnevezte a függvényt, tesztelheti a helyi számítógépen.

Függvény helyben futtatása

A Visual Studio integrálható az Azure Functions Core Toolsszal, í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, ha helyileg futtat egy függvényt.

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

   

3. Illessze be a HTTP-kérés URL-címét a böngésző címsorába, é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 Shifta 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 segíthet létrehozni egyet a projekt közzététele előtt. Ebben a cikkben egy Olyan függvényalkalmazást hoz létre, amely Linuxon fut egy Flex Consumption-csomagban, amely az eseményvezérelt és biztonságos kiszolgáló nélküli függvények ajánlott csomagja.

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-t, majd a Tovább lehetőséget.

2. Adott célon válassza az Azure-függvényalkalmazást, majd a Tovább lehetőséget.

3. A Functions-példányon válassza az Új létrehozása lehetőséget.

   

4. Hozzon létre egy új példányt az alábbi 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 adjon meg egy új nevet. Az érvényes karakterek a következők: a-z, 0-9és -.
   Előfizetés neve	Az előfizetés neve	Az Azure-előfizetés, amelyet használni kell. 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 az erőforráscsoport, amelyben létre szeretné hozni a függvényalkalmazást. Új erőforráscsoport létrehozásához válassza az Új lehetőséget. A legördülő listából egy meglévő erőforráscsoportot is használhat.
   Csomag típusa	Rugalmas fogyasztás	Ha egy Flex Consumption-csomagban futó függvényalkalmazásban teszi közzé a projektet, előfordulhat, hogy csak a függvényalkalmazás végrehajtásáért fizet. Más üzemeltetési tervek magasabb költségekkel járnak.
   Operációs rendszer	Linux	A Flex Consumption csomaghoz jelenleg Linux szükséges.
   Helyen	Az app service helye	Válasszon ki egy helyet egy Olyan Azure-régióban, amelyet a Rugalmas használat csomag támogat.
   Példány memóriamérete	2048	Annak a virtuálisgép-példánynak a memóriamérete, amelyen az alkalmazás fut, és amely egyedi a Flex Consumption csomagra.
   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. Azt is választhatja, hogy egy meglévő fiókot használ, amely megfelel a tárfiók követelményeinek.
   Application Insights	Application Insights-példány	Engedélyeznie kell az Azure Application Insights integrációját a függvényalkalmazáshoz. Az Új lehetőséget választva új példányt hozhat létre egy új vagy egy meglévő Log Analytics-munkaterületen. Dönthet úgy is, hogy egy meglévő példányt használ.

   

5. A Létrehozás gombra kattintva létrehozhat 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. 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ésekor az Azure-beli függvényalkalmazás gyökér URL-címe megjelenik a Közzététel lapon.

7. A Közzététel lap Üzemeltetés szakaszában válassza a Megnyitás az Azure Portalon lehetőséget. Az új Azure funkcióalkalmazás megnyílik az Azure portálon.

   

Ellenőrizze a függvényét az Azure-ban

1. Az Azure Portalon az új függvényalkalmazás Áttekintés lapján kell lennie.

2. A Függvények területen válassza ki az új HttpExample nevű függvényt, majd a függvényoldalon válassza a Függvény URL-címének lekérése, majd a Másolás vágólapra ikont.

3. A böngésző címsorában illessze be a másolt URL-címet, és futtassa a kérést.

   A HTTP-eseményindító függvényt meghívó URL-cím a következő formátumban van:

   https://<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 a következő 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.

A gyors kezdéshez Azure-erőforrásokat készített. Ezekért az erőforrásokért a fiók állapotától és a szolgáltatás díjszabásától függően számlázhatók. 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 Publish párbeszédablakban az Üzemeltetés szakaszban válassza a Megnyitás az Azure portálon lehetőséget.

2. A függvényalkalmazás lapjá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 ezek-e törölni kívánt erőforrások.

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.

Ha többet szeretne megtudni az izolált feldolgozói folyamatban futó C# függvényekkel való munkáról, tekintse meg a C# Azure Functions izolált feldolgozói folyamatban való futtatásának útmutatóját. Tekintse meg a .NET által támogatott verziókat , és tekintse meg a támogatott .NET-verziók egyéb verzióit egy izolált feldolgozói folyamatban.

A következő cikkbő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