Dapr-bővítmény az Azure Functionshez

Cikk
02/06/2024

Fontos

Az Azure Functions Dapr-bővítménye jelenleg előzetes verzióban érhető el, és csak az Azure Container Apps-környezetekben támogatott.

Az Azure Functions Dapr-bővítménye olyan eszközök és szolgáltatások készlete, amelyek lehetővé teszik a fejlesztők számára, hogy könnyen integrálják az Azure Functionst az Elosztott alkalmazás futtatókörnyezeti (Dapr) platformmal.

Az Azure Functions egy eseményvezérelt számítási szolgáltatás, amely triggerek és kötések készletét biztosítja a többi Azure-szolgáltatáshoz való egyszerű kapcsolódáshoz. A Dapr számos építőelemet és ajánlott eljárást kínál az elosztott alkalmazások létrehozásához, beleértve a mikroszolgáltatásokat, az állapotkezelést, a pub/alüzenet-kezelést stb.

A Dapr és a Functions integrációjával olyan függvényeket hozhat létre, amelyek a Dapr vagy külső rendszerek eseményeire reagálnak.

Művelet	Irány	Típus
Eseményindító dapr bemeneti kötésen	n/a	daprBindingTrigger
Eseményindító egy Dapr-szolgáltatáshíváson	n/a	daprServiceInvocationTrigger
Eseményindító Dapr-témakör-előfizetésen	n/a	daprTopicTrigger
Lekérés Dapr állapotban végrehajtáshoz	Ennyi idő múlva:	daprState
Dapr-titkos kulcsok lekérése végrehajtáshoz	Ennyi idő múlva:	daprSecret
Érték mentése Dapr-állapotba	Ki	daprState
Másik Dapr-alkalmazás meghívása	Ki	daprInvoke
Üzenet közzététele Dapr-témakörben	Ki	daprPublish
Érték küldése Dapr kimeneti kötésre	Ki	daprBinding

A bővítmény telepítése

A telepített NuGet-csomag a C# módtól függ a függvényalkalmazásban használt C#-módtól vagy izolált feldolgozói folyamattól:

Folyamatban
Izolált folyamat

Ez a bővítmény a NuGet-csomag 0.17.0-preview01-es verziójának telepítésével érhető el.

A .NET parancssori felületének használata:

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

Adja hozzá a bővítményt a projekthez a NuGet-csomag 0.17.0-preview01-es verziójának telepítésével.

A .NET parancssori felületének használata:

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

Csomag telepítése

Előzetes csomag v4.x

Az előzetes verziójú bővítményt a következő kód hozzáadásával vagy cseréjével adhatja hozzá a host.json fájlhoz:

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

Dapr-engedélyezés

A Dapr konfigurálható különböző [argumentumok és széljegyzetek][dapr-args] használatával a futtatókörnyezet alapján. Az Azure Functionshez készült Dapr két csatornán konfigurálható:

Infrastruktúra kódsablonokként (IaC) a Bicep- vagy az Azure Resource Manager-sablonokhoz hasonlóan
Az Azure Portal

IaC-sablon használatakor adja meg a következő argumentumokat a properties tárolóalkalmazás erőforrásdefiníciójának szakaszában.

Bicep
KAR

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
}

A fenti Dapr-konfigurációs értékek alkalmazáshatókör-módosításoknak minősülnek. Ha több változatú módban futtat egy tárolóalkalmazást, a beállítások módosítása nem hoz létre új változatot. Ehelyett az összes meglévő változat újraindul, hogy a legfrissebb értékekkel legyen konfigurálva.

Ha a Daprt az Azure Portallal konfigurálja, keresse meg a függvényalkalmazást, és válassza a Dapr elemet a bal oldali menüből:

Screenshot demonstrating where to find Dapr enablement for a Function App in the Azure portal.

Dapr-portok és -figyelők

Amikor egy függvényt aktivál a Dapr-ból, a bővítmény automatikusan elérhetővé teszi a portot 3001 , hogy a Dapr oldalkocsiból érkező bejövő kéréseket figyelje.

Fontos

A port 3001 csak akkor lesz közzétéve és figyelve, ha egy Dapr-eseményindító van definiálva a függvényalkalmazásban. A Dapr használatakor az oldalkocsi megvárja, hogy választ kapjon a megadott portról a példányosítás befejezése előtt. Ne definiálja a dapr.io/port széljegyzetet, vagy --app-port ha nincs eseményindítója. Ezzel zárolhatja az alkalmazást a Dapr oldalkocsiról.

Ha csak bemeneti és kimeneti kötéseket használ, a portot 3001 nem kell felfedni vagy definiálni.

Alapértelmezés szerint, amikor az Azure Functions megpróbál kommunikálni a Daprvel, meghívja a Daprt a környezeti változóból DAPR_HTTP_PORTfeloldott porton keresztül. Ha ez a változó null értékű, akkor alapértelmezés szerint a port 3500lesz.

A bemeneti és kimeneti kötések által használt Dapr-címet felülbírálhatja a DaprAddress kötés (vagy az attribútum) tulajdonságának function.json beállításával. Alapértelmezés szerint a következőt használja http://localhost:{DAPR_HTTP_PORT}: .

A függvényalkalmazás továbbra is egy másik portot és végpontot tesz elérhetővé a HTTP-eseményindítókhoz hasonlóan, amelyek helyileg alapértelmezés szerint 7071a tárolóban alapértelmezettek 80.

Kötéstípusok

A .NET-hez támogatott kötéstípusok a bővítményverziótól és a C# végrehajtási módtól is függenek, ami az alábbiak egyike lehet:

Folyamatközi osztálykódtár
Izolált folyamat

A folyamatközi osztálykódtár egy lefordított C# függvény, amely ugyanabban a folyamatban fut, mint a Functions-futtatókörnyezet.

A Dapr-bővítmény az alábbi táblázatnak megfelelően támogatja a paramétertípusokat.

Kötés	Paramétertípusok
Dapr-eseményindító	daprBindingTrigger daprServiceInvocationTrigger daprTopicTrigger
Dapr-bemenet	daprState daprSecret
Dapr-kimenet	daprState daprInvoke daprPublish daprBinding

Az ilyen típusokat használó példákért tekintse meg a bővítmény GitHub-adattárát.