Schnellstart: Erstellen einer Durable Functions-Python-App

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 Python aus.	Erstellt ein lokales Python-Functions-Projekt
   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.
   Python-Version	Wählen Sie Python 3.7, Python 3.8, Python 3.9 oder Python 3.10 aus.	Visual Studio Code erstellt eine virtuelle Umgebung mithilfe der von Ihnen ausgewählten Version.
   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	Wert	BESCHREIBUNG
   Sprache auswählen	Wählen Sie Python (Programmiermodell V2) aus.	Erstellt mithilfe des V2-Programmiermodells ein lokales Python-Functions-Projekt.
   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.
   Python-Version	Wählen Sie Python 3.7, Python 3.8, Python 3.9 oder Python 3.10 aus.	Visual Studio Code erstellt eine virtuelle Umgebung mithilfe der von Ihnen ausgewählten Version.
   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.

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.
   Angeben eines Funktionsnamens	Wählen Sie HelloOrchestrator aus.	Ein Name für Ihre Durable Function.

Damit haben Sie einen Orchestrator für die Koordinierung von Aktivitätsfunktionen hinzugefügt. Öffnen Sie HelloOrchestrator/__init__.py, um die Orchestratorfunktion anzuzeigen. Mit jedem Aufruf von context.call_activity 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.	Der Name Ihrer Aktivitätsfunktion.

Sie haben die Aktivitätsfunktion Hello hinzugefügt, die vom Orchestrator aufgerufen wird. Öffnen Sie Hello/__init__.py, um zu sehen, dass sie einen Namen als Eingabe akzeptiert und eine Begrüßung zurückgibt. Eine Aktivitätsfunktion dient zum Ausführen von Aktionen wie Datenbankaufrufen oder Berechnungen.

Abschließend fügen Sie noch eine per HTTP ausgelöste Funktion hinzu, durch die die Orchestrierung gestartet wird.

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 Clientfunktion
   Autorisierungsstufe	Wählen Sie Anonym aus.	Für Demozwecke kann diese Funktion ohne Authentifizierung aufgerufen werden.

Sie haben eine per HTTP ausgelöste Funktion hinzugefügt, durch die eine Orchestrierung gestartet wird. Öffnen Sie DurableFunctionsHttpStart/__init__.py, um zu sehen, dass client.start_new zum Starten einer neuen Orchestrierung verwendet wird. Anschließend wird client.create_check_status_response verwendet, um eine HTTP-Antwort mit URLs zurückzugeben, die zum Überwachen und Verwalten der neuen Orchestrierung verwendet werden können.

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

Anforderungen

Version 2 des Python-Programmiermodells erfordert die folgenden Mindestversionen:

• Azure Functions-Runtime v4.16 oder höher
• Azure Functions Core Tools v4.0.5095 oder höher (bei lokaler Ausführung)
• azure-functions-durable v1.2.4 und höher

Aktivieren des v2-Programmiermodells

Die folgende Anwendungseinstellung ist erforderlich, um das v2-Programmiermodell auszuführen:

• Name: AzureWebJobsFeatureFlags
• Wert: EnableWorkerIndexing

Wenn Sie lokal mithilfe der Azure Functions Core Tools entwickeln, fügen Sie diese Einstellung zu Ihrer local.settings.json-Datei hinzu. Wenn Sie in Azure entwickeln, führen Sie die folgenden Schritte mit einem relevanten Tool aus:

az functionapp config appsettings set --name <FUNCTION_APP_NAME> --resource-group <RESOURCE_GROUP_NAME> --settings AzureWebJobsFeatureFlags=EnableWorkerIndexing

Update-AzFunctionAppSetting -Name <FUNCTION_APP_NAME> -ResourceGroupName <RESOURCE_GROUP_NAME> -AppSetting @{"AzureWebJobsFeatureFlags" = "EnableWorkerIndexing"}

Um eine einfache Durable Functions-App mit diesen drei Funktionstypen zu erstellen, ersetzen Sie den Inhalt von function_app.py durch den folgenden Python-Code:

import azure.functions as func
import azure.durable_functions as df

myApp = df.DFApp(http_auth_level=func.AuthLevel.ANONYMOUS)

# An HTTP-triggered function with a Durable Functions client binding
@myApp.route(route="orchestrators/{functionName}")
@myApp.durable_client_input(client_name="client")
async def http_start(req: func.HttpRequest, client):
    function_name = req.route_params.get('functionName')
    instance_id = await client.start_new(function_name)
    response = client.create_check_status_response(req, instance_id)
    return response

# Orchestrator
@myApp.orchestration_trigger(context_name="context")
def hello_orchestrator(context):
    result1 = yield context.call_activity("hello", "Seattle")
    result2 = yield context.call_activity("hello", "Tokyo")
    result3 = yield context.call_activity("hello", "London")

    return [result1, result2, result3]

# Activity
@myApp.activity_trigger(input_name="city")
def hello(city: str):
    return f"Hello {city}"

In der folgenden Tabelle werden die einzelnen Funktionen und ihre Aufgabe im Beispiel erläutert:

1. Legen Sie zum Testen der Funktion einen Breakpoint im Code der Aktivitätsfunktion Hello (Hello/__init__.py) 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 der Funktion einen Breakpoint im Code der Aktivitätsfunktion hello 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.

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. Ihnen sollte angezeigt werden, dass die Instanz fertiggestellt wurde und die Ausgaben oder Ergebnisse der dauerhaften Funktion enthält. Sie ähnelt der im folgenden Beispiel:

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

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. 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. Ihnen sollte angezeigt werden, dass die Instanz fertiggestellt wurde und die Ausgaben oder Ergebnisse der dauerhaften Funktion enthält. Sie ähnelt der im folgenden Beispiel:

   {
       "name": "hello_orchestrator",
       "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"
   }
   

1. Kopieren Sie die URL des HTTP-Triggers im Bereich Ausgabe. Die URL, über die Ihre über HTTP ausgelöste Funktion aufgerufen wird, muss das folgende Format aufweisen:

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

1. Kopieren Sie die URL des HTTP-Triggers im Bereich Ausgabe. Die URL, über die Ihre über HTTP ausgelöste Funktion aufgerufen wird, muss das folgende Format aufweisen:

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