Udostępnij przez


Omówienie emulatora usługi Azure App Configuration

Emulator usługi Azure App Configuration to lokalne narzędzie programistyczne, które zapewnia uproszczoną implementację usługi Azure App Configuration. Ten emulator umożliwia deweloperom testowanie i opracowywanie aplikacji lokalnie bez konieczności aktywnej subskrypcji platformy Azure lub połączenia z usługą w chmurze.

Emulator usługi Azure App Configuration jest oprogramowaniem open source. Aby uzyskać więcej informacji, odwiedź repozytorium GitHub.

Omówienie funkcji

W poniższej tabeli wymieniono funkcje obsługiwane przez najnowszy emulator usługi Azure App Configuration.

Funkcja Status
Internetowy interfejs użytkownika Dostępny
Uwierzytelnianie anonimowe Dostępny
Uwierzytelnianie HMAC Dostępny
Integracja z platformą .NET Aspire Dostępny
API Status
/keys Dostępny
/kv Dostępny
/labels Dostępny
/locks Dostępny
/revisions Dostępny
/snapshots RWT

Instalowanie emulatora

Użyj platformy Docker , aby ściągnąć najnowszy obraz emulatora usługi App Configuration przy użyciu następującego polecenia konsoli:

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

Uruchamianie emulatora

Następujące polecenie uruchamia obraz platformy Docker emulatora usługi App Configuration. Parametr -p 8483:8483 przekierowuje żądania z portu 8483 maszyny hosta do wystąpienia platformy Docker. Parametry -e Tenant:AnonymousAuthEnabled=true i -e Authentication:Anonymous:AnonymousUserRole=Owner umożliwiają skonfigurowanie uwierzytelniania anonimowego dla emulatora.

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

Jeśli chcesz mieć utrwalone dane dla emulatora, możesz użyć instalacji powiązanej.

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

Emulator w akcji

Po uruchomieniu emulator jest dostępny pod adresem: http://localhost:8483

  1. Otwórz przeglądarkę i przejdź do http://localhost:8080adresu .

    Zrzut ekranu przedstawiający interfejs użytkownika emulatora bez wartości klucza.

  2. Create Kliknij przycisk i dodaj nowy klucz Message.

    Zrzut ekranu przedstawiający interfejs użytkownika emulatora, który tworzy nową wartość klucza.

  3. Save Kliknij przycisk i zobaczysz wartość klucza w Eksploratorze konfiguracji.

    Zrzut ekranu przedstawiający interfejs użytkownika emulatora z nową wartością klucza.

  4. Pobierz http://localhost:8483/kv i uzyskasz następującą odpowiedź.

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

Dalsze kroki

Przykłady użycia emulatora w aplikacjach można znaleźć w repozytorium GitHub.