Introducción al emulador de Azure App Configuration

El emulador de Azure App Configuration es una herramienta de desarrollo local que proporciona una implementación ligera del servicio Azure App Configuration. Este emulador permite a los desarrolladores probar y desarrollar aplicaciones localmente sin necesidad de una suscripción activa de Azure ni conexión al servicio en la nube.

El emulador de Azure App Configuration es de código abierto. Para obtener más información, visite el repositorio de GitHub.

Introducción a las características

En la tabla siguiente se enumeran las características compatibles con el emulador de Azure App Configuration más reciente.

Característica Estado
Interfaz de usuario web Disponible
Autenticación anónima Disponible
Autenticación HMAC Disponible
Integración de .NET Aspire Disponible
API Estado
/keys Disponible
/kv Disponible
/labels Disponible
/locks Disponible
/revisions Disponible
/snapshots Disponible

Instalación del emulador

Use Docker para extraer la imagen más reciente del emulador de App Configuration mediante el siguiente comando de consola:

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

Ejecución del emulador

El siguiente comando ejecuta la imagen de Docker del emulador de App Configuration. El -p 8483:8483 parámetro redirige las solicitudes del puerto 8483 de la máquina host a la instancia de Docker. Los -e Tenant:AnonymousAuthEnabled=true parámetros y -e Authentication:Anonymous:AnonymousUserRole=Owner configuran la autenticación anónima para el emulador.

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 desea conservar los datos del emulador, puede utilizar un montaje enlazado.

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

Emulador en acción

Una vez iniciado, el emulador está disponible en: http://localhost:8483

  1. Abra el explorador web y vaya a http://localhost:8483.

    Captura de pantalla de la interfaz de usuario del emulador sin ningún valor de clave.

  2. Haga clic en el Create botón y agregue una nueva clave Message.

    Captura de pantalla de la interfaz de usuario del emulador, que crea un nuevo valor de clave.

  3. Haga clic en el Save botón y verá el valor de clave en el explorador de configuración.

    Captura de pantalla de la interfaz de usuario del emulador con el nuevo valor de clave.

  4. Obtenga http://localhost:8483/kv y obtenga la siguiente respuesta.

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

Usa CLI de Azure con el emulador

La versión 2.83.0 o posterior de CLI de Azure soporta autenticación anónima para comandos de plano de datos de Configuración de Aplicaciones. Puedes usar CLI de Azure para realizar cualquier operación de plano de datos soportada por el emulador sin una suscripción de Azure, credenciales o claves de acceso. Para aprender a trabajar con la configuración de aplicaciones usando CLI de Azure, consulta ejemplos de CLI de Azure.

Considera gestionar los valores clave del emulador como archivos de configuración en el control de versiones. Puedes usar operaciones de importación y exportación de CLI de Azure para sincronizar los valores clave entre archivos de configuración y el emulador, lo que te ayuda a reproducir los datos del emulador entre entornos de desarrollo. Para más información, consulte Importar o exportar datos de configuración y Configuración como Código.

Pasos siguientes

Para obtener ejemplos sobre cómo usar el emulador en las aplicaciones, vaya al repositorio de GitHub.

  • Last updated on