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 プロジェクト。

Note

このトピックは、Windows 上の Visual Studio に適用されます。 Visual Studio for Mac については、Visual Studio for Mac での接続済みサービスに関するページを参照してください。

必須コンポーネント

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

  1. Visual Studio でプロジェクトを開きます。

  2. ソリューション エクスプローラー[接続済みサービス] ノードを右クリックし、コンテキスト メニューの [接続済みサービスの追加] を選択します。

    Screenshot showing

  3. [接続済みサービス] タブで、 [サービスの依存関係] の [+] アイコンを選択します。

    Screenshot showing

  4. [依存関係の追加] ページで、[Azure App Configuration] を選択します。

    Screenshot showing

    まだサインインしていない場合は、Azure アカウントにサインインします。 Azure アカウントを持っていない場合、無料試用版でサインアップできます。

  5. [Azure App Configuration の構成] 画面で、サブスクリプションと既存の構成ストアを選択します。 次に、[次へ] を選択します。

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

    Screenshot showing

  6. Azure App Configuration ストアを作成する方法は次のとおりです。

    1. App Configuration ストアのヘッダーの右側にある [+] アイコンを選択します。

    2. [Azure App Configuration: 新規作成] ダイアログ ボックスに入力し、[作成] を選択します。 [リソース名] フィールドは一意である必要があることに注意してください。

      Screenshot showing New Azure app config store.

    3. [Azure App Configuration] ダイアログが表示されると、新しい構成ストアが一覧に表示されます。 この新しいストアを選択し、[次へ] を選択します。

  7. 接続文字列名を入力し、接続文字列をローカル シークレット ファイルと Azure Key Vault のどちらに保存するかを選択します。

    Screenshot showing

  8. [変更の概要] 画面には、プロセスを完了した場合にプロジェクトに対して行われるすべての変更が表示されます。 変更が問題ない場合は、 [完了] を選択します。

    Screenshot showing summary of changes.

  9. 依存関係の構成プロセスが完了すると、Azure App Configuration がプロジェクトの [サービスの依存関係] ノードの下に表示されるようになります。

  1. Visual Studio でプロジェクトを開きます。

  2. ソリューション エクスプローラー[接続済みサービス] ノードを右クリックし、コンテキスト メニューの [追加] を選んで使用できるサービスのメニューを開きます。

    Screenshot showing Connected Services context menu options.

  3. [Azure App Configuration] を選びます。 [依存関係に接続する] ページが表示されます。

    Screenshot showing Connect to dependency for Azure App Configuration.

    まだサインインしていない場合は、Azure アカウントにサインインします。 Azure アカウントを持っていない場合、無料試用版でサインアップできます。

  4. [Azure App Configuration の構成] 画面で、サブスクリプションと既存の構成ストアを選択します。 次に、[次へ] を選択します。

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

    Screenshot showing 'Add existing configuration account to project

  5. Azure App Configuration ストアを作成する方法は次のとおりです。

    1. App Configuration ストアのヘッダーの右側にある [+] アイコンを選択します。

    2. [Azure App Configuration: 新規作成] ダイアログ ボックスに入力し、[作成] を選択します。 [リソース名] フィールドは一意である必要があることに注意してください。

      Screenshot showing new Azure app config store.

    3. [Azure App Configuration] ダイアログが表示されると、新しい構成ストアが一覧に表示されます。 この新しいストアを選択し、[次へ] を選択します。

  6. 接続文字列名を入力し、接続文字列をローカル シークレット ファイルと Azure Key Vault のどちらに保存するかを選択します。

    Screenshot showing

  7. [変更の概要] 画面には、プロセスを完了した場合にプロジェクトに対して行われるすべての変更が表示されます。 変更が問題ない場合は、 [完了] を選択します。

    Screenshot showing summary of changes.

    依存関係の構成プロセスが完了すると、Azure App Configuration がプロジェクトの [サービスの依存関係] ノードの下に表示されるようになります。

  8. ソリューション エクスプローラー で、[接続済みサービス] ノードを ダブルクリックして、[接続済みサービス] タブを 開きます。サービス依存関係 セクションに接続が表示されます:

    Screenshot of Service Dependencies section showing Azure App Configuration connection.

    また、接続文字列のローカル環境への安全な格納をサポートする Secrets.json エントリもあります。 このしくみについては、ASP.NET Core での開発におけるアプリ シークレットの安全な保存を示すスクリーンショットに関する記事をご覧ください。

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