次の方法で共有

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 WIP

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

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

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

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

次のコマンドは、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.0.2

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

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.0.2

エミュレーターの動作

起動すると、エミュレーターは次の時点で使用できます。 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"}]}

次のステップ

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

  • Last updated on