Visual Studio 接続済みサービスを使用した Azure App Configuration の追加

[アーティクル]
01/31/2025

このチュートリアルでは、Visual Studio で Web プロジェクトの構成と機能フラグを管理するために Azure App Configuration の使用を開始するために必要なものをすべて簡単に追加する方法について説明します。 Visual Studio で接続済みサービス機能を使用すると、Azure の App Configuration リソースに接続するために必要なすべてのコード、NuGet パッケージ、構成設定を Visual Studio に自動的に追加させることができます。この機能を使用するには、Visual Studio 2019 バージョン 16.9 以降を使用している必要があります。

App Configuration Connected Services 機能は、次のプロジェクトの種類で使用できます。

ASP.NET Core
.NET Core コンソール
.NET Framework プロジェクト。

前提条件

Azure 開発 ワークロードがインストールされている Visual Studio ([Visual Studio のダウンロード] (https://visualstudio.microsoft.com/downloads/?cid=learn-onpage-download-cta) を参照)。
サポートされている種類の 1 つのプロジェクト
Azure アカウント。 Azure アカウントがない場合は、Visual Studio サブスクライバー向けの Azure の特典を有効にするか、無料試用版にサインアップします。

接続済みサービスを使用して Azure App Configuration に接続する

Visual Studio でプロジェクトを開きます。
ソリューションエクスプローラーで、接続済みサービス ノード 右クリックし、コンテキストメニューから [接続済みサービス追加] を選択します。

$[Add Azure connected service]$Azure 接続済みサービスの追加$ 画面を示すスクリーンショット。$
[接続済みサービス ] タブで、[サービスの依存関係 ] の [+] アイコンを選択します。
[依存関係の追加] ページで、[Azure App Configuration] を選択します。

まだサインインしていない場合は、Azure アカウントにサインインします。 Azure アカウントをお持ちでない場合は、無料試用版にサインアップできます。
Azure App Configuration の構成画面で、サブスクリプションと既存の構成ストアを選択します。次を選択します。

App Configuration ストアを作成する必要がある場合は、次の手順に進みます。それ以外の場合は、手順 6 に進みます。

$[Add existing configuration account to project]$既存の構成アカウントをプロジェクトに追加する$ 画面を示すスクリーンショット。$
アプリ構成ストアを作成するには:
1. App Configuration ストアのヘッダーの右側にある [+] アイコンを選択します。
2. [Azure App Configuration: 新規作成] ダイアログボックスに入力し、[作成] を選択します。 [リソース名] フィールドは一意である必要があることに注意してください。
3. Azure App Configuration ダイアログが表示されると、新しい構成ストアが一覧に表示されます。この新しいストアを選択して、次に[次へ]を選択します。
接続文字列の名前を入力し、接続文字列をローカルシークレットファイルに格納するか、Azure Key Vault 保存するかを選択します。
変更の概要 画面には、プロセスを完了した場合にプロジェクトに加えられるすべての変更が表示されます。変更が [OK] に見える場合は、[完了 ] を選択します。
依存関係の構成プロセス が完了すると、Azure App Configuration がプロジェクトの サービス依存関係 ノードの下に表示されるようになりました。

Visual Studio でプロジェクトを開きます。
ソリューションエクスプローラーで、接続済みサービス ノード 右クリックし、コンテキストメニューから [の追加] 選択して、使用可能なサービスのメニューを開きます。
[Azure App Configuration] を選びます。 [依存関係に接続する] ページが表示されます。

まだサインインしていない場合は、Azure アカウントにサインインします。 Azure アカウントをお持ちでない場合は、無料試用版にサインアップできます。
Azure App Configuration の構成画面で、サブスクリプションと既存の構成ストアを選択します。次を選択します。

App Configuration ストアを作成する必要がある場合は、次の手順に進みます。それ以外の場合は、手順 6 に進みます。

$[Add existing configuration account to project]$既存の構成アカウントをプロジェクトに追加する$ を示すスクリーンショット。$
アプリ構成ストアを作成するには:
1. App Configuration ストアのヘッダーの右側にある [+] アイコンを選択します。
2. [Azure App Configuration: 新規作成] ダイアログボックスに入力し、[作成] を選択します。 [リソース名] フィールドは一意である必要があることに注意してください。
3. Azure App Configuration ダイアログが表示されると、新しい構成ストアが一覧に表示されます。この新しいストアを選択し、次に次へを選択します。
接続文字列の名前を入力し、接続文字列をローカルシークレットファイルに格納するか、Azure Key Vault 保存するかを選択します。
変更の概要 画面には、プロセスを完了した場合にプロジェクトに加えられるすべての変更が表示されます。変更が [OK] に見える場合は、[完了 ] を選択します。

依存関係の構成プロセス が完了すると、Azure App Configuration がプロジェクトの サービス依存関係 ノードの下に表示されるようになりました。
ソリューションエクスプローラーで、接続済みサービス ノードをダブルクリックして、[接続済みサービスの ] タブ 開きます。サービス依存関係の セクションに接続が表示されます。

また、接続文字列のセキュリティで保護されたストレージをローカルでサポートする Secrets.json エントリもあります。 ASP.NET Core での開発中のアプリシークレットの安全なストレージを示すスクリーンショットで、このしくみについて説明します。

追加した依存関係の横にある 3 つのドットをクリックすると、Connect を使用してウィザードを再度開いて接続を変更したり、Secrets.jsonの場合はシークレットを管理するオプションなど、さまざまなオプションを確認できます。また、ウィンドウの右上にある 3 つのドットをクリックして、ローカルの依存関係を開始したり、設定を変更したりするためのオプションを表示することもできます。