Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
A Azure Functions egyik funkciója, a Durable Functions használatával állapotalapú függvényeket írhat kiszolgáló nélküli környezetben. Ebben a rövid útmutatóban a Visual Studio Code használatával hozhat létre, tesztelhet helyileg, és közzétehet egy "hello world" Durable Functions alkalmazást, amely más függvények hívásait vezényli és láncba láncozza.
A cikk tartalma:
- Prerequisites
- A helyi projekt létrehozása
- Az npm-csomag telepítése
- A függvények létrehozása – Orchestrator, activity és HTTP starter
- A függvény helyi tesztelése
Tesztelje a függvényt a Azure
Important
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.
Prerequisites
A gyors kezdéshez ezekre lesz szüksége:
- Visual Studio Code telepítve.
- A Visual Studio Code bővítmény Azure Functions telepítve van.
- A Visual Studio Code bővítmény Azure Functions 1.10.4-es vagy újabb verziója telepítve van.
- A Azure Functions Core Tools legújabb verziója telepítve.
- Azure Functions Core Tools 4.0.5382-es vagy újabb verzió van telepítve.
EGY HTTP-teszteszköz , amely biztonságossá teszi az adatokat. További információ: HTTP-teszteszközök.
Azure-előfizetés. A Durable Functions használatához rendelkeznie kell egy Azure Storage fiókkal.
- Node.js 20.x+ verzió van telepítve.
Ha nem rendelkezik Azure-fiókkal, a kezdés előtt hozzon létre egy ingyenes fiókot .
Helyi projekt létrehozása
Ebben a szakaszban a Visual Studio Code használatával hozhat létre helyi Azure Functions projektet.
A Visual Studio Code válassza az F1 (vagy a Ctrl/Cmd+Shift+P) billentyűkombinációt a parancskatalógus megnyitásához. A promptnál (
>) írja be, majd válassza a Azure Functions: Új projekt létrehozása lehetőséget.
Válassza a Tallózás lehetőséget. A Mappa kiválasztása párbeszédpanelen lépjen a projekthez használni kívánt mappára, majd válassza a Kiválasztás lehetőséget.
A parancssorban adja meg a következő információkat:
Haladéktalan Action Leírás Nyelv kiválasztása a függvényalkalmazás-projekthez Válassza a JavaScriptet. Létrehoz egy helyi Node.js Functions-projektet. JavaScript-programozási modell kiválasztása Válassza a V3 modell lehetőséget. Beállítja a v3-programozási modellt. Verzió kiválasztása Válassza a Azure Functions v4 lehetőséget. Ez a lehetőség csak akkor jelenik meg, ha a Core Tools még nincs telepítve. Ebben az esetben a Core Tools az alkalmazás első futtatásakor lesz telepítve. Sablon kiválasztása a projekt első függvényéhez Válassza Kihagyás egyelőrelehetőséget. Válassza ki, hogyan szeretné megnyitni a projektet Válassza a Megnyitás az aktuális ablakban lehetőséget. Megnyitja Visual Studio Code a kijelölt mappában.
A parancssorban adja meg a következő információkat:
Haladéktalan Action Leírás Nyelv kiválasztása a függvényalkalmazás-projekthez Válassza a JavaScriptet. Létrehoz egy helyi Node.js Functions-projektet. JavaScript-programozási modell kiválasztása Válassza a V4 modell lehetőséget. Válassza ki a v4 programozási modellt. Verzió kiválasztása Válassza a Azure Functions v4 lehetőséget. Ez a lehetőség csak akkor jelenik meg, ha a Core Tools még nincs telepítve. Ebben az esetben a Core Tools az alkalmazás első futtatásakor lesz telepítve. Sablon kiválasztása a projekt első függvényéhez Válassza Kihagyás egyelőrelehetőséget. Válassza ki, hogyan szeretné megnyitni a projektet Válassza a Megnyitás az aktuális ablakban lehetőséget. Megnyitja Visual Studio Code a kijelölt mappában.
Visual Studio Code telepíti Azure Functions Core Toolst, ha projekt létrehozásához szükséges. Emellett létrehoz egy függvényalkalmazás-projektet egy mappában. Ez a projekt tartalmazza a host.json és local.settings.json konfigurációs fájlokat.
A gyökérmappában is létrejön egy package.json fájl.
Az Durable Functions npm-csomag telepítése
Ha Durable Functions szeretne használni egy Node.js függvényalkalmazásban, egy durable-functions nevű kódtárat használ.
A v4-es programozási modell használatához telepítse a durable-functions kódtár v3.x verzióját.
A v3-programozási modell használatához telepítse a Durable-Functions v2.x kódtárat.
- A View menüben vagy a Ctrl+Shift+` billentyűkombinációval nyisson meg egy új terminált a Visual Studio Code.
- Telepítse a durable-functions npm csomagot a függvényalkalmazás gyökérkönyvtárában való futtatással
npm install durable-functions@^2.
- Telepítse a durable-functions npm csomagot a függvényalkalmazás gyökérkönyvtárában való futtatással
npm install durable-functions.
Hozd létre a függvényeidet
A legalapvetőbb Durable Functions alkalmazás három funkcióval rendelkezik:
- Vezénylő függvény: Más függvényeket vezénylő munkafolyamat.
- Tevékenységfüggvény: A vezénylő függvény által hívott függvény, amely elvégzi a munkát, és opcionálisan egy értéket ad vissza.
- Client függvény: Az Azure egy reguláris függvénye, amely elindít egy vezénylőfüggvényt. Ez a példa EGY HTTP-aktivált függvényt használ.
Important
A v3 programozási modell karbantartási módban van. Új projektek esetén használja a v4 programozási modellt (válassza ki az oldal tetején lévő választókapcsolót). A migrálási útmutatóért tekintse meg a v4-modellre való frissítéssel kapcsolatos útmutatást.
Orchestrator függvény
Sablonnal hozhatja létre a Durable Functions alkalmazáskódot a projektben.
A parancskatalógusban írja be az Azure Functions: Függvény létrehozása parancsot, majd válassza ki azt.
A parancssorban adja meg a következő információkat:
Haladéktalan Action Leírás Sablon kiválasztása a függvényhez Válassza a Durable Functions orchestrator lehetőséget. Létrehoz egy Durable Functions alkalmazás orkesztációját. Tartós tárolási típus kiválasztása Válassza Azure Storage (Alapértelmezett) lehetőséget. Kiválasztja a Durable Functions alkalmazáshoz használt háttértárat. Függvénynév megadása Adja meg a HelloOrchestratort. A tartós függvény neve.
Tip
Ez a rövid útmutató az Azure Storage-t használja háttértárként. Éles számítási feladatok esetén a Durable Task Scheduler az ajánlott társzolgáltató. Lásd : Az alkalmazás konfigurálása a Durable Task Scheduler használatára.
Felvett egy orchestratort a tevékenységfüggvények koordinálásához. Nyissa meg a HelloOrchestrator/index.js a vezénylő függvény megtekintéséhez. Minden hívás meghívást indít a context.df.callActivity-re egy tevékenységfüggvény formájában, amelynek neve Hello.
Ezután adja hozzá a hivatkozott tevékenységfüggvényt Hello .
Tevékenységfüggvény
A parancskatalógusban írja be az Azure Functions: Függvény létrehozása parancsot, majd válassza ki azt.
A parancssorban adja meg a következő információkat:
Haladéktalan Action Leírás Sablon kiválasztása a függvényhez Válassza a Durable Functions tevékenységet. Létrehoz egy tevékenységfüggvényt. Függvénynév megadása Adja meg a Hello billentyűt. A tartós függvény neve.
Hozzáadta a Hello tevékenységfüggvényt, amelyet az orchesztrátor meghív. Nyissa meg a Hello/index.js elemet, hogy lássa, egy nevet ad vissza bemenetként, és egy üdvözlést ad vissza. A tevékenységfüggvények esetében a munkafolyamatban "a valódi munkát" hajtja végre, például adatbázis-hívást kezdeményez vagy nemdeterminisztikus számításokat hajt végre.
Végül adjon hozzá egy HTTP-aktivált függvényt, amely elindítja a vezénylést.
Ügyfél-függvény (HTTP-indító)
A parancskatalógusban írja be az Azure Functions: Függvény létrehozása parancsot, majd válassza ki azt.
A parancssorban adja meg a következő információkat:
Haladéktalan Action Leírás Sablon kiválasztása a függvényhez Válassza a Durable Functions HTTP starter lehetőséget. Létrehoz egy HTTP indítófüggvényt. Függvénynév megadása Adja meg a DurableFunctionsHttpStart parancsot. A tevékenységfüggvény neve. Engedélyezési szint Válassza a Névtelen lehetőséget. Demó céljából ez az érték lehetővé teszi a függvény meghívását hitelesítés nélkül
Hozzáadtál egy HTTP-aktivált függvényt, amely orchestrációt indít el. Nyissa meg a DurableFunctionsHttpStart/index.js fájlt, hogy megtekintse, hogyan indít el egy új orkesztrációt client.startNew segítségével. Ezután visszaad egy HTTP-választ client.createCheckStatusResponse, amely URL-címeket tartalmaz, amelyeket az új folyamatvezérlés monitorozására és kezelésére használhat.
Most már rendelkezik egy Durable Functions alkalmazással, amelyet helyileg futtathat és üzembe helyezhet Azure.
A v4-et használó programozási modell egyik előnye a függvények írásának rugalmassága. A v4-modellben egyetlen sablon használatával hozhatja létre a projekt mindhárom függvényét egy fájlban.
A parancskatalógusban írja be az Azure Functions: Függvény létrehozása parancsot, majd válassza ki azt.
A parancssorban adja meg a következő információkat:
Haladéktalan Action Leírás Sablon kiválasztása a függvényhez Válassza a Durable Functions orchestrator lehetőséget. Létrehoz egy fájlt, amely egy Durable Functions alkalmazás vezénylését, egy tevékenységfüggvényt és egy tartós ügyfélindító függvényt tartalmazza. Tartós tárolási típus kiválasztása Válassza Azure Storage (Alapértelmezett) lehetőséget. Beállítja, hogy melyik háttértárat használja a Durable Functions alkalmazás. Függvénynév megadása Adja meg a hello elemet. A tartós függvény neve.
Tip
Ez a rövid útmutató az Azure Storage-t használja háttértárként. Éles számítási feladatok esetén a Durable Task Scheduler az ajánlott társzolgáltató. Lásd : Az alkalmazás konfigurálása a Durable Task Scheduler használatára.
Nyissa meg az src/functions/hello.js elemet a létrehozott függvények megtekintéséhez.
Egy helloOrchestrator nevű vezénylőt hozott létre a tevékenységfüggvények koordinálására. Minden hívás során a context.df.callActivity meghív egy hello nevű tevékenységfüggvényt.
Ön hozzáadta az hello tevékenységfüggvényt is, amelyet az orchestrátor hív meg. Ugyanebben a fájlban láthatja, hogy egy nevet ad vissza bemenetként, és egy üdvözlést ad vissza. A tevékenységfüggvények esetében a munkafolyamatban "a valódi munkát" hajtja végre, például adatbázis-hívást kezdeményez vagy nemdeterminisztikus számításokat hajt végre.
Végül hozzáadott egy HTTP által aktivált függvényt is, amely elindít egy orkesztrációt. Ugyanebben a fájlban láthatja, hogy a client.startNew használatával új vezénylést indít. Ezután visszaad egy HTTP-választ client.createCheckStatusResponse, amely URL-címeket tartalmaz, amelyeket az új folyamatvezérlés monitorozására és kezelésére használhat.
Most már rendelkezik egy Durable Functions alkalmazással, amelyet helyileg futtathat és üzembe helyezhet Azure.
A függvény helyi tesztelése
Azure Functions Core Tools lehetővé teszi egy Azure Functions projekt futtatását a helyi fejlesztési számítógépen. A rendszer arra kéri, hogy telepítse ezeket az eszközöket, amikor először indít el függvényt Visual Studio Code.
Note
A helyi teszteléshez Azure Storage fiókra (vagy a Azurite emulátorra) van szükség. A 2–3. lépések végigvezetik a létrehozás folyamatán, ha még nem rendelkezik ilyennel.
A függvény teszteléséhez állítson be egy töréspontot a
Hellotevékenységfüggvény kódjában (a Hello/index.js fájlban). Nyomja meg az F5-öt, vagy válassza a Hibakeresés indítása opciót a parancspalettában a függvényalkalmazás-projekt elindításához. A Core Tools kimenete megjelenik a terminálpanelen.Note
További információ a hibakeresésről: Durable Functions diagnosztika.
A függvény teszteléséhez állítson be egy töréspontot a
hellotevékenységfüggvény kódjában (src/functions/hello.js). Nyomja meg az F5-öt, vagy válassza a Hibakeresés indítása opciót a parancspalettában a függvényalkalmazás-projekt elindításához. A Core Tools kimenete megjelenik a terminálpanelen.Note
További információ a hibakeresésről: Durable Functions diagnosztika.
Durable Functions futtatásához Azure Storage fiók szükséges. Amikor Visual Studio Code kéri, hogy válasszon ki egy tárfiókot, válassza a Tárfiók kijelölése lehetőséget.
A parancssorban adja meg a következő információkat egy új tárfiók létrehozásához az Azure-ban.
Haladéktalan Value Leírás Előfizetés kiválasztása az előfizetés neve Válassza ki Azure előfizetését Tárfiók kiválasztása Új tárfiók létrehozása Adja meg az új tárfiók nevét egyedi név A létrehozandó tárfiók neve Erőforráscsoport kiválasztása egyedi név A létrehozandó erőforráscsoport neve Hely kiválasztása region Válasszon egy Önhöz közeli régiót A terminálpanelen másolja ki a HTTP-aktivált függvény URL-végpontját.
A böngésző vagy a HTTP-teszteszköz használatával HTTP POST-kérést küldhet az URL-végpontnak.
Cserélje le az utolsó szegmenst a vezénylő függvény (
HelloOrchestrator) nevére. Az URL-címnek hasonlónak kell lennie a következőhözhttp://localhost:7071/api/orchestrators/HelloOrchestrator: .A válasz a HTTP-függvény kezdeti eredménye. Tájékoztatja Önt, hogy a tartós folyamatvezérlés sikeresen elindult. Még nem jeleníti meg a vezénylés végeredményét. A válasz tartalmaz néhány hasznos URL-címet. Egyelőre kérdezze le a vezénylés állapotát.
A böngésző vagy a HTTP-teszteszköz használatával HTTP POST-kérést küldhet az URL-végpontnak.
Cserélje le az utolsó szegmenst a vezénylő függvény (
helloOrchestrator) nevére. Az URL-címnek hasonlónak kell lennie a következőhözhttp://localhost:7071/api/orchestrators/helloOrchestrator: .A válasz a HTTP-függvény kezdeti eredménye. Tájékoztatja Önt, hogy a tartós folyamatvezérlés sikeresen elindult. Még nem jeleníti meg a vezénylés végeredményét. A válasz tartalmaz néhány hasznos URL-címet. Egyelőre kérdezze le a vezénylés állapotát.
Másolja ki a cél URL-címét
statusQueryGetUri, illessze be a böngésző címsorában, és hajtsa végre a kérést. Másik lehetőségként továbbra is használhatja a HTTP-teszteszközt a GET kérés kiadásához.A kérés lekérdezi az orkesztációs példányt az állapotáról. Látnia kell, hogy a példány befejeződött, és tartalmazza a Durable Functions alkalmazás kimeneteit vagy eredményeit, például az alábbi példában:
{ "name": "HelloOrchestrator", "instanceId": "9a528a9e926f4b46b7d3deaa134b7e8a", "runtimeStatus": "Completed", "input": null, "customStatus": null, "output": [ "Hello Tokyo!", "Hello Seattle!", "Hello London!" ], "createdTime": "2026-04-23T14:22:49Z", "lastUpdatedTime": "2026-04-23T14:22:54Z" }
Másolja ki a cél URL-címét
statusQueryGetUri, illessze be a böngésző címsorában, és hajtsa végre a kérést. A GET kérés kiadásához továbbra is használhatja a HTTP-teszteszközt.A kérés lekérdezi az orkesztációs példányt az állapotáról. Látnia kell, hogy a példány befejeződött, és tartalmazza a Durable Functions alkalmazás kimeneteit vagy eredményeit, például az alábbi példában:
{ "name": "helloOrchestrator", "instanceId": "6ba3f77933b1461ea1a3828c013c9d56", "runtimeStatus": "Completed", "input": "", "customStatus": null, "output": [ "Hello, Tokyo", "Hello, Seattle", "Hello, Cairo" ], "createdTime": "2026-04-23T14:32:21Z", "lastUpdatedTime": "2026-04-23T14:32:25Z" }
- A Visual Studio Code-ban nyomja le a Shift+F5 billentyűkombinációt a hibakeresés leállításához.
Miután ellenőrizte, hogy a függvény megfelelően fut-e a helyi számítógépen, ideje közzétenni a projektet Azure.
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 nem jelentkezett be, a Tevékenységsávon válassza az Azure ikont. Ezután a Resources területen válassza Sign in to Azure.
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 kiválaszthatják az Azure Diákfiók létrehozása lehetőséget.
Amikor a rendszer kéri a böngészőben, válassza ki Azure fiókját, és jelentkezzen be a 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 a Azure
Ebben a szakaszban egy függvényalkalmazást hoz létre a Flex Consumption csomagban az Azure-előfizetés kapcsolódó erőforrásaival együtt. Számos erőforrás-létrehozási döntés az alapértelmezett viselkedés alapján történik. A létrehozott erőforrások további szabályozásához ehelyett speciális beállításokkal kell létrehoznia a függvényalkalmazást.
A Visual Studio Code-ban nyomja meg az F1-et a parancspaletta megnyitásához. A parancssorban (
>) írja be, majd válassza az Azure Functions: Függvényalkalmazás létrehozása az Azure-ben lehetőséget.A parancssorban adja meg a következő információkat:
Haladéktalan Action Előfizetés kiválasztása Válassza ki a használni kívánt Azure előfizetést. A parancssor nem jelenik meg, ha csak egy előfizetés látható az Erőforrások területen. Adjon meg egy új függvényalkalmazásnevet Adjon meg egy url-útvonalon érvényes, globálisan egyedi nevet. A megadott nevet érvényesítjük, hogy biztosan egyedi legyen az Azure Functions-ben. Új erőforrások helyének kiválasztása Válasszon ki egy Azure régiót. A jobb teljesítmény érdekében válasszon ki egy Önhöz közeli régiót. Csak a Flex Consumption-csomagok által támogatott régiók jelennek meg. Futtatókörnyezeti verem kiválasztása Válassza ki a helyileg futtatott nyelvi verziót. Erőforrás-hitelesítés típusának kiválasztása Válassza ki a felügyelt identitást, amely a legbiztonságosabb lehetőség az alapértelmezett gazdagép tárfiókhoz való csatlakozáshoz. Az Azure: Tevékenységnapló panelen az Azure-bővítmény megjeleníti az egyes erőforrások állapotát az Azure-ban való létrehozásuk során.
A függvényalkalmazás létrehozásakor a következő kapcsolódó erőforrások jönnek létre az Azure-előfizetésben. Az erőforrások neve a függvényalkalmazáshoz megadott név alapján lesz elnevezve.
- Egy erőforráscsoport, amely a kapcsolódó erőforrások logikai tárolója.
- 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.
- Egy Azure App Service csomag, amely meghatározza a függvényalkalmazás mögöttes gazdagépét.
- Egy standard Azure Storage-fiók, amelyet a Functions-gazdagép használ a függvényalkalmazás állapotának és egyéb információinak karbantartására.
- A függvényalkalmazáshoz csatlakoztatott Application Insights-példány, amely nyomon követi a függvények használatát az alkalmazásban.
- Egy felhasználó által hozzárendelt felügyelt identitás, amely az új alapértelmezett gazdagép tárfiókjában a Storage Blob Data Közreműködői szerepkörhöz lett hozzáadva.
A függvényalkalmazás létrehozása és a telepítőcsomag alkalmazása után megjelenik egy értesítés.
Tip
Alapértelmezés szerint a függvényalkalmazás által igényelt Azure-erőforrások a függvényalkalmazáshoz megadott név alapján jönnek létre. Alapértelmezés szerint az erőforrások ugyanabban az új erőforráscsoportban vannak létrehozva a függvényalkalmazással. Ha testre szeretné szabni a társított erőforrások nevét, vagy újra szeretné használni a meglévő erőforrásokat, tegye közzé a projektet speciális létrehozási lehetőségekkel.
Telepítse a projektet az Azure-ba
Important
Egy meglévő függvényalkalmazás üzembe helyezése az Azure-ban mindig felülírja az alkalmazás tartalmát.
A parancskatalógusban írja be, majd válassza az Azure Functions: Üzembe helyezés függvényalkalmazásba lehetőséget.
Válassza ki az imént létrehozott függvényalkalmazást. Amikor a rendszer kéri a korábbi üzembe helyezések felülírását, válassza a Üzembe helyezés lehetőséget a függvénykód új függvényalkalmazás-erőforrásba való telepítéséhez.
Ha az üzembe helyezés befejeződött, válassza a Megtekintő kimenet 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.
Az Azure-ban egy függvény tesztelése
Note
A 4-es Node.js programozási modell használatához győződjön meg arról, hogy az alkalmazás a Azure Functions futtatókörnyezet legalább 4.25-ös verzióján fut.
A kimeneti panelen másolja ki a HTTP-eseményindító URL-címét. A HTTP-aktivált függvényt meghívó URL-címnek a következő formátumban kell lennie:
https://<functionappname>.azurewebsites.net/api/orchestrators/HelloOrchestrator
A kimeneti panelen másolja ki a HTTP-eseményindító URL-címét. A HTTP-aktivált függvényt meghívó URL-címnek a következő formátumban kell lennie:
https://<functionappname>.azurewebsites.net/api/orchestrators/helloOrchestrator
- Illessze be a HTTP-kérés új URL-címét a böngésző címsorában. A közzétett alkalmazás használatakor számíthat arra, hogy ugyanazt az állapotválaszt kapja, mint a helyi tesztelés során.
A Visual Studio Code létrehozott és közzétett JavaScript Durable Functions alkalmazás használatra kész.
Erőforrások tisztítása
Ha már nincs szüksége a gyorsútmutató végrehajtásához létrehozott erőforrásokra, az Azure-előfizetéshez kapcsolódó költségek elkerülése érdekében törölje az erőforráscsoportot és az összes kapcsolódó erőforrást.