Freigeben über

Übersicht über den Azure App-Konfigurationsemulator

Der Azure App-Konfigurationsemulator ist ein lokales Entwicklungstool, das eine einfache Implementierung des Azure App-Konfigurationsdiensts bietet. Mit diesem Emulator können Entwickler Anwendungen lokal testen und entwickeln, ohne dass ein aktives Azure-Abonnement oder eine Verbindung mit dem Clouddienst erforderlich ist.

Der Emulator für die Azure-App-Konfiguration ist Open Source. Weitere Informationen finden Sie im GitHub-Repository.

Funktionsübersicht

In der folgenden Tabelle sind die Features aufgeführt, die vom neuesten Azure App-Konfigurationsemulator unterstützt werden.

Merkmal Der Status
Web-UI Verfügbar
Anonyme Authentifizierung Verfügbar
HMAC-Authentifizierung Verfügbar
.NET Aspire Integration Verfügbar
API Der Status
/keys Verfügbar
/kv Verfügbar
/labels Verfügbar
/locks Verfügbar
/revisions Verfügbar
/snapshots WIP

Installieren des Emulators

Verwenden Sie Docker , um das neueste Image des App-Konfigurations-Emulators mithilfe des folgenden Konsolenbefehls abzurufen:

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

Ausführen des Emulators

Der folgende Befehl führt das Docker-Image des App-Konfigurations-Emulators aus. Der -p 8483:8483 Parameter leitet Anforderungen vom Port 8483 des Hostcomputers an die Docker-Instanz um. Der Parameter -e Tenant:AnonymousAuthEnabled=true und -e Authentication:Anonymous:AnonymousUserRole=Owner konfiguriert die anonyme Authentifizierung für den Emulator.

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

Wenn Sie Daten für den Emulator beibehalten möchten, können Sie ein Bind-Mount verwenden.

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

Emulator in Aktion

Nach dem Starten ist der Emulator verfügbar unter: http://localhost:8483

  1. Navigieren Sie in Ihrem Browser zu http://localhost:8483.

    Screenshot der Emulatorbenutzeroberfläche ohne Schlüsselwert.

  2. Klicken Sie auf die Create Schaltfläche, und fügen Sie eine neue Taste Messagehinzu.

    Screenshot der Emulatorbenutzeroberfläche, Erstellen eines neuen Schlüsselwerts.

  3. Klicken Sie auf die Save Schaltfläche, und sie sehen den Schlüsselwert im Konfigurations-Explorer.

    Screenshot der Emulatorbenutzeroberfläche mit dem neuen Schlüsselwert.

  4. Erhalten Sie http://localhost:8483/kv, und Sie erhalten die folgende Antwort.

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

Nächste Schritte

Beispiele zur Verwendung des Emulators in Ihren Anwendungen finden Sie im GitHub-Repository.

  • Last updated on