Rozšíření Dapr pro Azure Functions

Článek
05/10/2024

Rozšíření Dapr pro Azure Functions je sada nástrojů a služeb, které vývojářům umožňují snadnou integraci Azure Functions s platformou Dapr (Distributed Application Runtime).

Azure Functions je výpočetní služba řízená událostmi, která poskytuje sadu triggerů a vazeb pro snadné připojení k dalším službám Azure. Dapr poskytuje sadu stavebních bloků a osvědčených postupů pro vytváření distribuovaných aplikací, včetně mikroslužeb, správy stavu, pub/sub messaging a dalších.

Díky integraci mezi Dapr a Functions můžete vytvářet funkce, které reagují na události z Dapr nebo externích systémů.

Akce	Směr	Typ
Trigger u vstupní vazby Dapr	–	daprBindingTrigger
Aktivace při vyvolání služby Dapr	–	daprServiceInvocationTrigger
Aktivace v předplatném tématu Dapr	–	daprTopicTrigger
Vyžádání stavu Dapr pro provedení	V	daprState
Načtení tajných kódů Dapr pro spuštění	V	daprSecret
Uložení hodnoty do stavu Dapr	Ven	daprState
Vyvolání jiné aplikace Dapr	Ven	daprInvoke
Publikování zprávy do tématu Dapr	Ven	daprPublish
Odeslání hodnoty výstupní vazbě Dapr	Ven	daprBinding

Instalace rozšíření

Balíček NuGet rozšíření, který nainstalujete, závisí na režimu jazyka C# v procesu nebo izolovaném pracovním procesu , který používáte ve své aplikaci funkcí:

Probíhá proces
Izolovaný proces

Toto rozšíření je k dispozici instalací balíčku NuGet verze 1.0.0.

Pomocí rozhraní příkazového řádku .NET:

dotnet add package Microsoft.Azure.WebJobs.Extensions.Dapr

Přidejte rozšíření do projektu instalací balíčku NuGet verze 1.0.0.

Pomocí rozhraní příkazového řádku .NET:

dotnet add package Microsoft.Azure.Functions.Worker.Extensions.Dapr

Instalace sady

Sada v4.x

Příponu můžete přidat přidáním nebo nahrazením následujícího kódu v host.json souboru:

{
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle",
    "version": "[4.*, 5.0.0)"
  }
}

Povolení dapr

Dapr můžete nakonfigurovat pomocí různých [argumentů a poznámek][dapr-args] na základě kontextu modulu runtime. Dapr pro Azure Functions můžete nakonfigurovat prostřednictvím dvou kanálů:

Šablony infrastruktury jako kódu (IaC) jako v šablonách Bicep nebo Azure Resource Manageru (ARM)
Azure Portal

Při použití šablony IaC zadejte následující argumenty v properties části definice prostředku aplikace kontejneru.

Bicep
RAMENO

DaprConfig: {
  enabled: true
  appId: '${envResourceNamePrefix}-funcapp'
  appPort: 3001
  httpReadBufferSize: ''
  httpMaxRequestSize: ''
  logLevel: ''
  enableApiLogging: true
}

"DaprConfig": {
  "enabled": true,
  "appId": "${envResourceNamePrefix}-funcapp",
  "appPort": 3001,
  "httpReadBufferSize": "",
  "httpMaxRequestSize": "",
  "logLevel": "",
  "enableApiLogging": true
}

Výše uvedené hodnoty konfigurace Dapr se považují za změny oboru aplikace. Když spustíte aplikaci typu kontejner v režimu více revizí, změny těchto nastavení nevytvoří novou revizi. Místo toho se všechny existující revize restartují, aby se zajistilo, že jsou nakonfigurované s nejaktuálnějšími hodnotami.

Při konfiguraci Dapr pomocí webu Azure Portal přejděte do aplikace funkcí a v nabídce na levé straně vyberte Dapr :

Snímek obrazovky ukazující, kde najít povolení Dapr pro aplikaci funkcí na webu Azure Portal

Porty a naslouchací procesy Dapr

Když aktivujete funkci z Dapr, rozšíření automaticky zpřístupní port 3001 pro naslouchání příchozím požadavkům ze sajdkáru Dapr.

Důležité

Port 3001 se zobrazí a naslouchá jenom v případě, že je v aplikaci funkcí definovaný trigger Dapr. Při použití Dapr čeká sajdkárna na přijetí odpovědi z definovaného portu před dokončením instance. Nedefinujte poznámku dapr.io/port nebo --app-port pokud nemáte aktivační událost. To může aplikaci uzamknout ze sajdkáru Dapr.

Pokud používáte jenom vstupní a výstupní vazby, 3001 port nemusí být vystaven ani definován.

Když se Azure Functions pokusí komunikovat s Dapr, ve výchozím nastavení volá Dapr přes port přeložený z proměnné DAPR_HTTP_PORTprostředí . Pokud má tato proměnná hodnotu null, výchozí hodnota je port 3500.

Adresu Dapr používanou vstupními a výstupními vazbami můžete přepsat nastavením DaprAddress vlastnosti pro function.json vazbu (nebo atributu). Ve výchozím nastavení používá http://localhost:{DAPR_HTTP_PORT}.

Aplikace funkcí stále zveřejňuje další port a koncový bod pro věci, jako jsou triggery HTTP, které se místně ve výchozím nastavení nastaví 7071, ale v kontejneru se ve výchozím nastavení nastaví 80.

Typy vazeb

Typy vazeb podporované pro .NET závisí na režimu spouštění rozšíření i jazyka C#, což může být jedna z následujících možností:

Knihovna tříd v procesu
Izolovaný proces

Knihovna tříd v procesu je kompilovaná funkce jazyka C# spuštěná ve stejném procesu jako modul runtime služby Functions.

Rozšíření Dapr podporuje typy parametrů podle následující tabulky.

Vazba	Typy parametrů
Trigger Dapr	daprBindingTrigger daprServiceInvocationTrigger daprTopicTrigger
Vstup Dapr	daprState daprSecret
Výstup Dapr	daprState daprInvoke daprPublish daprBinding

Příklady použití těchto typů najdete v úložišti GitHubu pro rozšíření.