Szybki start: tworzenie aplikacji Durable Functions w języku Python

3. Po wyświetleniu monitów podaj następujące informacje:

   Monit	Akcja	opis
   Wybieranie języka projektu aplikacji funkcji	Wybierz pozycję Python.	Tworzy lokalny projekt usługi Python Functions.
   Wybierz wersję	Wybierz pozycję Azure Functions w wersji 4.	Ta opcja jest widoczna tylko wtedy, gdy narzędzia Core Tools nie są jeszcze zainstalowane. W takim przypadku narzędzia Core Tools są instalowane po raz pierwszy podczas uruchamiania aplikacji.
   Wersja języka Python	Wybierz pozycję Python 3.7, Python 3.8, Python 3.9 lub Python 3.10.	Program Visual Studio Code tworzy środowisko wirtualne przy użyciu wybranej wersji.
   Wybieranie szablonu dla pierwszej funkcji projektu	Wybierz pozycję Pomiń na razie.
   Wybierz sposób otwierania projektu	Wybierz pozycję Otwórz w bieżącym oknie.	Otwiera program Visual Studio Code w wybranym folderze.

3. Po wyświetleniu monitów podaj następujące informacje:

   Monit	Wartość	Opis
   Wybieranie języka	Wybierz pozycję Python (model programowania w wersji 2).	Tworzy lokalny projekt usługi Python Functions przy użyciu modelu programowania w wersji 2.
   Wybierz wersję	Wybierz pozycję Azure Functions w wersji 4.	Ta opcja jest widoczna tylko wtedy, gdy narzędzia Core Tools nie są jeszcze zainstalowane. W takim przypadku narzędzia Core Tools są instalowane po raz pierwszy podczas uruchamiania aplikacji.
   Wersja języka Python	Wybierz pozycję Python 3.7, Python 3.8, Python 3.9 lub Python 3.10.	Program Visual Studio Code tworzy środowisko wirtualne przy użyciu wybranej wersji.
   Wybierz sposób otwierania projektu	Wybierz pozycję Otwórz w bieżącym oknie.	Otwiera program Visual Studio Code w wybranym folderze.

Orchestrator, funkcja

Szablon służy do tworzenia kodu aplikacji Durable Functions w projekcie.

1. W palecie poleceń wprowadź , a następnie wybierz pozycję Azure Functions: Create Function (Azure Functions: Utwórz funkcję).

2. Po wyświetleniu monitów podaj następujące informacje:

   Monit	Akcja	opis
   Wybieranie szablonu dla funkcji	Wybierz pozycję Durable Functions orchestrator.	Tworzy aranżację aplikacji Durable Functions.
   Podaj nazwę funkcji	Wybierz pozycję HelloOrchestrator.	Nazwa funkcji trwałej.

Dodano orkiestrator do koordynowania funkcji działania. Otwórz aplikację HelloOrchestrator/__init__.py , aby wyświetlić funkcję orkiestratora. Każde wywołanie do wywołania context.call_activity wywołuje funkcję działania o nazwie Hello.

Następnie dodasz przywołyną Hello funkcję działania.

Activity, funkcja

1. W palecie poleceń wprowadź , a następnie wybierz pozycję Azure Functions: Create Function (Azure Functions: Utwórz funkcję).

2. Po wyświetleniu monitów podaj następujące informacje:

   Monit	Akcja	opis
   Wybieranie szablonu dla funkcji	Wybierz pozycję Działanie rozszerzenia Durable Functions.	Tworzy funkcję działania.
   Podaj nazwę funkcji	Wprowadź witaj.	Nazwa funkcji działania.

Dodano Hello funkcję działania wywoływaną przez koordynatora. Otwórz pozycję Hello/__init__.py , aby zobaczyć, że przyjmuje nazwę jako dane wejściowe i zwraca powitanie. Funkcja działania polega na wykonywaniu akcji, takich jak wykonywanie wywołania bazy danych lub wykonywanie obliczeń.

Na koniec dodasz funkcję wyzwalaną przez protokół HTTP, która uruchamia orkiestrację.

Funkcja klienta (starter HTTP)

1. W palecie poleceń wprowadź , a następnie wybierz pozycję Azure Functions: Create Function (Azure Functions: Utwórz funkcję).

2. Po wyświetleniu monitów podaj następujące informacje:

   Monit	Akcja	opis
   Wybieranie szablonu dla funkcji	Wybierz pozycję Durable Functions HTTP starter.	Tworzy funkcję startową HTTP.
   Podaj nazwę funkcji	Wprowadź durableFunctionsHttpStart.	Nazwa funkcji klienta
   Poziom autoryzacji	Wybierz pozycję Anonimowe.	W celach demonstracyjnych ta wartość umożliwia wywoływanie funkcji bez użycia uwierzytelniania.

Dodano funkcję wyzwalaną przez protokół HTTP, która uruchamia orkiestrację. Otwórz plik DurableFunctionsHttpStart/__init__.py , aby zobaczyć, że używa client.start_new go do rozpoczęcia nowej aranżacji. Następnie służy client.create_check_status_response do zwracania odpowiedzi HTTP zawierającej adresy URL, których można użyć do monitorowania nowej aranżacji i zarządzania nią.

