Azure Functions 用 Dapr 拡張機能

Azure Functions 用 Dapr 拡張機能は、開発者が Azure Functions と分散アプリケーションランタイム (Dapr) プラットフォームを簡単に統合できる一連のツールとサービスです。

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

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

アクション	通信方向	タイプ
Dapr 入力バインドでのトリガー	N/A	daprBindingTrigger
Dapr サービス呼び出しでのトリガー	N/A	daprServiceInvocationTrigger
Dapr トピックサブスクリプションでのトリガー	N/A	daprTopicTrigger
実行の Dapr 状態をプルする	In	daprState
実行のために Dapr シークレットをプルする	In	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

バンドルのインストール

アプリでこのバインド拡張機能を使用できるようにするには、プロジェクトのルートにある host.json ファイルに次の extensionBundle 参照が含まれていることを確認します。

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

この例では、versionの[4.0.0, 5.0.0)値は、少なくとも4.0.0が5.0.0未満のバンドルバージョン (4.x のすべての潜在的なバージョンを含む) を使用するように Functions ホストに指示します。この表記は、v4.x 拡張機能バンドルの利用可能な最新のマイナーバージョンでアプリを効果的に維持します。

可能であれば、最新の拡張機能バンドルメジャーバージョンを使用し、ランタイムが最新のマイナーバージョンを自動的に維持できるようにする必要があります。最新のバンドルの内容は、拡張機能バンドルのリリースページで確認できます。詳細については、 Azure Functions 拡張機能バンドルに関するページを参照してください。

Dapr の有効化

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

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

IaC テンプレートを使用する場合は、コンテナーアプリリソース定義の properties セクションで次の引数を指定します。

二頭筋
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 構成値は、アプリケーションスコープの変更と見なされます。複数リビジョンモードでコンテナーアプリを実行しても、これらの設定を変更しても新しいリビジョンは作成されません。代わりに、既存のすべてのリビジョンが再起動され、最も up-to-date 値で構成されます。

Azure portal を使用して Dapr を構成する場合は、関数アプリに移動し、左側のメニューから Dapr を選択します。

Azure portal で Function App の Dapr 有効化を見つける場所を示すスクリーンショット。

Dapr ポートとリスナー

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

Important

ポート 3001 は、Dapr トリガーが関数アプリで定義されている場合にのみ公開され、リッスンされます。 Dapr を使用する場合、サイドカーは、インスタンス化を完了する前に、定義されたポートからの応答の受信を待機します。トリガーがない限り、注釈または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 トリガーなどの別のポートとエンドポイントを引き続き公開します。HTTP トリガーはローカルでは既定で 7071 ですが、コンテナーでは既定で 80されます。

バインドの種類

.NET でサポートされるバインディングの種類は、拡張機能のバージョンと C# 実行モードの両方によって異なります。次のいずれかになります。

インプロセスクラスライブラリ
分離プロセス

インプロセスクラスライブラリは、Functions ランタイムと同じプロセスで実行されるコンパイル済みの C# 関数です。

Dapr 拡張機能では、次の表に従ってパラメーターの型がサポートされています。

Binding	パラメーターの型
Dapr トリガー	daprBindingTrigger daprServiceInvocationTrigger daprTopicTrigger
Dapr 入力	daprState daprSecret
Dapr の出力	daprState daprInvoke daprPublish daprBinding

これらの型の使用例については、拡張機能の GitHub リポジトリを参照してください。