Schnellstart: Erstellen einer Durable Functions-JavaScript-App

• Die Visual Studio Code-Erweiterung Azure Functions installiert.

• Installation der Azure Functions-Erweiterung für Visual Studio Code, Version 1.10.4 oder höher

• Die neueste Version der Azure Functions Core Tools installiert.

• Installation der Azure Functions Core Tools, Version 4.0.5382 oder höher

• Installation von Node.js, Version 16.x oder höher

• Installation von Node.js, Version 18.x oder höher

3. Geben Sie nach entsprechender Aufforderung folgende Informationen ein:

   Prompt	Aktion	Beschreibung
   Auswählen einer Sprache für Ihr Funktions-App-Projekt	Wählen Sie JavaScript aus.	Erstellt ein lokales Functions-Node.js-Projekt
   Auswählen eines JavaScript-Programmiermodells	Wählen Sie Modell V3 aus.	Legt Version 3 des Programmiermodells fest.
   Wählen Sie eine Version aus	Wählen Sie Azure Functions v4 aus.	Diese Option wird nur angezeigt, wenn Core Tools noch nicht installiert ist. In diesem Fall werden die Core Tools beim erstmaligen Ausführen der App installiert.
   Auswählen einer Vorlage für die erste Funktion Ihres Projekts	Wählen Sie Vorerst überspringen aus.
   Auswählen, wie Sie Ihr Projekt öffnen möchten	Wählen Sie In aktuellem Fenster öffnen aus.	Öffnet Visual Studio Code im ausgewählten Ordner.

3. Geben Sie nach entsprechender Aufforderung folgende Informationen ein:

   Prompt	Aktion	Beschreibung
   Auswählen einer Sprache für Ihr Funktions-App-Projekt	Wählen Sie JavaScript aus.	Erstellt ein lokales Functions-Node.js-Projekt
   Auswählen eines JavaScript-Programmiermodells	Wählen Sie Modellversion 4 aus.	Wählen Sie Version 4 des Programmiermodells aus.
   Wählen Sie eine Version aus	Wählen Sie Azure Functions v4 aus.	Diese Option wird nur angezeigt, wenn Core Tools noch nicht installiert ist. In diesem Fall werden die Core Tools beim erstmaligen Ausführen der App installiert.
   Auswählen einer Vorlage für die erste Funktion Ihres Projekts	Wählen Sie Vorerst überspringen aus.
   Auswählen, wie Sie Ihr Projekt öffnen möchten	Wählen Sie In aktuellem Fenster öffnen aus.	Öffnet Visual Studio Code im ausgewählten Ordner.

Um Version 4 des Programmiermodells zu verwenden, installieren Sie die Vorschauversion v3.x der Bibliothek „durable-functions“.

2. Führen Sie npm install durable-functions im Stammverzeichnis der Funktions-App aus, um das npm-Paket „durable-functions“ zu installieren.

2. Installieren Sie die Vorschauversion des npm-Pakets „durable-functions“, indem Sie im Stammverzeichnis der Funktions-App npm install durable-functions@preview ausführen.

Orchestratorfunktion

Sie verwenden eine Vorlage, um in Ihrem Projekt den Code Ihrer Durable Functions-App zu erstellen.

1. Geben Sie in der Befehlspalette Azure Functions: Funktion erstellen ein und wählen Sie diese Option.

2. Geben Sie nach entsprechender Aufforderung folgende Informationen ein:

   Prompt	Aktion	Beschreibung
   „Select a template for your function“ (Wählen Sie eine Vorlage für Ihre Funktion aus.)	Wählen Sie Durable Functions-Orchestrator aus.	Erstellen Sie eine Orchestrierung für Durable Functions-App.
   Dauerhaften Speichertyp auswählen	Wählen Sie Azure Storage (Standard) aus.	Wählt das Speicher-Back-End aus, das für Ihre Durable Functions-App verwendet wird
   Angeben eines Funktionsnamens	Geben Sie HelloOrchestrator ein.	Ein Name für Ihre Durable Function.

Damit haben Sie einen Orchestrator für die Koordinierung von Aktivitätsfunktionen hinzugefügt. Öffnen Sie HelloOrchestrator/index.js, um die Orchestratorfunktion anzuzeigen. Mit jedem Aufruf von context.df.callActivity wird eine Aktivitätsfunktion namens Hello aufgerufen.

Fügen Sie als Nächstes die referenzierte Aktivitätsfunktion Hello hinzu.

Aktivitätsfunktion

1. Geben Sie in der Befehlspalette Azure Functions: Funktion erstellen ein und wählen Sie diese Option.

