クイック スタート: App Configuration を使用して .NET アプリを作成する

  • [アーティクル]

このクイック スタートでは、コードとは別にアプリケーション設定のストレージと管理を一元化するために、Azure App Configuration を .NET コンソール アプリに組み込みます。

前提条件

キーと値を追加する

App Configuration ストアに次のキーと値を追加し、[ラベル] と [コンテンツのタイプ] を既定値のままにします。 Azure portal または CLI を使用してストアにキーと値を追加する方法の詳細については、キーと値の作成に関する記事を参照してください。

キー 値
TestApp:Settings:Message Azure App Configuration からのデータ

.NET コンソール アプリを作成する

.NET コマンド ライン インターフェイス (CLI) を使用し、新しい .NET コンソール アプリ プロジェクトを作成できます。 Visual Studio ではなく .NET CLI を使用する利点は、Windows、macOS、および Linux プラットフォームで使用できることです。 代わりに、Azure Cloud Shell で提供されているプレインストールのツールを使用します。

  1. プロジェクト用の新規フォルダーを作成します。

  2. 新しいフォルダーで次のコマンドを実行して、新しい .NET コンソール アプリ プロジェクトを作成します。

    dotnet new console

App Configuration ストアに接続する

  1. 次のコマンドを実行して、Microsoft.Extensions.Configuration.AzureAppConfiguration NuGet パッケージへの参照を追加します。

    dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration

  2. 次のコマンドを実行して、プロジェクトのパッケージを復元します。

    dotnet restore

  3. Program.cs を開き、次のステートメントを追加します。

    using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.Configuration.AzureAppConfiguration;

  4. Program.cs ファイルで AddAzureAppConfiguration メソッドを呼び出して App Configuration を使用します。

    var builder = new ConfigurationBuilder();
builder.AddAzureAppConfiguration(Environment.GetEnvironmentVariable("ConnectionString"));

var config = builder.Build();
Console.WriteLine(config["TestApp:Settings:Message"] ?? "Hello world!");

アプリをビルドしてローカルで実行する

  1. ConnectionString という名前の環境変数に、App Configuration ストアへのアクセス キーを設定します。 コマンド ラインで次のコマンドを実行します。

    Windows コマンド プロンプトを使用してアプリをローカルでビルドして実行するには、次のコマンドを実行します。

    setx ConnectionString "connection-string-of-your-app-configuration-store"

    変更を有効にするために、コマンド プロンプトを再起動します。 環境変数の値を出力して、正しく設定されていることを確認します。

  2. 次のコマンドを実行して、コンソール アプリをビルドします。

    dotnet build

  3. ビルドが正常に完了したら、次のコマンドを実行して、アプリをローカルで実行します。

    dotnet run

リソースをクリーンアップする

この記事で作成したリソースを継続して使用しない場合は、ここで作成したリソース グループを削除して課金されないようにしてください。

重要

リソース グループを削除すると、元に戻すことができません。 リソース グループとそのすべてのリソースは完全に削除されます。 間違ったリソース グループやリソースをうっかり削除しないようにしてください。 この記事のリソースを、保持したい他のリソースを含むリソース グループ内に作成した場合は、リソース グループを削除する代わりに、各リソースをそれぞれのペインから個別に削除します。

  1. Azure portal にサインインし、 [リソース グループ] を選択します。
  2. [名前でフィルター] ボックスにリソース グループの名前を入力します。
  3. 結果一覧でリソース グループ名を選択し、概要を表示します。
  4. [リソース グループの削除] を選択します。
  5. リソース グループの削除の確認を求めるメッセージが表示されます。 確認のためにリソース グループの名前を入力し、 [削除] を選択します。

しばらくすると、リソース グループとそのすべてのリソースが削除されます。

次のステップ

このクイックスタートでは、新しい App Configuration ストアを作成して、App Configuration プロバイダーから .NET コンソール アプリと共に使用しました。 構成設定を動的に更新するように .NET アプリを構成する方法については、次のチュートリアルに進んでください。

動的な構成を有効にする