Azure 应用配置模拟器概述

Azure 应用配置模拟器是一种本地开发工具,提供 Azure 应用配置服务的轻型实现。 此模拟器允许开发人员在本地测试和开发应用程序,而无需活动的 Azure 订阅或与云服务的连接。

Azure 应用配置模拟器是开源的。 有关详细信息,请访问 GitHub 存储库

功能概述

下表列出了最新 Azure 应用配置模拟器支持的功能。

功能 / 特点 状态
网页用户界面 可用
匿名身份验证 可用
HMAC 身份验证 可用
Entra Id 身份验证 WIP
.NET Aspire 集成 WIP
API 状态
/keys 可用
/kv 可用
/labels 可用
/locks 可用
/revisions 可用
/snapshots WIP

安装模拟器

使用 Docker 使用以下控制台命令拉取最新的 应用配置模拟器映像

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

运行模拟器

以下命令运行应用配置模拟器 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.0-preview

如果想要为模拟器保留数据,可以使用 绑定装载

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.0-preview

运行中的模拟器

启动后,模拟器可在以下位置获取: 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 存储库