次の方法で共有


Azure portal の Dapr コンポーネントを使用して Azure サービスに接続する

Service ConnectorDapr を組み合わせて使用することで、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 コンポーネントを使用する

前提条件

Dapr コンポーネントを作成する

まず、Dapr コンポーネント作成機能に移動します。

  1. Azure portal で、Container Apps インスタンスに移動します。

  2. 左側のメニューの [設定] で、[Dapr コンポーネント] を選択します。

  3. 上部のメニューから、[追加]>[Azure コンポーネント] を選択して、[Dapr コンポーネントの追加] 構成ペインを開きます。

    Screenshot of selecting Azure Component from the drop down menu.

    Note

    現在、Azure portal での Service Connector を使用した 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 コンポーネントの種類に関連付けられているフィールドを示していますが、表示されるフィールドは異なる場合があります。

フィールド 説明
サブスクリプション My subscription Azure サブスクリプションを選択します。
名前空間 mynamespace Service Bus 名前空間を選択します
認証 ユーザー割り当てマネージド ID 探しているコンポーネントを含むサブスクリプションを選択します。 推奨: ユーザー割り当てマネージド ID。
ユーザー割り当てマネージド ID testidentity ドロップダウンから既存の ID を選択します。 まだお持ちでない場合は、新しいマネージド ID クライアント ID を作成できます。

Screenshot of the Azure platform showing the Basics tab of adding a Dapr Pub/sub component.

何が起きたのか?

これらの必須フィールドに入力したので、必須コンポーネント メタデータに自動的にマップされます。 この Service Bus の例では、必須メタデータのみが接続文字列です。 コンポーネント作成ツールでは、指定された情報を取得し、入力をマップしてコンポーネント YAML ファイルに接続文字列を作成します。

省略可能なメタデータを指定する

コンポーネント作成ツールによって、コンポーネントに必須のすべてのメタデータが自動的に設定されますが、ユーザーが省略可能なメタデータを追加してコンポーネントをカスタマイズすることもできます。

  1. [次へ: メタデータとスコープ] を選択します。

  2. [メタデータ] で、[追加] を選択し、サポートされているフィールドのドロップダウンから Dapr コンポーネントの追加の省略可能なメタデータを選びます。

  3. [スコープ] で、[追加] を選択するか、このコンポーネントを読み込むコンテナー アプリのアプリ ID を入力します。

    • 既定では、スコープが指定されていない場合、Dapr によってすべてのアプリ ID にコンポーネントが適用されます。
  4. [確認と作成] を選択し、コンポーネントの値を確認します。

  5. [作成] を選択します。

コンポーネント YAML を保存する

コンポーネントが Container Apps 環境に追加されると、ポータルにコンポーネントの YAML (または Bicep) が表示されます。

  1. 今後使用するために、YAML ファイルをコピーして保存します。

  2. [完了] を選択して、構成ペインを終了します。

その後、YAML/Bicep 成果物をリポジトリにチェックインし、ポータル エクスペリエンスの外部で再作成できます。

Note

マネージド ID を使用する場合、選択した ID は、範囲内のすべてのコンテナー アプリとターゲット サービスに割り当てられます。

Dapr コンポーネントを管理する

  1. Container Apps 環境で、[設定]>[Dapr コンポーネント] の順に移動します。

  2. このページには、Container Apps 環境に関連付けられている Dapr コンポーネントが一覧表示されます。 リストを確認し、[削除] アイコンを選択してコンポーネントを削除するか、コンポーネントの名前を選んでその詳細を確認または編集します。

    Screenshot of the Azure platform showing existing Dapr Components.

次のステップ

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

各項目の詳細情報