Panoramica dell'emulatore di Configurazione app di Azure

L'emulatore di Configurazione app di Azure è uno strumento di sviluppo locale che fornisce un'implementazione leggera del servizio Configurazione app di Azure. Questo emulatore consente agli sviluppatori di testare e sviluppare applicazioni in locale senza richiedere una sottoscrizione di Azure attiva o una connessione al servizio cloud.

L'emulatore di Configurazione app di Azure è open source. Per altre informazioni, visitare il repository GitHub.

Panoramica delle funzionalità

La tabella seguente elenca le funzionalità supportate dall'emulatore di Configurazione app di Azure più recente.

Caratteristica / Funzionalità Stato
Interfaccia utente Web Disponibile
Autenticazione anonima Disponibile
Autenticazione HMAC Disponibile
Integrazione di .NET Aspire Disponibile
API Stato
/keys Disponibile
/kv Disponibile
/labels Disponibile
/locks Disponibile
/revisions Disponibile
/snapshots Disponibile

Installare l'emulatore

Usare Docker per eseguire il pull dell'immagine dell'emulatore di Configurazione app più recente usando il comando della console seguente:

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

Eseguire l'emulatore

Il comando seguente esegue l'immagine Docker dell'emulatore di Configurazione app. Il -p 8483:8483 parametro reindirizza le richieste dalla porta 8483 del computer host all'istanza di Docker. I -e Tenant:AnonymousAuthEnabled=true parametri e -e Authentication:Anonymous:AnonymousUserRole=Owner configurano l'autenticazione anonima per l'emulatore.

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

Se desideri avere dati persistenti per l'emulatore, puoi usare un bind mount.

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

Emulatore in azione

Dopo l'avvio, l'emulatore è disponibile all'indirizzo: http://localhost:8483

  1. Aprire il browser e passare a http://localhost:8483.

    Screenshot dell'interfaccia utente dell'emulatore senza valore di chiave.

  2. Fare clic sul Create pulsante e aggiungere una nuova chiave Message.

    Screenshot dell'interfaccia utente dell'emulatore, creazione di un nuovo valore di chiave.

  3. Cliccare sul pulsante Save e si visualizzerà il valore della chiave in Esplora configurazione.

    Screenshot dell'interfaccia utente dell'emulatore con il nuovo valore della chiave.

  4. Ottenere http://localhost:8483/kv e ottenere la risposta seguente.

    {"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 interfaccia della riga di comando di Azure con l'emulatore

interfaccia della riga di comando di Azure versione 2.83.0 o successiva supporta l'autenticazione anonima per i comandi data-plane App Configuration. Puoi usare interfaccia della riga di comando di Azure per eseguire qualsiasi operazione data-plane supportata dall'emulatore senza abbonamento Azure, credenziali o chiavi di accesso. Per imparare a lavorare con la configurazione delle app utilizzando interfaccia della riga di comando di Azure, consulta esempi di interfaccia della riga di comando di Azure.

Considera di gestire i valori chiave dell'emulatore come file di configurazione nel controllo sorgente. Puoi utilizzare operazioni di importazione ed esportazione di interfaccia della riga di comando di Azure per sincronizzare i valori chiave tra file di configurazione e emulatore, il che ti aiuta a riprodurre i dati dell'emulatore tra ambienti di sviluppo. Per maggiori informazioni, vedi Importa o esporta dati di configurazione e Configurazione come Codice.

Passaggi successivi

Per esempi su come usare l'emulatore nelle applicazioni, passare al repository GitHub.

  • Last updated on