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

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.

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

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

{
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle",
    "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.

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:

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.

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.

Hibaelhárítás

Ez a szakasz azt ismerteti, hogyan háríthatja el az Azure Functions Dapr-bővítményének használatakor felmerülő problémákat.

Győződjön meg arról, hogy a Dapr engedélyezve van a környezetben

Ha Dapr-kötéseket és -triggereket használ az Azure Functionsben, és a Dapr nincs engedélyezve a környezetben, a következő hibaüzenet jelenhet meg: Dapr sidecar isn't present. Please see (https://aka.ms/azure-functions-dapr-sidecar-missing) for more information. A Dapr engedélyezése a környezetben:

• Ha az Azure-függvény az Azure Container Appsben van üzembe helyezve, tekintse meg az Azure Functions Dapr-bővítményének Dapr-engedélyezési utasításait.

• Ha az Azure-függvény telepítve van a Kubernetesben, ellenőrizze, hogy az üzembe helyezés YAML-konfigurációja a következő megjegyzésekkel rendelkezik-e:

  annotations:
    ...
    dapr.io/enabled: "true"
    dapr.io/app-id: "functionapp"
    # You should only set app-port if you are using a Dapr trigger in your code.
    dapr.io/app-port: "<DAPR_APP_PORT>"
    ...
  

• Ha helyileg futtatja az Azure-függvényt, futtassa a következő parancsot annak ellenőrzéséhez, hogy a függvényalkalmazást a Daprrel futtatja-e:

  dapr run --app-id functionapp --app-port <DAPR_APP_PORT>  --components-path <COMPONENTS_PATH> -- func host start 
  

Alkalmazásport értékének ellenőrzése a Dapr-konfigurációban

Az Azure Functions Dapr-bővítménye alapértelmezés szerint elindít egy HTTP-kiszolgálót a porton 3001 . Ezt a portot a DAPR_APP_PORT környezeti változóval konfigurálhatja.

Ha helytelen alkalmazásportértéket ad meg egy Azure Functions-alkalmazás futtatásakor, a következő hibaüzenet jelenhet meg: The Dapr sidecar is configured to listen on port {portInt}, but the app server is running on port {appPort}. This may cause unexpected behavior. For more information, visit [this link](https://aka.ms/azfunc-dapr-app-config-error). A hibaüzenet megoldása:

1. A tárolóalkalmazás Dapr-beállításaiban:

   • Ha Dapr-eseményindítót használ a kódban, ellenőrizze, hogy az alkalmazásport a környezeti változó értékére vagy értékére DAPR_APP_PORT van-e állítva3001.

   • Ha nem használ Dapr-eseményindítót a kódban, ellenőrizze, hogy nincs-e beállítva az alkalmazásport. Ez most még üres.

2. Ellenőrizze, hogy a Dapr-konfigurációban a megfelelő alkalmazásport-értéket adja-e meg.

   • Az Azure Container Apps használata esetén adja meg az alkalmazásportot a Bicepben:

     DaprConfig: {
        ...
        appPort: <DAPR_APP_PORT>
        ...
     }
     

   • Ha Kubernetes-környezetet használ, állítsa be a dapr.io/app-port megjegyzést:

     annotations:
        ...
        dapr.io/app-port: "<DAPR_APP_PORT>"
        ...
     

   • Ha helyi fejlesztést végzett, ellenőrizze, hogy a függvényalkalmazás Dapr-beli futtatásakor be van-e állítva --app-port :

     dapr run --app-id functionapp --app-port <DAPR_APP_PORT> --components-path <COMPONENTS_PATH> -- func host start 
     

Következő lépések

További információ a Daprről.