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 Aspire Dostępny
API Status
/keys Dostępny
/kv Dostępny
/labels Dostępny
/locks Dostępny
/revisions Dostępny
/snapshots Dostępny

Instalowanie emulatora

Użyj Docker, aby pobrać najnowszy obraz emulatora usługi App Configuration za pomocą następującego polecenia konsoli:

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

Uruchamianie emulatora

Następujące polecenie uruchamia obraz Dockera emulatora usługi App Configuration. Parametr -p 8483:8483 przekierowuje żądania z portu 8483 na maszynie hosta do instancji Dockera. 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.2.0

Jeśli chcesz zachować trwałe dane w emulatorze, możesz użyć montowania wiązanego.

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

Emulator w akcji

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

  1. Otwórz przeglądarkę i przejdź do .

    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. Kliknij przycisk Save, a 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"}]}

Użyj Azure CLI z emulatorem

Azure CLI w wersji 2.83.0 lub nowszej obsługuje anonimowe uwierzytelnianie dla poleceń App Configuration w płaszczyźnie danych. Możesz użyć Azure CLI do wykonywania dowolnej operacji na płaszczyźnie danych obsługiwanej przez emulator bez konieczności posiadania subskrypcji Azure, danych uwierzytelniających czy kluczy dostępu. Aby dowiedzieć się, jak pracować z konfiguracją aplikacji przy użyciu Azure CLI, zobacz przykłady Azure CLI.

Rozważ zarządzanie wartościami kluczy emulatora jako plikami konfiguracyjnymi w kontroli kodu źródłowego. Możesz użyć operacji importu i eksportu Azure CLI, aby synchronizować wartości kluczy między plikami konfiguracyjnymi a emulatorem, co pomaga odtwarzać dane emulatora w różnych środowiskach deweloperskich. Więcej informacji można znaleźć w artykułach Importowanie lub eksportowanie danych konfiguracji oraz Konfiguracja jako kod.

Dalsze kroki

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

  • Last updated on