Masz teraz aplikację Durable Functions, którą można uruchomić lokalnie i wdrożyć na platformie Azure.

Wymagania

Wersja 2 modelu programowania w języku Python wymaga następujących minimalnych wersji:

• Środowisko uruchomieniowe usługi Azure Functions w wersji 4.16 lub nowszej
• Narzędzia Azure Functions Core Tools w wersji 4.0.5095 lub nowszej (jeśli są uruchomione lokalnie)
• azure-functions-durable v1.2.4+

Włączanie modelu programowania w wersji 2

Do uruchomienia modelu programowania w wersji 2 jest wymagane następujące ustawienie aplikacji:

• Nazwa: AzureWebJobsFeatureFlags
• Wartość: EnableWorkerIndexing

Jeśli używasz narzędzi Azure Functions Core Tools lokalnie, dodaj to ustawienie do pliku local.settings.json. Jeśli korzystasz z platformy Azure, wykonaj następujące kroki, korzystając z odpowiedniego narzędzia:

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

Aby utworzyć podstawową aplikację Durable Functions przy użyciu tych trzech typów funkcji, zastąp zawartość function_app.py następującym kodem w języku Python:

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

Zapoznaj się z poniższą tabelą, aby zapoznać się z wyjaśnieniem poszczególnych funkcji i jej przeznaczenia w przykładzie:

1. Aby przetestować funkcję, ustaw punkt przerwania w Hello kodzie funkcji działania (w funkcji Hello/__init__.py). Wybierz pozycję F5 lub wybierz pozycję Debuguj: rozpocznij debugowanie na palecie poleceń, aby uruchomić projekt aplikacji funkcji. Dane wyjściowe z narzędzi Core Tools są wyświetlane na panelu terminalu.

   Uwaga

   Aby uzyskać więcej informacji na temat debugowania, zobacz Diagnostyka rozszerzenia Durable Functions.

1. Aby przetestować funkcję, ustaw punkt przerwania w hello kodzie funkcji działania. Wybierz pozycję F5 lub wybierz pozycję Debuguj: rozpocznij debugowanie na palecie poleceń, aby uruchomić projekt aplikacji funkcji. Dane wyjściowe z narzędzi Core Tools są wyświetlane na panelu terminalu.

   Uwaga

   Aby uzyskać więcej informacji na temat debugowania, zobacz Diagnostyka rozszerzenia Durable Functions.

5. Użyj przeglądarki lub narzędzia testowego HTTP, aby wysłać żądanie HTTP POST do punktu końcowego adresu URL.

   Zastąp ostatni segment nazwą funkcji orkiestratora (HelloOrchestrator). Adres URL powinien być podobny do http://localhost:7071/api/orchestrators/HelloOrchestrator.

   Odpowiedź to początkowy wynik funkcji HTTP. Informuje o tym, że trwała aranżacja została uruchomiona pomyślnie. Nie wyświetla jeszcze wyniku końcowego aranżacji. Odpowiedź zawiera kilka przydatnych adresów URL. Na razie wykonaj zapytanie dotyczące stanu aranżacji.

6. Skopiuj wartość adresu URL dla statusQueryGetUri, wklej ją na pasku adresu przeglądarki i wykonaj żądanie. Możesz również nadal używać narzędzia do testowania HTTP w celu wystawienia żądania GET.

   Żądanie wysyła zapytanie do wystąpienia orkiestracji dla stanu. Powinno zostać wyświetlone, że wystąpienie zostało zakończone i że zawiera dane wyjściowe lub wyniki funkcji trwałej. Wygląda podobnie do tego przykładu:

   {
       "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. Użyj przeglądarki lub narzędzia testowego HTTP, aby wysłać żądanie HTTP POST do punktu końcowego adresu URL.

   Zastąp ostatni segment nazwą funkcji orkiestratora (HelloOrchestrator). Adres URL powinien być podobny do http://localhost:7071/api/orchestrators/HelloOrchestrator.

   Odpowiedź to początkowy wynik funkcji HTTP. Informuje o tym, że trwała aranżacja została uruchomiona pomyślnie. Nie wyświetla jeszcze wyniku końcowego aranżacji. Odpowiedź zawiera kilka przydatnych adresów URL. Na razie wykonaj zapytanie dotyczące stanu aranżacji.

6. Skopiuj wartość adresu URL dla statusQueryGetUri, wklej ją na pasku adresu przeglądarki i wykonaj żądanie. Możesz również nadal używać narzędzia do testowania HTTP w celu wystawienia żądania GET.

   Żądanie wysyła zapytanie do wystąpienia orkiestracji dla stanu. Powinno zostać wyświetlone, że wystąpienie zostało zakończone i że zawiera dane wyjściowe lub wyniki funkcji trwałej. Wygląda podobnie do tego przykładu:

   {
       "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. Skopiuj adres URL wyzwalacza HTTP z panelu danych wyjściowych. Adres URL, który wywołuje funkcję wyzwalaną przez protokół HTTP, musi mieć następujący format:

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

1. Skopiuj adres URL wyzwalacza HTTP z panelu danych wyjściowych. Adres URL, który wywołuje funkcję wyzwalaną przez protokół HTTP, musi mieć następujący format:

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