既存のコンテナー アプリで Dapr を有効にする
Dapr は、ランタイム コンテキストに基づいてさまざまな引数と注釈を使用して構成できます。 Azure Container Apps には、Dapr を有効にできる以下の 3 つのチャネルが用意されています。
- Azure CLI
- Bicep や Azure Resource Manager (ARM) テンプレートなどのコードとしてのインフラストラクチャ (IaC) テンプレート
- Azure ポータル
次の表は、現在サポートされている 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 構成値は、アプリケーション スコープの変更と見なされます。 複数リビジョン モードでコンテナー アプリを実行すると、これらの設定を変更しても新しいリビジョンは作成されません。 代わりに、既存のすべてのリビジョンが再起動されて、最新の値で確実に構成されます。
Azure Portal の使用
コンテナー アプリのポータル ビューを介して Dapr を有効にすることもできます。
Note
開始する前に、独自の Dapr コンポーネントの作成が既に完了していることを確認します。 ポータルのコンテナー アプリ環境を介して Dapr コンポーネントを接続できます。
Azure portal でコンテナー アプリに移動し、左側のメニューの [設定] で [Dapr] を選択します。
既定では、Dapr は無効になっています。 [有効] を選択して Dapr 設定を展開します。
コンポーネントのアプリ ID を入力し、適切な見出しを選択します。 該当する場合は、[コンポーネント] ヘッダーの下でリンクを選択して Dapr コンポーネントをコンテナー アプリ環境に追加して管理します。