Share via


コンテナー アプリで Dapr を有効にする

Dapr は、ランタイム コンテキストに基づいてさまざまな引数と注釈を使用して構成できます。 Azure Container Apps には、Dapr を有効にできる以下の 3 つのチャネルが用意されています。

次の表は、現在サポートされている Azure Container Apps で Dapr を有効にするための Dapr サイドカー構成の一覧を示しています。

Container Apps CLI [テンプレート] フィールド 説明
--enable-dapr dapr.enabled コンテナー アプリで Dapr を有効にします。
--dapr-app-port dapr.appPort アプリケーションと通信するために Dapr によって使われる、アプリケーションがリッスンしているポート
--dapr-app-protocol dapr.appProtocol アプリケーションで使用しているプロトコルを Dapr に伝えます。 有効なオプションは http または grpc です。 既定値は http です。
--dapr-app-id dapr.appId サービス検出、状態のカプセル化、および pub/sub コンシューマー ID に使用される、コンテナー アプリに対する一意の Dapr 識別子。
--dapr-max-request-size dapr.httpMaxRequestSize 大きなファイルのアップロードを処理する要求本文の http サーバーと grpc サーバーの最大サイズを設定します。 既定値は 4 MB です。
--dapr-read-buffer-size dapr.httpReadBufferSize マルチ KB ヘッダーの送信時に処理する HTTP ヘッダー読み取りバッファーの最大サイズを設定します。 既定値は 4 KB です。
--dapr-api-logging dapr.enableApiLogging アプリケーションから Dapr サイドカーへの API 呼び出しを表示できるようにします。
--dapr-log-level dapr.logLevel Dapr サイドカーのログ レベルを設定します。 使用できる値は、debug、error、info、warn です。 既定値は info です。

CLI を使用する

Azure CLI を使用して、コンテナー アプリで Dapr を有効にできます。

az containerapp dapr enable

詳細と例については、リファレンス ドキュメントを参照してください。

Bicep または ARM の使用

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

 dapr: {
   enabled: true
   appId: 'nodeapp'
   appProtocol: 'http'
   appPort: 3000
 }

上記の Dapr 構成値は、アプリケーション スコープの変更と見なされます。 複数リビジョン モードでコンテナー アプリを実行すると、これらの設定を変更しても新しいリビジョンは作成されません。 代わりに、既存のすべてのリビジョンが再起動されて、最新の値で確実に構成されます。

Azure Portal の使用

コンテナー アプリのポータル ビューを介して Dapr を有効にすることもできます。

Note

開始する前に、独自の Dapr コンポーネントの作成が既に完了していることを確認します。 ポータルのコンテナー アプリ環境を介して Dapr コンポーネントを接続できます。

Azure portal でコンテナー アプリに移動し、左側のメニューの [設定][Dapr] を選択します。

Screenshot showing where to enable Dapr in your container app via the Azure portal view.

既定では、Dapr は無効になっています。 [有効] を選択して Dapr 設定を展開します。

Screenshot of Dapr being disabled by default and where to click to enable it.

コンポーネントのアプリ ID を入力し、適切な見出しを選択します。 該当する場合は、[コンポーネント] ヘッダーの下でリンクを選択して Dapr コンポーネントをコンテナー アプリ環境に追加して管理します。

Screenshot showing some basic settings for enabling Dapr on the container app.

次のステップ

以下のいずれかのチュートリアルを使用して、Dapr と Azure Container Apps を使用してみてください。