Přehled emulátoru služby Azure App Configuration

Emulátor služby Azure App Configuration je místní vývojový nástroj, který poskytuje jednoduchou implementaci služby Azure App Configuration. Tento emulátor umožňuje vývojářům testovat a vyvíjet aplikace místně bez nutnosti aktivního předplatného Azure nebo připojení ke cloudové službě.

Emulátor služby Azure App Configuration je open source. Další informace najdete v úložišti GitHub.

Přehled funkcí

Následující tabulka uvádí funkce podporované nejnovějším emulátorem služby Azure App Configuration.

Vlastnost	Stav
Webové uživatelské rozhraní	K dispozici
Anonymní ověřování	K dispozici
Ověřování HMAC	K dispozici
Integrace .NET Aspire	K dispozici

API	Stav
/keys	K dispozici
/kv	K dispozici
/labels	K dispozici
/locks	K dispozici
/revisions	K dispozici
/snapshots	NV

Instalace emulátoru

Docker

Pomocí Dockeru stáhněte nejnovější image emulátoru služby App Configuration pomocí následujícího příkazu konzoly:

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

GitHub

Tato metoda instalace vyžaduje, abyste nainstalovali:

• Git
• Sada .NET 8.0 SDK
• Node.js

1. Naklonujte úložiště GitHub pro projekt emulátoru.

   git clone https://github.com/Azure/AppConfiguration-Emulator.git
   

2. Sestavte celé řešení včetně komponent uživatelského rozhraní.

   cd AppConfiguration-Emulator
   dotnet restore
   dotnet build
   

Spuštění emulátoru

Docker

Následující příkaz spustí image Dockeru emulátoru služby App Configuration. Parametr -p 8483:8483 přesměruje požadavky z portu hostitelského počítače 8483 na instanci Dockeru. Parametry -e Tenant:AnonymousAuthEnabled=true a -e Authentication:Anonymous:AnonymousUserRole=Owner nakonfigurují anonymní ověřování pro emulátor.

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

Pokud chcete mít trvalá data pro emulátor, můžete použít bind mount.

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

GitHub

dotnet run --project src/Azure.AppConfiguration.Emulator.Host/Azure.AppConfiguration.Emulator.Host.csproj

Emulátor v akci

Po spuštění je emulátor k dispozici na adrese: http://localhost:8483

1. Otevřete prohlížeč a přejděte na http://localhost:8080.

   

2. Klikněte na Create tlačítko a přidejte nový klíč Message.

   

3. Klikněte na Save tlačítko a v Průzkumníku konfigurace se zobrazí hodnota klíče.

   

4. Získejte http://localhost:8483/kv a obdržíte následující odpověď.

   {"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"}]}
   

Další kroky

Příklady použití emulátoru v aplikacích najdete v úložišti GitHub.