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
打开浏览器并导航到
http://localhost:8483。
Create单击该按钮并添加新键Message。
Save单击该按钮,并在配置资源管理器中看到密钥值。
获取
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 存储库。