Overzicht van Azure App Configuration-emulator

De Azure App Configuration-emulator is een lokaal ontwikkelhulpprogramma dat een lichtgewicht implementatie van de Azure App Configuration-service biedt. Met deze emulator kunnen ontwikkelaars toepassingen lokaal testen en ontwikkelen zonder een actief Azure-abonnement of een actieve verbinding met de cloudservice te vereisen.

De Azure App Configuration-emulator is open source. Ga naar de GitHub-opslagplaats voor meer informatie.

Overzicht van functies

De volgende tabel bevat de functies die worden ondersteund door de nieuwste Azure App Configuration-emulator.

Eigenschap Toestand
Web-UI Beschikbaar
Anonieme authenticatie Beschikbaar
HMAC-verificatie Beschikbaar
.NET Aspire-integratie Beschikbaar
API Toestand
/keys Beschikbaar
/kv Beschikbaar
/labels Beschikbaar
/locks Beschikbaar
/revisions Beschikbaar
/snapshots Beschikbaar

De emulator installeren

Gebruik Docker om de meest recente installatiekopie van de App Configuration-emulator op te halen met behulp van de volgende consoleopdracht:

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

De emulator uitvoeren

Met de volgende opdracht voert u de Docker-image van de App Configuration-emulator uit. Met -p 8483:8483 de parameter worden aanvragen omgeleid van poort 8483 van de hostcomputer naar het Docker-exemplaar. De -e Tenant:AnonymousAuthEnabled=true en -e Authentication:Anonymous:AnonymousUserRole=Owner parameters configureren de anonieme verificatie voor de 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.2.0

Als u persistente gegevens voor de emulator wilt hebben, kunt u een bindingskoppeling gebruiken.

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 in actie

Zodra de emulator is gestart, is deze beschikbaar op: http://localhost:8483

  1. Open uw browser en ga naar http://localhost:8080.

    Schermopname van de gebruikersinterface van de emulator zonder sleutelwaarde.

  2. Klik op de Create knop en voeg een nieuwe sleutel Messagetoe.

    Schermopname van de gebruikersinterface van de emulator en het maken van een nieuwe sleutelwaarde.

  3. Klik op de Save knop en u ziet de sleutelwaarde in de Configuration Explorer.

    Schermopname van de gebruikersinterface van de emulator met de nieuwe sleutelwaarde.

  4. Krijg http://localhost:8483/kv en u ontvangt de volgende reactie.

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

Gebruik Azure CLI met de emulator

Azure CLI versie 2.83.0 of later ondersteunt anonieme authenticatie voor App Configuration dataplane-commando's. Je kunt Azure CLI gebruiken om elke data-plane-operatie uit te voeren die door de emulator wordt ondersteund, zonder een Azure-abonnement, inloggegevens of toegangssleutels. Om te leren hoe je met App Configuration werkt met Azure CLI, zie Azure CLI-voorbeelden.

Overweeg het beheren van emulatorsleutelwaarden als configuratiebestanden in de broncode. Je kunt Azure CLI-import- en exportoperaties gebruiken om sleutelwaarden tussen configuratiebestanden en de emulator te synchroniseren, wat je helpt emulatordata te reproduceren in ontwikkelomgevingen. Voor meer informatie, zie Configuratiegegevens importeren of exporteren en Configuratie als Code.

Volgende stappen

Ga naar de GitHub-opslagplaats voor voorbeelden over het gebruik van de emulator in uw toepassingen.

  • Last updated on