Rövid útmutató: PowerShell-Durable Functions-alkalmazás létrehozása

Ebben a rövid útmutatóban a Visual Studio Code használatával hozhat létre és tesztelhet egy PowerShell-Durable Functions alkalmazást, amely más függvények hívásait vezénylik és láncolják. Ezt követően közzéteheti az Azure.

Durable Functions kezeli az állapotokat, ellenőrzőpontokat és újraindításokat az alkalmazásban, így állapotalapú munkafolyamatokat írhat kiszolgáló nélküli környezetben.

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 Azure Functions Core Tools legújabb verziója 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.

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.

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

   

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

3. 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 PowerShell.	Létrehoz egy helyi PowerShell Functions-projektet.
   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 önálló Durable Functions SDK konfigurálása

Az önálló SDK a PowerShell Durable Functions legjobb teljesítményét és legújabb funkcióit biztosítja. Konfigurálja három lépésben:

1. lépés: Nyissa meg local.settings.json és ellenőrizze, hogy a következő beállítások vannak-e megőrzve. Szükség esetén adja hozzá vagy frissítse őket:

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "",
    "FUNCTIONS_WORKER_RUNTIME": "powershell",
    "FUNCTIONS_WORKER_RUNTIME_VERSION" : "7.4",
    "ExternalDurablePowerShellSDK": "true"
  }
}

2. lépés: Nyissa meg requirements.psd1 és adja hozzá az SDK-függőséget:

@{
    'AzureFunctions.PowerShell.Durable.SDK' = '2.*'
}

A 2.* specifikáló biztosítja, hogy a legújabb stabil 2.x verziót kapja a PowerShell Galériából.

3. lépés: Adja hozzá a következő sort a profile.ps1 fájl végéhez:

Import-Module AzureFunctions.PowerShell.Durable.SDK -ErrorAction Stop

Hozd létre a függvényeidet

Egy alapszintű Durable Functions-alkalmazás három funkcióval rendelkezik:

Funkció típusa	Alkalmazás célja
Hangszerelő	Más függvényeket irányító munkafolyamat.
Tevékenység	A vezénylő által meghívott folyamat munkát végez, és visszaad egy értéket.
Ügyfél (HTTP-indító)	Egy HTTP-aktivált függvény, amely elindít egy orchestratort.

Minden függvénynél nyissa meg a parancskatalógust, és válassza a Azure Functions: Függvény létrehozása lehetőséget, majd adja meg a kívánt értékeket:

1. Vezénylő függvény

Haladéktalan	Value
Sablon kiválasztása	Durable Functions Orchestrátor
Függvény neve	HelloOrchestrator

Nyissa meg a HelloOrchestrator/run.ps1 fájlt a vezérlő megtekintéséhez. Minden Invoke-ActivityFunction hívás meghívja a Hello tevékenységfüggvényt.

2. Tevékenységfüggvény

Haladéktalan	Value
Sablon kiválasztása	Durable Functions tevékenység
Függvény neve	Üdvözlöm

Nyissa meg a Hello/run.ps1 elemet, hogy lássa, egy nevet ad vissza bemenetként, és egy üdvözlést ad vissza. A tevékenységfüggvények olyan műveleteket hajtanak végre, mint az adatbázis-hívások vagy a számítások.

3. Kliensfunkció (HTTP-indító)

Haladéktalan	Value
Sablon kiválasztása	Durable Functions HTTP-indító
Függvény neve	HttpStart
Engedélyezési szint	Névtelen (bemutató célokra)

Nyissa meg HttpStart/run.ps1, és ellenőrizze, hogy a Start-NewOrchestration segítségével indít-e új vezénylést, és a New-OrchestrationCheckStatusResponse segítségével ad-e vissza HTTP-választ monitorozási URL-címekkel.

Most már rendelkezik egy Durable Functions alkalmazással, amelyet helyileg futtathat és üzembe helyezhet Azure.

Tip

Ez a rövid útmutató az önálló Durable Functions PowerShell SDK-t használja. Az SDK-ról és az örökölt beépített verzióról való migrálásról további információt az önálló PowerShell SDK-útmutatóban talál.

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 egy függvényt a Visual Studio.

1. A függvény teszteléséhez állítson be egy töréspontot a Hello tevékenységfüggvény kódjában (a Hello/run.ps1 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.

2. Durable Functions egy tárfiók futtatását igényli. Használhatja a Azurite storage emulatort helyi fejlesztéshez, vagy ha a rendszer kéri, hozzon létre egy Azure tárfiókot. Ha Visual Studio Code a tárfiók kiválasztására kéri, válassza a Tárfiók kijelölése lehetőséget.

3. Az utasításokat követve adja meg a következő információkat egy új tárfiók létrehozásához Azure.

   Haladéktalan	Action	Leírás
   Előfizetés kiválasztása	Válassza ki az előfizetés nevét.	Az Ön Azure előfizetése.
   Tárfiók kiválasztása	Válassza az Új tárfiók létrehozása lehetőséget.
   Adja meg az új tárfiók nevét	Adjon meg egy egyedi nevet.	A létrehozandó tárfiók neve.
   Erőforráscsoport kiválasztása	Adjon meg egy egyedi nevet.	A létrehozandó erőforráscsoport neve.
   Hely kiválasztása	Válasszon ki egy Azure régiót.	Válasszon ki egy Önhöz közeli régiót.

4. A terminálpanelen másolja ki a HTTP-aktivált függvény URL-végpontját.

5. 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öz http://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.

6. Másolja ki az URL-értékét statusQueryGetUri, illessze be a böngésző címsorába, é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átni fog egy választ, amely bemutatja a befejezett példányt és a tartós funkció eredményeit.

   {
       "name": "HelloOrchestrator",
       "instanceId": "9a528a9e926f4b46b7d3deaa134b7e8a",
       "runtimeStatus": "Completed",
       "input": null,
       "customStatus": null,
       "output": [
           "Hello Tokyo!",
           "Hello Seattle!",
           "Hello London!"
       ],
       "createdTime": "2020-03-18T21:54:49Z",
       "lastUpdatedTime": "2020-03-18T21:54:54Z"
   }
   

7. A hibakeresés leállításához a Visual Studio Code válassza a Shift+F5 billentyűkombinációt.

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.

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

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

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

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

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

   

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

1. A parancskatalógusban írja be, majd válassza az Azure Functions: Üzembe helyezés függvényalkalmazásba lehetőséget.

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

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

1. A Azure portálon (vagy a Azure CLI használatával) ellenőrizze, hogy az alkalmazás beállítása ExternalDurablePowerShellSDKtrue értékre van-e állítva. Ha hiányzik, adja hozzá a Settings>Environment változók alatt, és indítsa újra a függvényalkalmazást.

2. Másolja ki a HTTP-eseményindító URL-címét a kimeneti panelről. Az URL-címnek a következő formátumban kell lennie:

   https://<functionappname>.azurewebsites.net/api/orchestrators/HelloOrchestrator

3. HTTP POST-kérés küldése az URL-címre. Ugyanazt az állapotválaszt kell kapnia, mint amit a helyi teszteléskor kapott.

Ha a vezénylés nem indul el, ellenőrizze a funkcióalkalmazás naplóit az Azure portálon a következő helyen: Monitor>Log stream, és keressen az SDK importálásával vagy a tárolási kapcsolattal kapcsolatos hibákat.

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.

Kapcsolódó tartalom

• Gyakori Durable Functions alkalmazásminták
• Önálló PowerShell SDK-útmutató
• Durable Functions diagnosztika és monitorozás
• PowerShell fejlesztői referencia az Azure Functions