適用於 Azure Functions 的 Dapr 擴充功能

發行項
02/06/2024

重要

適用於 Azure Functions 的 Dapr 擴充功能目前處於預覽狀態，且僅在 Azure Container Apps 環境中支援。

適用於 Azure Functions 的 Dapr 擴充功能是一組工具和服務，可讓開發人員輕鬆地整合 Azure Functions 與分散式應用程式運行時間（Dapr）平臺。

Azure Functions 是事件驅動計算服務，可提供一組觸發程式和系結，以輕鬆地與其他 Azure 服務連線。 Dapr 提供一組建置組塊和建置分散式應用程式的最佳做法，包括微服務、狀態管理、發佈/子傳訊等等。

透過 Dapr 與 Functions 之間的整合，您可以建置函式，以回應來自 Dapr 或外部系統的事件。

動作	方向	類型
Dapr 輸入系結上的觸發程式	N/A	daprBindingTrigger
在 Dapr 服務調用上觸發	N/A	daprServiceInvocationTrigger
Dapr 主題訂用帳戶上的觸發程式	N/A	daprTopicTrigger
提取 Dapr 狀態以執行	In	daprState
提取 Dapr 秘密以執行	In	daprSecret
將值儲存至 Dapr 狀態	外	daprState
叫用另一個 Dapr 應用程式	外	daprInvoke
將訊息發佈至 Dapr 主題	外	daprPublish
將值傳送至 Dapr 輸出系結	外	daprBinding

安裝擴充功能

您安裝的延伸模組 NuGet 套件取決於您在函式應用程式中所使用的 C# 模式或隔離背景工作行程：

內含式
隔離進程

此延伸模組可透過安裝 NuGet 套件 0.17.0-preview01 版來取得。

使用 .NET CLI：

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

藉由安裝 NuGet 套件 0.17.0-preview01 版，將擴充功能新增至您的專案。

使用 .NET CLI：

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

安裝套件組合

預覽套件組合 v4.x

您可以在檔案 host.json 中新增或取代下列程式代碼，以新增預覽延伸模組：

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

Dapr 啟動

您可以使用各種 [自變數和註釋][dapr-args] 根據運行時間內容來設定 Dapr。您可以透過兩個通道來設定 Azure Functions 的 Dapr：

基礎結構即程式碼 (IaC) 範本，如 Bicep 或 Azure Resource Manager(ARM) 範本所示
Azure 入口網站

使用 IaC 範本時，請在容器應用程式資源定義的區段中指定下列自變數 properties 。

Bicep
ARM

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
}

上述 Dapr 組態值會被視為應用程式範圍變更。當您以多重修訂模式執行容器應用程式時，這些設定的變更將不會建立新的修訂。相反地，所有現有的修訂都會重新啟動，以確保它們已設定為最新的值。

使用 Azure 入口網站設定 Dapr 時，流覽至您的函式應用程式，然後從左側功能表中選取 [Dapr]：

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

Dapr 埠和接聽程式

當您從 Dapr 觸發函式時，擴充功能會自動公開埠 3001 以接聽來自 Dapr Sidecar 的傳入要求。

重要

只有在函式應用程式中定義 Dapr 觸發程式時，才會公開和接聽埠 3001 。使用 Dapr 時，Sidecar 會先等候接收來自已定義埠的回應，再完成具現化。 除非您有觸發程式，dapr.io/port否則--app-port請勿定義批注。這樣做可能會從 Dapr 側車鎖定您的應用程式。

如果您只使用輸入和輸出系結，則不需要公開或定義埠 3001 。

根據預設，當 Azure Functions 嘗試與 Dapr 通訊時，它會透過從環境變數 DAPR_HTTP_PORT解析的埠呼叫 Dapr。如果該變數為 null，它會預設為連接埠 3500。

您可以在中設定 DaprAddress 系結的屬性 function.json ，以覆寫輸入和輸出系結所使用的 Dapr 位址（或屬性）。根據預設，它會使用 http://localhost:{DAPR_HTTP_PORT}。

函式應用程式仍然會公開另一個埠和端點，例如 HTTP 觸發程式，其本機預設為 7071，但在容器中，預設為 80。

系結類型

.NET 支援的系結類型取決於延伸模組版本和 C# 執行模式，這可以是下列其中一項：

進程內類別庫
隔離進程

同進程類別庫是在與 Functions 執行時間相同的進程中執行的已編譯 C# 函式。

Dapr 擴充功能支援下表的參數類型。

繫結	參數型別
Dapr 觸發程式	daprBindingTrigger daprServiceInvocationTrigger daprTopicTrigger
Dapr 輸入	daprState daprSecret
Dapr 輸出	daprState daprInvoke daprPublish daprBinding

如需使用這些類型的範例，請參閱延伸模組的 GitHub 存放庫。