Rychlý start: Vytvoření aplikace Durable Functions v JavaScriptu

• Nainstalované rozšíření Visual Studio Code pro Azure Functions .

• Nainstalované rozšíření Visual Studio Code pro Azure Functions verze 1.10.4 nebo novější.

• Nainstalovaná nejnovější verze nástrojů Azure Functions Core Tools .

• Nainstalované nástroje Azure Functions Core Tools verze 4.0.5382 nebo novější.

• Node.js nainstalovaná verze 16.x+

• Node.js nainstalovaná verze 18.x+

3. Na příkazovém řádku zadejte následující informace:

   Instrukce	Akce	Popis
   Výběr jazyka pro projekt aplikace funkcí	Vyberte JavaScript.	Vytvoří místní projekt Node.js Functions.
   Výběr programovacího modelu JavaScriptu	Vyberte Model V3.	Nastaví programovací model v3.
   Vyberte verzi.	Vyberte Azure Functions v4.	Tato možnost se zobrazí jenom v případě, že nástroje Core Tools ještě nejsou nainstalované. V tomto případě se nástroje Core Tools nainstalují při prvním spuštění aplikace.
   Výběr šablony pro první funkci projektu	Prozatím vyberte Přeskočit.
   Vyberte, jak chcete projekt otevřít.	Vyberte Otevřít v aktuálním okně.	Otevře Visual Studio Code ve složce, kterou jste vybrali.

3. Na příkazovém řádku zadejte následující informace:

   Instrukce	Akce	Popis
   Výběr jazyka pro projekt aplikace funkcí	Vyberte JavaScript.	Vytvoří místní projekt Node.js Functions.
   Výběr programovacího modelu JavaScriptu	Vyberte Model V4.	Zvolte programovací model v4.
   Vyberte verzi.	Vyberte Azure Functions v4.	Tato možnost se zobrazí jenom v případě, že nástroje Core Tools ještě nejsou nainstalované. V tomto případě se nástroje Core Tools nainstalují při prvním spuštění aplikace.
   Výběr šablony pro první funkci projektu	Prozatím vyberte Přeskočit.
   Vyberte, jak chcete projekt otevřít.	Vyberte Otevřít v aktuálním okně.	Otevře Visual Studio Code ve složce, kterou jste vybrali.

Pokud chcete použít programovací model v4, nainstalujte verzi Preview v3.x knihovny durable-functions.

2. Nainstalujte balíček npm durable-functions spuštěním npm install durable-functions v kořenovém adresáři aplikace funkcí.

2. Nainstalujte verzi balíčku npm durable-functions ve verzi Preview spuštěním npm install durable-functions@preview v kořenovém adresáři aplikace funkcí.

Orchestrator

Pomocí šablony vytvoříte v projektu kód aplikace Durable Functions.

1. Na paletě příkazů zadejte a pak vyberte Azure Functions: Create Function.

2. Na příkazovém řádku zadejte následující informace:

   Instrukce	Akce	Popis
   Výběr šablony pro funkci	Vyberte orchestrátor Durable Functions.	Vytvoří orchestraci aplikace Durable Functions.
   Volba typu odolného úložiště	Vyberte Azure Storage (výchozí).a0>	Vybere back-end úložiště, který se používá pro vaši aplikaci Durable Functions.
   Zadejte název funkce.	Zadejte HelloOrchestrator.	Název odolné funkce.

Přidali jste orchestrátor pro koordinaci funkcí aktivit. Otevřete HelloOrchestrator/index.js a zobrazte funkci orchestrátoru. Každé volání context.df.callActivity vyvolá funkci aktivity s názvem Hello.

Dále přidejte odkazovanou Hello funkci aktivity.

Aktivita

1. Na paletě příkazů zadejte a pak vyberte Azure Functions: Create Function.

2. Na příkazovém řádku zadejte následující informace:

   Instrukce	Akce	Popis
   Výběr šablony pro funkci	Vyberte aktivitu Durable Functions.	Vytvoří funkci aktivity.
   Zadejte název funkce.	Zadejte Hello.	Název odolné funkce.

Přidali Hello jste funkci aktivity, která je vyvolána orchestrátorem. Otevřete Hello/index.js , abyste viděli, že jako vstup přebírá jméno a vrací pozdrav. Funkce aktivity je místo, kde ve svém pracovním postupu provádíte "skutečnou práci", jako je volání databáze nebo provádění některých nedeterministických výpočtů.

Nakonec přidejte funkci aktivovanou protokolem HTTP, která spouští orchestraci.

Klientská funkce (úvodní aplikace HTTP)

1. Na paletě příkazů zadejte a pak vyberte Azure Functions: Create Function.

2. Na příkazovém řádku zadejte následující informace:

   Instrukce	Akce	Popis
   Výběr šablony pro funkci	Vyberte Úvodní sadu HTTP Durable Functions.	Vytvoří úvodní funkci HTTP.
   Zadejte název funkce.	Zadejte DurableFunctionsHttpStart.	Název funkce aktivity.
   Úroveň autorizace	Vyberte Anonymní.	Pro ukázkové účely tato hodnota umožňuje volat funkci bez použití ověřování.

Přidali jste funkci aktivovanou protokolem HTTP, která spouští orchestraci. Otevřete DurableFunctionsHttpStart/index.js , abyste viděli, že používá client.startNew ke spuštění nové orchestrace. Pak se používá client.createCheckStatusResponse k vrácení odpovědi HTTP, která obsahuje adresy URL, které můžete použít k monitorování a správě nové orchestrace.

Teď máte aplikaci Durable Functions, kterou můžete spustit místně a nasadit do Azure.

