Rychlý start: Vytvoření aplikace Python Durable Functions

Pomocí Durable Functions, funkce Azure Functions, můžete psát stavové funkce v bezserverovém prostředí. Durable Functions nainstalujete instalací rozšíření Azure Functions v Visual Studio Code. Rozšíření spravuje stav, kontrolní body a restartování ve vaší aplikaci.

V tomto rychlém startu použijete rozšíření Durable Functions v Visual Studio Code k místnímu vytvoření a otestování aplikace hello world Durable Functions v Azure Functions. Aplikace Durable Functions orchestruje a zřetězí volání dalších funkcí. Pak publikujete kód funkce do Azure. Nástroje, které používáte, jsou dostupné prostřednictvím rozšíření Visual Studio Code.

Screenshot spuštěné aplikace Durable Functions v Azure.

Poznámka:

V tomto rychlém startu se pro Python používá programovací model založený na dekorátoru v2. Tento model poskytuje jednodušší strukturu souborů a ve srovnání s v1 je zaměřen na kód.

Požadavky

K dokončení tohoto rychlého startu je potřeba:

Visual Studio Code nainstalováno.
Rozšíření Azure Functions pro Visual Studio Code je nainstalováno.
Nainstalovaná nejnovější verze nástrojů Azure Functions Core Tools.
Testovací nástroj HTTP, který udržuje vaše data v bezpečí. Další informace najdete v tématu Nástroje pro testování HTTP.
Předplatné Azure pro nasazení aplikace do Azure.
Python verze 3.7, 3.8, 3.9 nebo 3.10.

Pokud účet Azure nemáte, vytvořte si účet free než začnete.

Vytvoření místního projektu

V této části použijete Visual Studio Code k vytvoření místního projektu Azure Functions.

V Visual Studio Code vyberte klávesu F1 (nebo stisknutím kombinace kláves Ctrl/Cmd+Shift+P) otevřete paletu příkazů. Na příkazovém řádku (>) zadejte a pak vyberte Azure Functions: Create New Project.
Vyberte Procházet. V dialogovém okně Vybrat složku přejděte do složky, která se má použít pro váš projekt, a pak zvolte Vybrat.

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

Výzva	Akce	Popis
Výběr jazyka pro projekt aplikace funkcí	Vyberte Python.	Vytvoří místní projekt Python Functions.
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.
Python verze	Vyberte Python 3.7, Python 3.8, Python 3.9 nebo Python 3.10.	Visual Studio Code vytvoří virtuální prostředí pomocí vybrané verze.
Výběr šablony pro první funkci projektu	Vyberte Přeskočit prozatím.
Vyberte, jak chcete projekt otevřít.	Vyberte Otevřít v aktuálním okně.	Otevře Visual Studio Code ve vybrané složce.

Visual Studio Code nainstaluje Azure Functions Core Tools, pokud je potřeba vytvořit projekt. Vytvoří také projekt pro funkční aplikaci ve složce. Tento projekt obsahuje konfigurační soubory host.json a local.settings.json .

V kořenové složce se vytvoří také soubor requirements.txt . Určuje Python balíčky potřebné ke spuštění vaší aplikace funkcí.

Nainstalujte azure-functions-durable z PyPI

Když projekt vytvoříte, rozšíření Azure Functions Visual Studio Code automaticky vytvoří virtuální prostředí s vybranou verzí Python. Potom musíte aktivovat virtuální prostředí v terminálu a nainstalovat některé závislosti vyžadované Azure Functions a Durable Functions.

Otevřete requirements.txt v editoru a změňte jeho obsah na následující kód:
```
azure-functions
azure-functions-durable
```
V aktuální složce otevřete integrovaný terminál editoru (Ctrl+Shift+').
V integrovaném terminálu aktivujte virtuální prostředí v aktuální složce v závislosti na vašem operačním systému.
- Linux
- macOS
- Windows
```
source .venv/bin/activate
```
```
source .venv/bin/activate
```
```
.venv\scripts\activate
```

Potom v integrovaném terminálu, kde je virtuální prostředí aktivované, použijte pip k instalaci balíčků, které jste definovali.

python -m pip install -r requirements.txt

Poznámka:

Musíte nainstalovat azure-functions-durable verze 1.2.4 nebo novější.

Vytvoření funkcí

Nejzásadnější Durable Functions aplikace má tři funkce:

Funkce orchestratoru: Pracovní postup, který orchestruje další funkce.
Funkce aktivity: Funkce, která je volána funkcí orchestrátoru, provádí práci a volitelně vrací hodnotu.
Client function: Běžná funkce v Azure, která spouští funkci orchestrátoru. Tento příklad používá funkci aktivovanou protokolem HTTP.

Ukázkový kód

Pokud chcete vytvořit základní Durable Functions aplikaci pomocí těchto tří typů funkcí, nahraďte obsah function_app.py následujícím kódem 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}"

