Compartir a través de

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 WIP

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

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

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

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

Pasos siguientes

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

  • Last updated on