Azure App Configuration エミュレーターの概要

Azure App Configuration エミュレーターは、Azure App Configuration サービスの軽量実装を提供するローカル開発ツールです。 このエミュレーターを使用すると、開発者は、アクティブな Azure サブスクリプションやクラウド サービスへの接続を必要とせずに、アプリケーションをローカルでテストおよび開発できます。

Azure App Configuration エミュレーターはオープン ソースです。 詳細については、 GitHub リポジトリを参照してください。

機能の概要

次の表に、最新の Azure App Configuration エミュレーターでサポートされている機能を示します。

特徴 ステータス
ウェブユーザーインターフェース 在庫有り
匿名認証 在庫有り
HMAC 認証 在庫有り
.NET アスパイア統合 在庫有り
API ステータス
/keys 在庫有り
/kv 在庫有り
/labels 在庫有り
/locks 在庫有り
/revisions 在庫有り
/snapshots 在庫有り

エミュレーターをインストールする

次のコンソール コマンドを使用して、 Docker を使用して最新の App Configuration エミュレーター イメージ をプルします。

docker pull mcr.microsoft.com/azure-app-configuration/app-configuration-emulator:1.2.0

エミュレーターを実行する

次のコマンドは、App Configuration エミュレーターの Docker イメージを実行します。 -p 8483:8483 パラメーターは、ホスト マシンのポート 8483 から Docker インスタンスに要求をリダイレクトします。 -e Tenant:AnonymousAuthEnabled=trueパラメーターと-e Authentication:Anonymous:AnonymousUserRole=Owner パラメーターは、エミュレーターの匿名認証を構成します。

docker run -d -p 8483:8483 \
    -e Tenant:AnonymousAuthEnabled=true \
    -e Authentication:Anonymous:AnonymousUserRole=Owner \
    mcr.microsoft.com/azure-app-configuration/app-configuration-emulator:1.2.0

エミュレーターのデータを永続化する場合は、 バインド マウントを使用できます。

docker run -d -p 8483:8483 \
    -v "C:\aace:/app/.aace" \
    -e Tenant:AnonymousAuthEnabled=true \
    -e Authentication:Anonymous:AnonymousUserRole=Owner \
    mcr.microsoft.com/azure-app-configuration/app-configuration-emulator:1.2.0

エミュレーターの動作

起動すると、エミュレーターは次の時点で使用できます。 http://localhost:8483

  1. ブラウザーを開き、http://localhost:8483 に移動します。

    キー値のないエミュレーター UI のスクリーンショット。

  2. [ Create ] ボタンをクリックし、新しいキー Messageを追加します。

    エミュレーター UI のスクリーンショット。新しいキー値が作成されています。

  3. Save ボタンをクリックすると、構成エクスプローラーにキー値が表示されます。

    新しいキー値を含むエミュレーター UI のスクリーンショット。

  4. http://localhost:8483/kvを取得すると、次の応答が返されます。

    {"items":[{"etag":"EzV9zWW8k5JpcIXL00T5Kg","key":"Message","label":null,"content_type":null,"value":"Hello World!","tags":{},"locked":false,"last_modified":"2025-08-12T16:56:25.384738+00:00"}]}

エミュレーターでAzure CLIを使いましょう

Azure CLI バージョン 2.83.0 以降は、App Configuration のデータプレーンコマンドに対して匿名認証をサポートしています。 Azureのサブスクリプションや認証情報、アクセスキーなしで、エミュレーターがサポートする任意のデータプレーン操作をAzure CLIで実行できます。 Azure CLIを使ってApp Configurationを扱う方法を学びたい方は、Azure CLIサンプルをご覧ください。

ソース管理でエミュレーターのキー値を設定ファイルとして管理することを検討してください。 Azure CLIのインポート・エクスポート操作を使って、設定ファイルとエミュレーター間でキー値を同期でき、開発環境間でエミュレーターデータの再現に役立ちます。 詳細については、「 設定データのインポートまたはエクスポート 」および 「コードとしての構成」をご覧ください。

次のステップ

アプリケーションでエミュレーターを使用する方法の例については、 GitHub リポジトリを参照してください。

  • Last updated on