Megosztás a következőn keresztül:


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

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.

    Képernyőkép az Azure Functions projektbeállításairól.

    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.

    Az Azure helyi futtatókörnyezete

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

    A függvény által visszaadott localhost válasz a böngészőben

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

    A Flex Consumption csomaghoz Linux szükséges.

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

    Új függvényalkalmazás-példány létrehozását bemutató képernyőkép.

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

    Képernyőkép az App Service létrehozása párbeszédpanelrő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.

    Képernyőkép a Sikeres közzététel üzenetről.

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:

    A függvény által visszaadott válasz a böngészőben

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.

    Válassza ki a törölni kívánt erőforráscsoportot a függvényalkalmazás oldaláról

  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: