Service Connector と Dapr の組み合わせを使用して、Dapr API を Azure サービスのバッキングに簡単に接続できます。 この機能は、Azure サービスにアクセスするための有効なメタデータと認証済み ID を使用して、ユーザーに代わって Dapr コンポーネントを作成します。
このガイドでは、Dapr 発行およびサブスクライブ (pub/sub) API を Azure Service Bus に接続します。
- API として pub/sub を選択します。
- サービスとして Azure Service Bus を指定し、名前空間、キュー名、ID などの必須プロパティを指定します。
- Azure Service Bus の pub/sub コンポーネントを使用する
前提条件
- アクティブなサブスクリプションが含まれる Azure アカウント。 無料の Azure アカウントを作成してください。
- 既存の Azure Container App。
Dapr コンポーネントを作成する
まず、Dapr コンポーネント作成機能に移動します。
Azure portal で、Container Apps インスタンスに移動します。
サイドバー メニューの [設定] で、 Dapr コンポーネントを選択します。
[+ 追加>Azure コンポーネントを選択して、Dapr コンポーネントの追加構成ウィンドウを開きます。
![ドロップダウン メニューから [Azure コンポーネント] を選択したスクリーンショット。](media/dapr-component-connection/select-azure-component.png)
注意
現在、Azure portal でサービス コネクタを使用する Dapr コンポーネントの作成はプレビュー段階であり、Azure サービス (Azure Service Bus、Azure Cosmos DB など) でのみ機能します。 Azure Dapr 以外のコンポーネント (Redis) を作成するには、手動コンポーネント作成オプションを使用します。
必須のメタデータを指定する
コンポーネント作成ツールを必須のコンポーネント メタデータにマップするには、[基本] タブの定義済みドロップダウンから必須メタデータを指定する必要があります。
たとえば、pub/sub Azure Service Bus コンポーネントの場合は、次のフィールドから始めます。
| フィールド | 例 | 説明 |
|---|---|---|
| コンポーネント名 | mycomponent |
Dapr コンポーネントの名前を入力します。 名前は、アプリケーション コードで参照されているコンポーネントと一致している必要があります。 |
| 構成要素 | Pub/sub | ドロップダウンからコンポーネントの構成要素/API を選択します。 |
| コンポーネント タイプ | Service Bus | ドロップダウンからコンポーネントの種類を選択します。 |
コンポーネント作成ペインには、選択した構成要素とコンポーネントの種類に応じて、異なるフィールドが設定されます。 たとえば、次の表と図は、Azure Service Bus の pub/sub コンポーネントの種類に関連付けられているフィールドを示していますが、表示されるフィールドは異なる場合があります。
| フィールド | 例 | 説明 |
|---|---|---|
| サブスクリプション | 自分のサブスクリプション | Azure のサブスクリプションを選択します。 |
| 名前空間 | mynamespace |
Service Bus 名前空間を選択します。 |
| 認証 | ユーザーが割り当てたマネージド ID | 探しているコンポーネントを含むサブスクリプションを選択します。 推奨: ユーザーが割り当てたマネージド ID。 |
| ユーザー割り当てマネージド ID | testidentity |
ドロップダウンから既存の ID を選択します。 まだお持ちでない場合は、新しいマネージド ID クライアント ID を作成できます。 |
![Dapr Pub/sub コンポーネントを追加する [基本] タブを示す Azure プラットフォームのスクリーンショット。](media/dapr-component-connection/add-pubsub-component.png#lightbox)
何が起きたのか?
これらの必須フィールドに入力すると、必須コンポーネントのメタデータに自動的にマップされます。 この Service Bus の例では、必須メタデータのみが接続文字列です。 コンポーネント作成ツールでは、指定された情報を取得し、入力をマップしてコンポーネント YAML ファイルに接続文字列を作成します。
省略可能なメタデータを指定する
コンポーネント作成ツールによって、コンポーネントに必須のすべてのメタデータが自動的に設定されますが、ユーザーが省略可能なメタデータを追加してコンポーネントをカスタマイズすることもできます。
[次へ: メタデータとスコープ] を選択します。
[ メタデータ] で [ 追加 ] を選択し、サポートされているフィールドのドロップダウンから Dapr コンポーネントの追加の省略可能なメタデータを選択します。
[スコープ] で、[追加] を選択するか、このコンポーネントを読み込むコンテナー アプリのアプリ ID を入力します。 既定では、スコープが指定されていない場合、Dapr によってすべてのアプリ ID にコンポーネントが適用されます。
[確認と作成] を選択し、コンポーネントの値を確認します。
[作成] を選択します。
コンポーネント YAML を保存する
コンポーネントが Container Apps 環境に追加されると、ポータルにコンポーネントの YAML (または Bicep) が表示されます。
今後使用するために、YAML ファイルをコピーして保存します。
[完了] を選択して、構成ペインを終了します。
その後、YAML/Bicep 成果物をリポジトリにチェックインし、ポータル エクスペリエンスの外部で再作成できます。
注意
マネージド ID を使用する場合、選択した ID は、範囲内のすべてのコンテナー アプリとターゲット サービスに割り当てられます。
Dapr コンポーネントを管理する
Container Apps 環境で、[設定]>[Dapr コンポーネント] の順に移動します。
このページには、Container Apps 環境に関連付けられている Dapr コンポーネントが一覧表示されます。 リストを確認し、[削除] アイコンを選択してコンポーネントを削除するか、コンポーネントの名前を選んでその詳細を確認または編集します。
