Översikt över Azure App Configuration-emulatorn

Azure App Configuration-emulatorn är ett lokalt utvecklingsverktyg som ger en enkel implementering av Azure App Configuration-tjänsten. Med den här emulatorn kan utvecklare testa och utveckla program lokalt utan att behöva en aktiv Azure-prenumeration eller anslutning till molntjänsten.

Azure App Configuration-emulatorn är öppen källkod. Mer information finns på GitHub-lagringsplatsen.

Funktionsöversikt

I följande tabell visas de funktioner som stöds av den senaste Azure App Configuration-emulatorn.

Feature Läge
Webbgränssnitt Tillgängligt
Anonym autentisering Tillgängligt
HMAC-autentisering Tillgängligt
.NET Aspire-integrering Tillgängligt
API Läge
/keys Tillgängligt
/kv Tillgängligt
/labels Tillgängligt
/locks Tillgängligt
/revisions Tillgängligt
/snapshots Tillgängligt

Installera emulatorn

Använd Docker för att hämta den senaste appkonfigurationsemulatorn med hjälp av följande konsolkommando:

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

Kör emulatorn

Följande kommando kör Docker-avbildningen för appkonfigurationsemulatorn. Parametern -p 8483:8483 omdirigerar begäranden från värddatorns port 8483 till Docker-instansen. Parametrarna -e Tenant:AnonymousAuthEnabled=true och -e Authentication:Anonymous:AnonymousUserRole=Owner konfigurerar anonym autentisering för emulatorn.

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

Om du vill ha bevarade data för emulatorn kan du använda en bindningsmontering.

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

Emulator i praktiken

När den har startats är emulatorn tillgänglig på: http://localhost:8483

  1. Öppna din webbläsare och gå till http://localhost:8080.

    Skärmbild av emulatorns användargränssnitt utan nyckelvärde.

  2. Klicka på Create knappen och lägg till en ny nyckel Message.

    Skärmbild av användargränssnittet för emulatorn som skapar ett nytt nyckelvärde.

  3. Save Klicka på knappen så visas nyckelvärdet i konfigurationsutforskaren.

    Skärmbild av emulatorns användargränssnitt med det nya nyckelvärdet.

  4. Hämta http://localhost:8483/kv och du får följande svar.

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

Använd Azure CLI med emulatorn

Azure CLI version 2.83.0 eller senare stöder anonym autentisering för App Configuration dataplane-kommandon. Du kan använda Azure CLI för att utföra vilken dataplansoperation som helst som stöds av emulatorn utan Azure-prenumeration, inloggningsuppgifter eller åtkomstnycklar. För att lära dig hur man arbetar med App Configuration med Azure CLI, se exempel på Azure CLI.

Överväg att hantera emulatorns nyckelvärden som konfigurationsfiler i källkontrollen. Du kan använda Azure CLI-import- och exportoperationer för att synkronisera nyckelvärden mellan konfigurationsfiler och emulatorn, vilket hjälper dig att reproducera emulatordata över utvecklingsmiljöer. För mer information, se Importera eller exportera konfigurationsdata och Konfiguration som kod.

Nästa steg

Exempel på hur du använder emulatorn i dina program finns på GitHub-lagringsplatsen.

  • Last updated on