Rövid útmutató: Függvény létrehozása az Azure-ban TypeScript használatával a Visual Studio Code használatával
Ebben a cikkben a Visual Studio Code használatával hoz létre egy TypeScript-függvényt, amely a HTTP-kérelmekre válaszol. A kódot a helyi tesztelését követően az Azure Functions kiszolgáló nélküli környezetében helyezheti üzembe.
Fontos
A cikk tartalma a Node.js programozási modell választásától függően változik a lap tetején található választóban. A v4-modell általánosan elérhető, és úgy lett kialakítva, hogy rugalmasabb és intuitívabb felhasználói élményt nyújtson JavaScript- és TypeScript-fejlesztők számára. A migrálási útmutatóban további információt olvashat a v3 és a v4 közötti különbségekről.
Ennek a rövid útmutatónak a befejezése néhány USD cent vagy annál kisebb költséggel jár az Azure-fiókjában.
A cikk cli-alapú verziója is elérhető.
A környezet konfigurálása
Mielőtt hozzálátna, győződjön meg róla, hogy megfelel az alábbi követelményeknek:
- Egy Azure-fiók, aktív előfizetéssel. Fiók ingyenes létrehozása.
- Node.js 18.x vagy Node.js 16.x.
node --version
A parancs használatával ellenőrizze a verziót.
Node.js 18.x vagy újabb.
node --version
A parancs használatával ellenőrizze a verziót.TypeScript 4.x.
tsc -v
A parancs használatával ellenőrizze a verziót.
Visual Studio Code az egyik támogatott platformon.
A Visual Studio Code 1.10.4-s vagy újabb Azure Functions-bővítménye.
Helyi projekt létrehozása
Ebben a szakaszban a Visual Studio Code használatával hoz létre egy helyi Azure Functions-projektet a TypeScriptben. A cikk későbbi részében közzéteszi a függvénykódot az Azure-ban.
Válassza az Azure ikont a Tevékenységsávon. Ezután a Munkaterület (helyi) területen válassza a + gombot, és válassza a Függvény létrehozása lehetőséget a legördülő menüben. Amikor a rendszer kéri, válassza az Új projekt létrehozása lehetőséget.
Válassza ki a projekt-munkaterület könyvtárhelyét, és válassza a Kiválasztás lehetőséget. Hozzon létre egy új mappát, vagy válasszon egy üres mappát a projekt-munkaterülethez. Ne válasszon olyan projektmappát, amely már része egy munkaterületnek.
Amikor a rendszer kéri, adja meg az alábbi információkat:
Adatkérés Kiválasztás A függvényprojekt nyelvének kiválasztása Válassza a TypeScript
elemet.TypeScript programozási modell kiválasztása Válassza a Model V3
elemetSablon kiválasztása a projekt első függvényéhez Válassza a HTTP trigger
elemet.Függvénynév megadása Gépelje be: HttpExample
.Engedélyszint Válassza a Anonymous
lehetőséget, amely lehetővé teszi, hogy bárki meghívja a függvényvégpontot. Az engedélyezési szinttel kapcsolatos további információkért tekintse meg az engedélyezési kulcsokat.Válassza ki, hogyan szeretné megnyitni a projektet Válassza a Open in current window
elemet.Ezen információk felhasználásával a Visual Studio Code létrehoz egy Azure Functions-projektet EGY HTTP-eseményindítóval. A helyi projektfájlokat az Explorerben tekintheti meg. A létrehozott fájlokról további információt a Létrehozott projektfájlok című témakörben talál.
Amikor a rendszer kéri, adja meg az alábbi információkat:
Adatkérés Kiválasztás A függvényprojekt nyelvének kiválasztása Válassza a TypeScript
elemet.TypeScript programozási modell kiválasztása Válassza a Model V4
elemetSablon kiválasztása a projekt első függvényéhez Válassza a HTTP trigger
elemet.Függvénynév megadása Gépelje be: HttpExample
.Válassza ki, hogyan szeretné megnyitni a projektet Válassza a Open in current window
elemetEzen információk felhasználásával a Visual Studio Code létrehoz egy Azure Functions-projektet EGY HTTP-eseményindítóval. A helyi projektfájlokat az Explorerben tekintheti meg. A létrehozott fájlokról további információt az Azure Functions TypeScript fejlesztői útmutatójában talál.
Függvény helyi futtatása
A Visual Studio Code az Azure Functions Core-eszközökkel integrálva lehetővé teszi a projekt helyi fejlesztői számítógépen való futtatását, mielőtt közzétennénk az Azure-ban.
A függvény helyi indításához nyomja le az F5 billentyűt vagy a Futtatás és hibakeresés ikont a bal oldali tevékenységsávon. A Terminál panelen a Core Tools kimenete látható. Az alkalmazás a Terminál panelen kezdődik. A HTTP által aktivált függvény URL-végpontja helyileg fut.
Ha problémákat tapasztal a Windows rendszeren való futtatással, győződjön meg arról, hogy a Visual Studio Code alapértelmezett terminálja nincs beállítva WSL Bash-ra.
Ha a Core Tools továbbra is fut a Terminálban, válassza az Azure ikont a tevékenységsávon. A Munkaterület területen bontsa ki a Helyi projektfüggvényeket>. Kattintson a jobb gombbal (Windows) vagy Ctrl billentyűkombinációra – kattintson az új függvényre (macOS), és válassza a Függvény végrehajtása parancsot....
Az Enter kérelemtörzsben a kérelemüzenet törzsértéke jelenik
{ "name": "Azure" }
meg. Az Enter billentyűt lenyomva küldje el ezt a kérésüzenetet a függvénynek.Amikor a függvény helyileg fut, és választ ad vissza, a Rendszer értesítést küld a Visual Studio Code-ban. A függvény végrehajtásával kapcsolatos információk a Terminál panelen jelennek meg.
A terminálpanel fókuszában a Ctrl + C billentyűkombinációval állítsa le a Core Toolst, és válassza le a hibakeresőt.
Miután ellenőrizte, hogy a függvény megfelelően fut-e a helyi számítógépen, ideje a Visual Studio Code használatával közvetlenül az Azure-ban közzétenni a projektet.
Bejelentkezés az Azure-ba
Az Azure-erőforrások létrehozása vagy az alkalmazás közzététele előtt be kell jelentkeznie az Azure-ba.
Ha még nincs bejelentkezve, válassza az Azure ikont a Tevékenységsávon. Ezután az Erőforrások területen válassza a Bejelentkezés az Azure-ba... lehetőséget.
Ha már bejelentkezett, és láthatja a meglévő előfizetéseit, lépjen a következő szakaszra. Ha még nem rendelkezik Azure-fiókkal, válassza az Azure-fiók létrehozása...lehetőséget. A diákok választhatják az Azure for Students-fiók létrehozását....
Amikor a rendszer kéri a böngészőben, válassza ki az Azure-fiókját, és jelentkezzen be az Azure-fiók hitelesítő adataival. Ha új fiókot hoz létre, a fiók létrehozása után bejelentkezhet.
Miután sikeresen bejelentkezett, bezárhatja az új böngészőablakot. Az Azure-fiókhoz tartozó előfizetések az oldalsávon jelennek meg.
A függvényalkalmazás létrehozása az Azure-ban
Ebben a szakaszban egy függvényalkalmazást és kapcsolódó erőforrásokat hoz létre az Azure-előfizetésében.
Válassza az Azure ikont a Tevékenységsávon. Ezután az Erőforrások területen válassza az ikont + , és válassza a Függvényalkalmazás létrehozása az Azure-ban lehetőséget.
Amikor a rendszer kéri, adja meg az alábbi információkat:
A bővítmény az egyes erőforrások állapotát jeleníti meg az Azure-ban az Azure: Tevékenységnapló panelen való létrehozásuk során.
Amikor a létrehozás befejeződött, a következő Azure-erőforrások jönnek létre az előfizetésben. Az erőforrások neve a függvényalkalmazás neve alapján van elnevezve:
- Egy erőforráscsoport, amely a kapcsolódó erőforrások logikai tárolója.
- Egy standard Azure Storage-fiók, amely fenntartja a projektek állapotát és egyéb adatait.
- Egy függvényalkalmazás, amely a függvénykód végrehajtásához biztosítja a környezetet. 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 és megosztása érdekében ugyanabban az üzemeltetési csomagban.
- App Service-csomag, amely meghatározza a függvényalkalmazás mögöttes gazdagépét.
- Egy alkalmazás Elemzések függvényalkalmazáshoz csatlakoztatott példányt, amely nyomon követi a függvények használatát az alkalmazásban.
A függvényalkalmazás létrehozása és a telepítőcsomag alkalmazása után megjelenik egy értesítés.
Tipp.
Alapértelmezés szerint a függvényalkalmazás által igényelt Azure-erőforrások a megadott függvényalkalmazás-név alapján jönnek létre. Alapértelmezés szerint ugyanabban az új erőforráscsoportban is létrejönnek a függvényalkalmazással. Ha testre szeretné szabni ezeknek az erőforrásoknak a nevét, vagy újra szeretné használni a meglévő erőforrásokat, akkor inkább speciális létrehozási lehetőségekkel kell közzétennie a projektet.
A projekt központi telepítése az Azure-ban
Fontos
A meglévő függvényalkalmazásban való üzembe helyezés mindig felülírja az alkalmazás tartalmát az Azure-ban.
Az Azure-tevékenység Erőforrások területén keresse meg az imént létrehozott függvényalkalmazás-erőforrást, kattintson a jobb gombbal az erőforrásra, és válassza az Üzembe helyezés függvényalkalmazáshoz... lehetőséget.
Amikor a rendszer kéri a korábbi üzemelő példányok felülírását, válassza az Üzembe helyezés lehetőséget a függvénykód új függvényalkalmazás-erőforrásban való üzembe helyezéséhez.
Az üzembe helyezés befejezése után válassza a Kimenet megtekintése lehetőséget a létrehozási és üzembe helyezési eredmények megtekintéséhez, beleértve a létrehozott Azure-erőforrásokat is. Ha nem jelenik meg az értesítés, a jobb alsó sarokban lévő harang ikont választva ismét láthatja.
A függvény futtatása az Azure-ban
Az oldalsáv Erőforrások területén bontsa ki az előfizetést, az új függvényalkalmazást és a Functionst. Kattintson a jobb gombbal (Windows) vagy Ctrl billentyűkombinációra – kattintson a függvényre (macOS), és válassza a
HttpExample
Függvény végrehajtása parancsot....Az Enter kérelemtörzsben a kérelemüzenet törzsértéke jelenik
{ "name": "Azure" }
meg. Az Enter billentyűt lenyomva küldje el ezt a kérésüzenetet a függvénynek.Amikor a függvény az Azure-ban fut, és választ ad vissza, a Visual Studio Code értesítést küld.
Az erőforrások eltávolítása
Ha folytatja a következő lépést , és hozzáad egy Azure Storage-üzenetsor-kötést a függvényhez, az összes erőforrást helyben kell tartania ahhoz, hogy a már elvégzett adatokra építkezhessenek.
Ellenkező esetben 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 Code-ban nyomja le az F1 billentyűt a parancskatalógus megnyitásához. A parancskatalógusban keresse meg és válassza ki a kívánt parancsot
Azure: Open in portal
.Válassza ki a függvényalkalmazást, és nyomja le az Enter billentyűt. Megnyílik a függvényalkalmazás lapja az Azure Portalon.
Az Áttekintés lapon válassza az Erőforráscsoport melletti elnevezett hivatkozást.
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.
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.
A Functions-költségekkel kapcsolatos további információkért tekintse meg a használati terv költségeinek becslését.
Következő lépések
A Visual Studio Code használatával létrehozott egy függvényalkalmazást egy egyszerű HTTP-aktivált függvénnyel. A következő cikkben kiterjesztheti ezt a függvényt az Azure Storage-hoz való csatlakozással. Ha többet szeretne tudni a más Azure-szolgáltatásokhoz való csatlakozásról, olvassa el a Kötések hozzáadása meglévő függvényhez az Azure Functionsben című témakört.