Partager via

Vue d’ensemble de l’émulateur Azure App Configuration

L’émulateur Azure App Configuration est un outil de développement local qui fournit une implémentation légère du service Azure App Configuration. Cet émulateur permet aux développeurs de tester et de développer des applications localement sans avoir besoin d’un abonnement Azure actif ou d’une connexion au service cloud.

L’émulateur Azure App Configuration est open source. Pour plus d’informations, consultez le dépôt GitHub.

Présentation des fonctionnalités

Le tableau suivant répertorie les fonctionnalités prises en charge par l’émulateur Azure App Configuration le plus récent.

Caractéristique Statut
Interface utilisateur web Disponible
Authentification anonyme Disponible
Authentification HMAC Disponible
Intégration de .NET Aspire Disponible
API Statut
/keys Disponible
/kv Disponible
/labels Disponible
/locks Disponible
/revisions Disponible
/snapshots WIP

Installer l’émulateur

Utilisez Docker pour extraire la dernière image de l’émulateur App Configuration à l’aide de la commande console suivante :

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

Exécuter l’émulateur

La commande suivante exécute l’image Docker de l’émulateur App Configuration. Le -p 8483:8483 paramètre redirige les requêtes du port 8483 de l’ordinateur hôte vers l’instance Docker. Les paramètres -e Tenant:AnonymousAuthEnabled=true et -e Authentication:Anonymous:AnonymousUserRole=Owner configurent l’authentification anonyme pour l’émulateur.

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

Si vous souhaitez avoir des données persistantes pour l’émulateur, vous pouvez utiliser un montage de liaison.

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

Émulateur en action

Une fois démarré, l’émulateur est disponible à l’adresse suivante : http://localhost:8483

  1. Ouvrez votre navigateur et accédez à http://localhost:8483.

    Capture d’écran de l’interface utilisateur de l’émulateur sans valeur de clé.

  2. Cliquez sur le Create bouton et ajoutez une nouvelle clé Message.

    Capture d’écran de l’interface utilisateur de l’émulateur, création d’une nouvelle valeur de clé.

  3. Cliquez sur le Save bouton et vous voyez la valeur de clé dans l’Explorateur de configuration.

    Capture d’écran de l’interface utilisateur de l’émulateur avec la nouvelle valeur de clé.

  4. Obtenez http://localhost:8483/kv et vous recevrez la réponse suivante.

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

Étapes suivantes

Pour obtenir des exemples sur l’utilisation de l’émulateur dans vos applications, accédez au dépôt GitHub.

  • Last updated on