Azure Functions 用の Dapr 拡張機能

[アーティクル]
05/10/2024

Azure Functions 用 Dapr 拡張機能の一連のツールとサービスを使うことで、開発者は Azure Functions と Distributed Application Runtime (Dapr) プラットフォームを簡単に統合できます。

Azure Functions は、他の Azure サービスと簡単に接続するための一連のトリガーとバインドを提供するイベントドリブンのコンピューティングサービスです。 Dapr には、マイクロサービス、状態管理、パブリッシュ/サブスクライブメッセージングなど、分散アプリケーションを構築するための一連の構成要素とベストプラクティスが用意されています。

Dapr と Functions を統合すると、Dapr または外部システムからのイベントに反応する関数を構築できます。

アクション	Direction	Type
Dapr 入力バインドでトリガーする	該当なし	daprBindingTrigger
Dapr サービス呼び出しでトリガーする	該当なし	daprServiceInvocationTrigger
Dapr トピックサブスクリプションでトリガーする	該当なし	daprTopicTrigger
実行に対する Dapr の状態をプルする	含まれる	daprState
実行のために Dapr シークレットをプルする	含まれる	daprSecret
値を Dapr の状態に保存する	Out	daprState
別の Dapr アプリを呼び出す	Out	daprInvoke
Dapr トピックにメッセージを発行する	Out	daprPublish
Dapr 出力バインドに値を送信する	Out	daprBinding

拡張機能のインストール

インストールする拡張機能 NuGet パッケージは、関数アプリで使用している C# モード (インプロセスまたは分離ワーカープロセス) によって異なります。

インプロセス
分離プロセス

この拡張機能は、NuGet パッケージバージョン 1.0.0 をインストールすることで使用できます。

.NET CLI の使用

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

NuGet パッケージバージョン 1.0.0 をインストールして、プロジェクトに拡張機能を追加します。

.NET CLI の使用

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

バンドルのインストール

バンドル v4.x

この拡張機能を追加するには、host.json ファイル内に次のコードを追加するまたは置き換えます。

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

Dapr の有効化

Dapr は、ランタイムコンテキストに基づいてさまざまな[引数と注釈](dapr-args)を使用して構成できます。 2 つのチャネルを使って、Azure Functions 用に Dapr を構成できます。

Bicep や Azure Resource Manager (ARM) のテンプレートのような、コードとしてのインフラストラクチャ (IaC) テンプレート
Azure portal

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 portal を使って Dapr を構成するときは、関数アプリに移動し、左側のメニューから [Dapr] を選びます。

Azure portal 内で Function App の Dapr 有効化がどこにあるかを示すスクリーンショット。

Dapr のポートとリスナー

Dapr から関数をトリガーすると、拡張機能はポート 3001 を自動的に公開して、Dapr サイドカーから着信する要求をリッスンします。

重要

ポート 3001 は、Dapr トリガーが関数アプリで定義されている場合にのみ、公開およびリッスンされます。 Dapr を使うと、サイドカーは、定義されたポートから応答を受信するのを待ってから、インスタンス化を完了します。トリガーがない場合は、dapr.io/port 注釈または --app-port を定義 "しないでください"。それを行うと、Dapr サイドカーからアプリケーションがロックされる可能性があります。

入力と出力のバインドのみを使っている場合は、ポート 3001 を公開または定義する必要はありません。

既定では、Azure Functions は Dapr と通信しようとするとき、環境変数 DAPR_HTTP_PORT から解決されたポートを介して Dapr を呼び出します。その変数が null の場合、ポートは既定で 3500 になります。

バインド (または属性) の function.json で DaprAddress プロパティを設定することで、入力と出力のバインドで使われる 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 リポジトリに関するページを参照してください。