Visual Studio 接続済みサービスを使用して Azure App Configuration を追加する
このチュートリアルでは、Azure App Configuration を使用して Web プロジェクト用の構成と機能フラグを管理するために必要なもののすべてを、Visual Studio で簡単に追加する方法を学習します。 Visual Studio の接続済みサービスの機能を使用することで、Azure 内の App Configuration リソースに接続するために必要なすべてのコード、NuGet パッケージ、構成設定の追加を Visual Studio に自動的に実行させることができます。 この機能を使用するには、Visual Studio 2019 バージョン 16.9 以降を使用している必要があります。
App Configuration の接続済みサービス機能は、次のプロジェクトの種類で使用できます。
- 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 でプロジェクトを開きます。
ソリューション エクスプローラーで [接続済みサービス] ノードを右クリックし、コンテキスト メニューの [接続済みサービスの追加] を選択します。
[接続済みサービス] タブで、 [サービスの依存関係] の [+] アイコンを選択します。
[依存関係の追加] ページで、 [Azure App Configuration] を選択します。
まだサインインしていない場合は、Azure アカウントにサインインします。 Azure アカウントを持っていない場合、無料試用版でサインアップできます。
[Azure App Configuration の構成] 画面で、サブスクリプションと既存の構成ストアを選択します。 次に、[次へ] を選択します。
App Configuration ストアを作成する必要がある場合は、次の手順に進んでください。 それ以外の場合、手順 6. に進みます。
Azure App Configuration ストアを作成する方法は次のとおりです。
App Configuration ストアのヘッダーの右側にある [+] アイコンを選択します。
[Azure App Configuration: 新規作成] ダイアログ ボックスに入力し、[作成] を選択します。 [リソース名] フィールドは一意である必要があることに注意してください。
[Azure App Configuration] ダイアログが表示されると、新しい構成ストアが一覧に表示されます。 この新しいストアを選択し、[次へ] を選択します。
接続文字列名を入力して、接続文字列をローカル シークレット ファイルに保存するか、Azure Key Vault に格納するかを選択します。
[変更の概要] 画面には、プロセスを完了した場合にプロジェクトに対して行われるすべての変更が表示されます。 変更が問題ない場合は、 [完了] を選択します。
依存関係の構成プロセスが完了すると、Azure App Configuration がプロジェクトの [サービスの依存関係] ノードの下に表示されるようになります。
Visual Studio でプロジェクトを開きます。
ソリューション エクスプローラーで [接続済みサービス] ノードを右クリックし、コンテキスト メニューの [追加] を選んで使用できるサービスのメニューを開きます。
[Azure App Configuration] を選びます。 [依存関係に接続する] ページが表示されます。
まだサインインしていない場合は、Azure アカウントにサインインします。 Azure アカウントを持っていない場合、無料試用版でサインアップできます。
[Azure App Configuration の構成] 画面で、サブスクリプションと既存の構成ストアを選択します。 次に、[次へ] を選択します。
App Configuration ストアを作成する必要がある場合は、次の手順に進んでください。 それ以外の場合、手順 6. に進みます。
Azure App Configuration ストアを作成する方法は次のとおりです。
App Configuration ストアのヘッダーの右側にある [+] アイコンを選択します。
[Azure App Configuration: 新規作成] ダイアログ ボックスに入力し、[作成] を選択します。 [リソース名] フィールドは一意である必要があることに注意してください。
[Azure App Configuration] ダイアログが表示されると、新しい構成ストアが一覧に表示されます。 この新しいストアを選択し、[次へ] を選択します。
接続文字列名を入力して、接続文字列をローカル シークレット ファイルに保存するか、Azure Key Vault に格納するかを選択します。
[変更の概要] 画面には、プロセスを完了した場合にプロジェクトに対して行われるすべての変更が表示されます。 変更が問題ない場合は、 [完了] を選択します。
依存関係の構成プロセスが完了すると、Azure App Configuration がプロジェクトの [サービスの依存関係] ノードの下に表示されるようになります。
ソリューション エクスプローラーで、[接続済みサービス] ノードをダブルクリックして [接続済みサービス] タブを開きます。[サービスの依存関係] セクションに接続が表示されます。
![Azure App Configuration の接続を示す [サービスの依存関係] セクションのスクリーンショット。](media/vs-2022/app-configuration-added.png?view=vs-2022)
また、接続文字列のローカル環境への安全な格納をサポートする Secrets.json エントリもあります。 このしくみについては、ASP.NET Core での開発におけるアプリ シークレットの安全な保存を示すスクリーンショットに関する記事をご覧ください。
追加した依存関係の横にある 3 つのドットをクリックすると、ウィザードをもう一度開いて接続を変更するための [接続]、Secrets.json 用、シークレットの管理など、さまざまなオプションが表示されます。 また、ウィンドウの右上にある 3 つのドットをクリックして、ローカルの依存関係の開始や、設定の変更などのオプションを表示することもできます。