2. Geben Sie nach entsprechender Aufforderung folgende Informationen ein:

   Prompt	Aktion	Beschreibung
   „Select a template for your function“ (Wählen Sie eine Vorlage für Ihre Funktion aus.)	Aktivität für Durable Functions wählen.	Erstellt eine Aktivitätsfunktion.
   Angeben eines Funktionsnamens	Geben Sie Hallo ein.	Ein Name für Ihre Durable Function.

Sie haben die Aktivitätsfunktion Hello hinzugefügt, die vom Orchestrator aufgerufen wird. Öffnen Sie Hello/index.js, um zu sehen, dass sie einen Namen als Eingabe akzeptiert und eine Begrüßung zurückgibt. Bei einer Aktivitätsfunktion handelt es sich um den Ort, an dem Sie „die eigentliche Arbeit“ in Ihrem Workflow ausführen. Dazu gehören beispielsweise Datenbankaufrufe oder nicht deterministische Berechnungen.

Abschließend fügen Sie eine über HTTP ausgelöste Funktion hinzu, die die Orchestrierung startet.

Clientfunktion (HTTP-Starter)

1. Geben Sie in der Befehlspalette Azure Functions: Funktion erstellen ein und wählen Sie diese Option.

2. Geben Sie nach entsprechender Aufforderung folgende Informationen ein:

   Prompt	Aktion	Beschreibung
   „Select a template for your function“ (Wählen Sie eine Vorlage für Ihre Funktion aus.)	HTTP-Starter für Durable Functions auswählen.	Erstellt eine HTTP-Startfunktion.
   Angeben eines Funktionsnamens	Geben Sie DurableFunctionsHttpStart ein.	Der Name Ihrer Aktivitätsfunktion.
   Autorisierungsstufe	Wählen Sie Anonym aus.	Zu Demozwecken kann die Funktion mit diesem Wert ohne Authentifizierung aufgerufen werden.

Sie haben eine per HTTP ausgelöste Funktion hinzugefügt, durch die eine Orchestrierung gestartet wird. Öffnen Sie DurableFunctionsHttpStart/index.js, um zu sehen, dass client.startNew zum Starten einer neuen Orchestrierung verwendet wird. Anschließend wird client.createCheckStatusResponse verwendet, um eine HTTP-Antwort zurückzugeben, die URLs enthält, die Sie zum Überwachen und Verwalten der neuen Orchestrierung verwenden können.

Sie verfügen nun über eine Durable Functions-App, die lokal ausgeführt und in Azure bereitgestellt werden kann.

Einer der Vorteile von Version 4 des Programmiermodells besteht darin, dass Sie Ihre Funktionen an einer beliebigen Stelle schreiben können. In Version 4 des Modells können Sie eine einzelne Vorlage verwenden, um in Ihrem Projekt alle drei Funktionen in einer Datei zu erstellen.

1. Geben Sie in der Befehlspalette Azure Functions: Funktion erstellen ein und wählen Sie diese Option.

2. Geben Sie nach entsprechender Aufforderung folgende Informationen ein:

   Prompt	Aktion	Beschreibung
   „Select a template for your function“ (Wählen Sie eine Vorlage für Ihre Funktion aus.)	Wählen Sie Durable Functions-Orchestrator aus.	Erstellt eine Datei mit einer Orchestrierung für die Durable Functions-App, einer Aktivitätsfunktion und einer dauerhaften Clientstartfunktion
   Dauerhaften Speichertyp auswählen	Wählen Sie Azure Storage (Standard) aus.	Legt das Speicher-Back-End fest, das für Ihre Durable Functions-App verwendet werden soll
   Angeben eines Funktionsnamens	Geben Sie Hello ein.	Der Name Ihrer dauerhaften Funktion

Öffnen Sie src/functions/hello.js, um die von Ihnen erstellten Funktionen anzuzeigen.

Sie haben einen Orchestrator namens helloOrchestrator zum Koordinieren von Aktivitätsfunktionen erstellt. Mit jedem Aufruf von context.df.callActivity wird eine Aktivitätsfunktion namens hello aufgerufen.

Außerdem haben Sie die Aktivitätsfunktion hello hinzugefügt, die durch den Orchestrator aufgerufen wird. In der gleichen Datei können Sie erkennen, dass ein Name als Eingabe akzeptiert und eine Grußformel zurückgegeben wird. Bei einer Aktivitätsfunktion handelt es sich um den Ort, an dem Sie „die eigentliche Arbeit“ in Ihrem Workflow ausführen. Dazu gehören beispielsweise Datenbankaufrufe oder nicht deterministische Berechnungen.