V následující tabulce najdete vysvětlení jednotlivých funkcí a jejich účelu v ukázce:

metoda	Popis
`hello_orchestrator`	Funkce orchestrátoru, která popisuje pracovní postup. V tomto případě se orchestrace spustí, vyvolá tři funkce v sekvenci a pak vrátí seřazené výsledky všech tří funkcí v seznamu.
`hello`	Funkce aktivity, která provádí práci orchestrovanou. Funkce vrátí jednoduché pozdravy města předané jako argument.
`http_start`	Funkce aktivovaná protokolem HTTP, která spouští instanci orchestrace a vrací `check status` odpověď.

Poznámka:

Durable Functions také podporuje programovací model Python v2 blueprints. Pokud chcete použít podrobné plány, zaregistrujte funkce podrobného plánu pomocí azure-functions-durableBlueprintclass. Výsledný výkres můžete zaregistrovat jako obvykle. Jako příklad můžete použít náš sample.

Konfigurace emulátoru úložiště

K místnímu otestování funkce můžete použít Azurite, emulátor pro Azure Storage. V local.settings.json nastavte hodnotu AzureWebJobsStorage na UseDevelopmentStorage=true, jak je uvedeno v tomto příkladu:

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "UseDevelopmentStorage=true",
    "FUNCTIONS_WORKER_RUNTIME": "python"
  }
}

Pokud chcete nainstalovat a spustit rozšíření Azurite v Visual Studio Code, zadejte na paletě příkazů Azurite: Start a vyberte Enter.

Pro Durable Functions aplikaci můžete použít další možnosti úložiště. Další informace o možnostech a výhodách úložiště najdete v tématu Durable Functions poskytovatelé úložiště.

Místní testování funkce

Azure Functions Core Tools vám umožní spustit projekt Azure Functions na místním vývojovém počítači. Pokud není nainstalovaný, zobrazí se výzva k instalaci těchto nástrojů při prvním spuštění funkce v Visual Studio Code.

Pokud chcete funkci otestovat, nastavte bod přerušení v hello kódu funkce aktivity. 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í najdete v tématu Diagnostika Durable Functions.
Na panelu terminálu zkopírujte koncový bod adresy URL funkce aktivované protokolem HTTP.
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 (hello_orchestrator). Adresa URL by měla být podobná http://localhost:7071/api/orchestrators/hello_orchestrator.

Odpověď je počáteční výsledek funkce HTTP. To vás informuje, ž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.
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 na stav instance orchestrace. Měli byste vidět, že instance byla dokončena a že obsahuje výsledky nebo výstupy trvalé funkce. Vypadá podobně jako v tomto příkladu:
```
{
    "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"
}
```
Pokud chcete zastavit ladění, v Visual Studio Code vyberte Shift+F5.

Po ověření správného spuštění funkce na místním počítači je čas projekt publikovat do Azure.

Než budete moct vytvářet Azure prostředky nebo publikovat aplikaci, musíte se přihlásit k Azure.

Pokud ještě nejste přihlášení, na panelu Aktivita vyberte ikonu Azure. Potom v části Zdroje vyberte Sign in to Azure.

Pokud už jste přihlášení a uvidíte stávající předplatná, přejděte k další části. Pokud ještě účet Azure nemáte, vyberte Vytvoření účtu Azure. Studenti mohou vybrat Vytvořit účet Azure pro studenty.
Po zobrazení výzvy v prohlížeči vyberte svůj Azure účet a přihlaste se pomocí přihlašovacích údajů k účtu Azure. Pokud vytvoříte nový účet, můžete se přihlásit po vytvoření účtu.
Po úspěšném přihlášení můžete zavřít nové okno prohlížeče. Předplatná, která patří vašemu Azure účtu, se zobrazí na bočním panelu.

Vytvoření aplikace funkcí v Azure

V této části vytvoříte funkční aplikaci v plánu Flex Consumption společně se souvisejícími prostředky v rámci vašeho předplatného Azure. Mnoho rozhodnutí o vytváření prostředků se pro vás provádí na základě výchozího chování. Pokud chcete mít větší kontrolu nad vytvořenými prostředky, musíte místo toho vytvořit aplikaci funkcí s pokročilými možnostmi.

V Visual Studio Code výběrem klávesy F1 otevřete paletu příkazů. Na příkazovém řádku (>) zadejte a pak vyberte Azure Functions: Vytvořit aplikaci funkcí v Azure.

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

