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 Disponible

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.2.0

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.2.0

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.2.0

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

Utilisez Azure CLI avec l’émulateur

Azure CLI version 2.83.0 ou ultérieure prend en charge l’authentification anonyme pour les commandes du plan de données App Configuration. Vous pouvez utiliser Azure CLI pour effectuer n’importe quelle opération de plan de données prise en charge par l’émulateur sans abonnement Azure, identifiants ou clés d’accès. Pour apprendre à utiliser la configuration d’applications en utilisant Azure CLI, consultez les exemples d’Azure CLI.

Envisagez de gérer les clés-valeurs de l’émulateur comme des fichiers de configuration dans le contrôle de version. Vous pouvez utiliser les opérations d’importation et d’exportation Azure CLI pour synchroniser les valeurs clés entre les fichiers de configuration et l’émulateur, ce qui vous aide à reproduire les données de l’émulateur à travers les environnements de développement. Pour plus d’informations, voir Importer ou exporter des données de configuration et Configuration en tant que code.

É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