Azure Functions 用の Dapr 拡張機能

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

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

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

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 の有効化

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

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

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

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] を選びます。

Dapr のポートとリスナー

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

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

バインド (または属性) の function.json で DaprAddress プロパティを設定することで、入力と出力のバインドで使われる Dapr アドレスをオーバーライドできます。 既定では、http://localhost:{DAPR_HTTP_PORT} が使われます。

関数アプリには、まだ他にも HTTP トリガーなどのために公開されるポートとエンドポイントがあります。その既定値は、ローカル環境では 7071 ですが、コンテナーでは 80 です。

トラブルシューティング

このセクションでは、Azure Functions 用の Dapr 拡張機能を使用する際に発生する可能性がある問題のトラブルシューティング方法について説明します。

Dapr が環境内で有効なことを確認する

Azure Functions 内で Dapr のバインドとトリガーを使用しており、かつその環境内で Dapr が有効ではない場合、次のエラー メッセージが表示されることがあります。"Dapr sidecar isn't present. Please see (https://aka.ms/azure-functions-dapr-sidecar-missing) for more information."。環境内で Dapr を有効にするには、次を実行します。

• Azure Function が Azure Container Apps 内にデプロイされている場合は、「Azure Functions 用の Dapr 拡張機能」の「Dapr の有効化」手順を参照してください。

• Azure Function が Kubernetes 内にデプロイされている場合は、そのデプロイの YAML 構成に次の注釈があることを確認します。

  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>"
    ...
  

• Azure Function をローカルで実行している場合は、次のコマンドを実行して、Dapr を使用して関数アプリを実行していることを確認します。

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

Dapr 構成内でアプリポートの値を確認する

Azure Functions 用の Dapr 拡張機能は、既定では 3001 ポート上で HTTP サーバーを起動します。 このポートは DAPR_APP_PORT 環境変数を使用して構成できます。

Azure Functions アプリの実行時に正しくないアプリ ポート値を指定すると、次のエラー メッセージが表示されることがあります。"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)."。このエラー メッセージを解決するには、次を実行します。

1. コンテナー アプリの Dapr 設定内で、次を実行します。

   • コード内で Dapr トリガーを使用している場合は、そのアプリ ポートが 3001、または環境変数 DAPR_APP_PORT の値に設定されていることを確認します。

   • コード内で Dapr トリガーを使用していない場合は、アプリ ポートが設定されていないことを確認します。 中には何も入っていないはずです。

2. Dapr 構成内で正しいアプリ ポート値を指定したことを確認します。

   • Azure Container Apps を使用している場合は、Bicep 内でアプリ ポートを指定します。

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

   • Kubernetes 環境を使用している場合は、注釈 dapr.io/app-port を設定します。

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

   • ローカルで開発している場合は、Dapr を使用して関数アプリを実行する際に、--app-port を設定していることを確認します。

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

次のステップ

Dapr の詳細を理解する。