Výzva	Akce
Výběr předplatného	Vyberte Azure předplatné, které chcete použít. Výzva se nezobrazí, pokud v části Prostředky uvidíte jenom jedno předplatné.
Zadejte nový název aplikace funkcí.	Zadejte globálně jedinečný název platný v cestě URL. Zadaný název se ověří, abyste měli jistotu, že je v Azure Functions jedinečný.
Výběr umístění pro nové prostředky	Vyberte Azure oblast. Pokud chcete dosáhnout lepšího výkonu , vyberte oblast blízko vás. Zobrazí se pouze oblasti podporované plány Flex Consumption.
Výběr zásobníku modulu runtime	Vyberte verzi jazyka, který aktuálně používáte místně.
Vyberte typ ověřování zdroje	Vyberte Spravovanou identitu, což je nejbezpečnější možnost připojení k výchozímu účtu úložiště hostitele.

Na panelu Azure: Protokol aktivit se v rozšíření Azure zobrazuje stav jednotlivých prostředků při jejich vytváření v Azure.

Screenshot, která zobrazuje záznam vytvoření prostředku Azure.

Po vytvoření funkční aplikace se ve vašem předplatném Azure vytvoří následující související prostředky. Prostředky se pojmenují na základě názvu, který jste zadali pro vaši aplikaci funkcí.
- Skupina prostředků, což je logický kontejner pro související prostředky.
- Aplikace funkcí, která poskytuje prostředí pro spouštění kódu funkce. Aplikace funkcí umožňuje seskupit funkce jako logickou jednotku pro snadnější správu, nasazení a sdílení prostředků ve stejném plánu hostování.
- Plán Azure App Service, který definuje základního hostitele vaší aplikace funkcí.
- Standardní účet Azure Storage, který používá hostitel služby Functions k udržování stavu a dalších informací o vaší aplikaci funkcí.
- Instance Application Insights, která je připojena k funkční aplikaci a sleduje použití funkcí v aplikaci.
- Spravovaná identita přiřazená uživatelem přidaná do role Přispěvatel dat objektů blob služby Storage v novém výchozím účtu úložiště hostitele.
Po vytvoření aplikace funkcí a použití balíčku nasazení se zobrazí oznámení.

Návod

Ve výchozím nastavení se Azure prostředky vyžadované vaší aplikační funkcí vytvoří na základě názvu, který zadáte pro vaši aplikační funkci. Ve výchozím nastavení se prostředky vytvářejí pomocí aplikace funkcí ve stejné nové skupině prostředků. Pokud chcete přizpůsobit názvy přidružených zdrojů nebo znovu použít existující zdroje, publikujte projekt s rozšířenými možnostmi vytvoření.

Nasazení projektu do Azure

Důležité

Nasazení do existující funkční aplikace vždy přepíše obsah této aplikace v Azure.

Na paletě příkazů zadejte a pak vyberte Azure Functions: Deploy to Function App.
Vyberte aplikaci funkcí, kterou jste právě vytvořili. Po zobrazení výzvy k přepsání předchozích nasazení vyberte Nasadit a nasaďte kód funkce do nového prostředku aplikace funkcí.
Po dokončení nasazení vyberte View Output a zobrazte výsledky vytváření a nasazení, včetně prostředků Azure, které jste vytvořili. Pokud oznámení vynecháte, vyberte ikonu zvonku v pravém dolním rohu a znovu ho zobrazíte.

Testování funkce v Azure

Zkopírujte adresu URL triggeru HTTP z výstupního panelu. Adresa URL, která volá funkci aktivovanou protokolem HTTP, musí být v tomto formátu:

https://<functionappname>.azurewebsites.net/api/orchestrators/hello_orchestrator
Do adresního řádku prohlížeče vložte novou adresu URL požadavku HTTP. Když použijete publikovanou aplikaci, můžete očekávat, že získáte stejnou odpověď na stav, kterou jste získali při místním otestování.

Aplikace Python Durable Functions, kterou jste vytvořili a publikovali pomocí Visual Studio Code, je připravená k použití.

Vyčištění prostředků

Pokud už nepotřebujete prostředky, které jste vytvořili k dokončení rychlého startu, abyste se vyhnuli souvisejícím nákladům ve vašem předplatném Azure, delete skupinu prostředků a všechny související prostředky.

Přečtěte si o vzorech aplikací common Durable Functions.
Další informace o testování jednotek

Váš názor

Byla tato stránka užitečná?

Last updated on 2026-03-06

Sdílet prostřednictvím

Rychlý start: Vytvoření aplikace Python Durable Functions

Požadavky

Vytvoření místního projektu

Nainstalujte azure-functions-durable z PyPI

Vytvoření funkcí

Ukázkový kód

Konfigurace emulátoru úložiště

Místní testování funkce

Přihlášení k Azure

Vytvoření aplikace funkcí v Azure

Nasazení projektu do Azure

Testování funkce v Azure

Vyčištění prostředků

Související obsah

Váš názor

Další materiály