Jednou z výhod programovacího modelu v4 je flexibilita, ve které píšete funkce. V modelu v4 můžete pomocí jedné šablony vytvořit všechny tři funkce v jednom souboru v projektu.

1. Na paletě příkazů zadejte a pak vyberte Azure Functions: Create Function.

2. Na příkazovém řádku zadejte následující informace:

   Instrukce	Akce	Popis
   Výběr šablony pro funkci	Vyberte orchestrátor Durable Functions.	Vytvoří soubor, který má orchestraci aplikace Durable Functions, funkci aktivity a odolnou úvodní funkci klienta.
   Volba typu odolného úložiště	Vyberte Azure Storage (výchozí).a0>	Nastaví back-end úložiště tak, aby se používal pro vaši aplikaci Durable Functions.
   Zadejte název funkce.	Zadejte dobrý den.	Název odolné funkce.

Otevřete soubor src/functions/hello.js a zobrazte vytvořené funkce.

Vytvořili jste orchestrátor volaný helloOrchestrator ke koordinaci funkcí aktivity. Každé volání context.df.callActivity vyvolá funkci aktivity s názvem hello.

Přidali jste také hello funkci aktivity, která je vyvolána orchestrátorem. Ve stejném souboru vidíte, že jako vstup přebírá jméno a vrací pozdrav. Funkce aktivity je místo, kde ve svém pracovním postupu provádíte "skutečnou práci", jako je volání databáze nebo provádění některých nedeterministických výpočtů.

Nakonec jsme také přidali funkci aktivovanou protokolem HTTP, která spouští orchestraci. Ve stejném souboru vidíte, že používá client.startNew ke spuštění nové orchestrace. Pak se používá client.createCheckStatusResponse k vrácení odpovědi HTTP, která obsahuje adresy URL, které můžete použít k monitorování a správě nové orchestrace.

Teď máte aplikaci Durable Functions, kterou můžete spustit místně a nasadit do Azure.

1. Pokud chcete funkci otestovat, nastavte zarážku v Hello kódu funkce aktivity (v hello/index.js). Vyberte F5 nebo vyberte Ladit: Spusťte ladění na paletě příkazů a spusťte projekt aplikace funkcí. Výstup nástroje Core Tools se zobrazí na panelu terminálu.

   Poznámka:

   Další informace o ladění naleznete v tématu Diagnostika Durable Functions.

1. Pokud chcete funkci otestovat, nastavte zarážku v hello kódu funkce aktivity (v src/functions/hello.js). Vyberte F5 nebo vyberte Ladit: Spusťte ladění na paletě příkazů a spusťte projekt aplikace funkcí. Výstup nástroje Core Tools se zobrazí na panelu terminálu.

   Poznámka:

   Další informace o ladění naleznete v tématu Diagnostika Durable Functions.

5. Pomocí prohlížeče nebo testovacího nástroje HTTP odešlete požadavek HTTP POST do koncového bodu adresy URL.

   Nahraďte poslední segment názvem funkce orchestrátoru (HelloOrchestrator). Adresa URL by měla být podobná http://localhost:7071/api/orchestrators/HelloOrchestrator.

   Odpověď je počáteční výsledek funkce HTTP. Dá vám vědět, že trvalá orchestrace byla úspěšně spuštěna. Zatím nezobrazuje konečný výsledek orchestrace. Odpověď obsahuje několik užitečných adres URL. Prozatím zadejte dotaz na stav orchestrace.

5. Pomocí prohlížeče nebo testovacího nástroje HTTP odešlete požadavek HTTP POST do koncového bodu adresy URL.

   Nahraďte poslední segment názvem funkce orchestrátoru (HelloOrchestrator). Adresa URL by měla být podobná http://localhost:7071/api/orchestrators/HelloOrchestrator.

   Odpověď je počáteční výsledek funkce HTTP. Dá vám vědět, že trvalá orchestrace byla úspěšně spuštěna. Zatím nezobrazuje konečný výsledek orchestrace. Odpověď obsahuje několik užitečných adres URL. Prozatím zadejte dotaz na stav orchestrace.

6. Zkopírujte hodnotu adresy URL , statusQueryGetUrivložte ji do adresního řádku prohlížeče a spusťte požadavek. Alternativně můžete k vydání požadavku GET pokračovat v používání testovacího nástroje HTTP.

   Požadavek se dotazuje instance orchestrace na stav. Měli byste vidět, že instance byla dokončena a že obsahuje výstupy nebo výsledky aplikace Durable Functions, například v tomto příkladu:

   {
       "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"
   }
   

6. Zkopírujte hodnotu adresy URL , statusQueryGetUrivložte ji do adresního řádku prohlížeče a spusťte požadavek. K vydání požadavku GET můžete také pokračovat v používání testovacího nástroje HTTP.

   Požadavek se dotazuje instance orchestrace na stav. Měli byste vidět, že instance byla dokončena a že obsahuje výstupy nebo výsledky aplikace Durable Functions, například v tomto příkladu:

   {
       "name": "helloOrchestrator",
       "instanceId": "6ba3f77933b1461ea1a3828c013c9d56",
       "runtimeStatus": "Completed",
       "input": "",
       "customStatus": null,
       "output": [
           "Hello, Tokyo",
           "Hello, Seattle",
           "Hello, Cairo"
       ],
       "createdTime": "2023-02-13T23:02:21Z",
       "lastUpdatedTime": "2023-02-13T23:02:25Z"
   }
   

1. Na výstupním panelu zkopírujte adresu URL triggeru HTTP. Adresa URL, která volá funkci aktivovanou protokolem HTTP, by měla být v tomto formátu:

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

1. Na výstupním panelu zkopírujte adresu URL triggeru HTTP. Adresa URL, která volá funkci aktivovanou protokolem HTTP, by měla být v tomto formátu:

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