Schließlich haben Sie zudem eine über HTTP ausgelöste Funktion hinzugefügt, die eine Orchestrierung startet. In derselben Datei sehen Sie, dass client.startNew verwendet wird, um eine neue Orchestrierung zu starten. Anschließend wird client.createCheckStatusResponse verwendet, um eine HTTP-Antwort zurückzugeben, die URLs enthält, die Sie zum Überwachen und Verwalten der neuen Orchestrierung verwenden können.

Sie verfügen nun über eine Durable Functions-App, die lokal ausgeführt und in Azure bereitgestellt werden kann.

1. Legen Sie zum Testen Ihrer Funktion einen Breakpoint im Code der Aktivitätsfunktion Hello (Hello/index.js) fest. Wählen Sie F5 aus, oder wählen Sie Debuggen: Debuggen starten in der Befehlspalette, um das Funktions-App-Projekt zu starten. Die Ausgabe von Core Tools wird im Terminalbereich angezeigt.

   Hinweis

   Weitere Informationen zum Debuggen finden Sie unter Diagnose in Durable Functions.

1. Legen Sie zum Testen Ihrer Funktion einen Breakpoint im Code der Aktivitätsfunktion hello (src/functions/hello.js) fest. Wählen Sie F5 aus, oder wählen Sie Debuggen: Debuggen starten in der Befehlspalette, um das Funktions-App-Projekt zu starten. Die Ausgabe von Core Tools wird im Terminalbereich angezeigt.

   Hinweis

   Weitere Informationen zum Debuggen finden Sie unter Diagnose in Durable Functions.

5. Verwenden Sie einen Browser oder ein HTTP-Testtool, um eine HTTP POST-Anforderung an den URL-Endpunkt zu senden.

   Ersetzen Sie das letzte Segment durch den Namen der Orchestratorfunktion (HelloOrchestrator). Die URL sollte in etwa wie folgt lauten: http://localhost:7071/api/orchestrators/HelloOrchestrator.

   Die Antwort ist das anfängliche Ergebnis der HTTP-Funktion. Es teilt Ihnen mit, dass die dauerhafte Orchestrierung erfolgreich gestartet wurde. Das Endergebnis der Orchestrierung wird noch nicht angezeigt. Die Antwort enthält einige nützliche URLs. Zunächst fragen wir den Status der Orchestrierung ab.

5. Verwenden Sie einen Browser oder ein HTTP-Testtool, um eine HTTP POST-Anforderung an den URL-Endpunkt zu senden.

   Ersetzen Sie das letzte Segment durch den Namen der Orchestratorfunktion (HelloOrchestrator). Die URL sollte in etwa wie folgt lauten: http://localhost:7071/api/orchestrators/HelloOrchestrator.

   Die Antwort ist das anfängliche Ergebnis der HTTP-Funktion. Es teilt Ihnen mit, dass die dauerhafte Orchestrierung erfolgreich gestartet wurde. Das Endergebnis der Orchestrierung wird noch nicht angezeigt. Die Antwort enthält einige nützliche URLs. Zunächst fragen wir den Status der Orchestrierung ab.

6. Kopieren Sie den URL-Wert für statusQueryGetUri, fügen Sie ihn in die Adressleiste des Browsers ein, und führen Sie anschließend die Anforderung aus. Alternativ können Sie auch weiterhin Ihr HTTP-Testtool verwenden, um die GET-Anforderung ausstellen zu können.

   Die Anforderung fragt die Orchestrierungsinstanz der Status ab. Es sollte angezeigt werden, dass die Instanz abgeschlossen ist und diese die Ausgaben oder Ergebnisse der Durable Functions-App wie im folgenden Beispiel enthält:

   {
       "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. Kopieren Sie den URL-Wert für statusQueryGetUri, fügen Sie ihn in die Adressleiste des Browsers ein, und führen Sie anschließend die Anforderung aus. Sie können auch weiterhin Ihr HTTP-Testtool verwenden, um die GET-Anforderung ausstellen zu können.

   Die Anforderung fragt die Orchestrierungsinstanz der Status ab. Es sollte angezeigt werden, dass die Instanz abgeschlossen ist und diese die Ausgaben oder Ergebnisse der Durable Functions-App wie im folgenden Beispiel enthält:

   {
       "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. Kopieren Sie im Panel „AUSGABE“ die URL des HTTP-Triggers. Die URL, über die Ihre per HTTP ausgelöste Funktion aufgerufen wird, muss das folgende Format haben:

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

1. Kopieren Sie im Panel „AUSGABE“ die URL des HTTP-Triggers. Die URL, über die Ihre per HTTP ausgelöste Funktion aufgerufen wird, muss das folgende Format haben:

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