Azure App Configuration 에뮬레이터 개요

Azure App Configuration 에뮬레이터는 Azure App Configuration 서비스의 간단한 구현을 제공하는 로컬 개발 도구입니다. 이 에뮬레이터를 사용하면 개발자가 활성 Azure 구독 또는 클라우드 서비스에 연결하지 않고도 로컬에서 애플리케이션을 테스트하고 개발할 수 있습니다.

Azure App Configuration 에뮬레이터는 오픈 소스입니다. 자세한 내용은 GitHub 리포지토리를 참조하세요.

기능 개요

다음 표에서는 최신 Azure App Configuration 에뮬레이터에서 지원하는 기능을 나열합니다.

특징 상태
웹 사용자 인터페이스 사용 가능
익명 인증 사용 가능
HMAC 인증 사용 가능
.NET Aspire 통합 사용 가능
API 상태
/keys 사용 가능
/kv 사용 가능
/labels 사용 가능
/locks 사용 가능
/revisions 사용 가능
/snapshots 사용 가능

에뮬레이터 설치

Docker를 사용하여 다음 콘솔 명령을 사용하여 최신 App Configuration 에뮬레이터 이미지를 끌어오세요.

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

에뮬레이터 실행

다음 명령은 App Configuration 에뮬레이터 Docker 이미지를 실행합니다. 매개 변수는 -p 8483:8483 호스트 머신의 포트 8483에서 Docker 인스턴스로 요청을 리디렉션합니다. 및 -e Tenant:AnonymousAuthEnabled=true 매개 변수는 -e Authentication:Anonymous:AnonymousUserRole=Owner 에뮬레이터에 대한 익명 인증을 구성합니다.

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

에뮬레이터에 대한 데이터를 유지하려면 바인딩 탑재를 사용할 수 있습니다.

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

작동 중인 에뮬레이터

시작되면 에뮬레이터는 다음 위치에서 사용할 수 있습니다. http://localhost:8483

  1. 브라우저를 열고 http://localhost:8483으로 이동합니다.

    키 값이 없는 에뮬레이터 UI의 스크린샷

  2. Create 단추를 클릭하고 새 키를 Message추가합니다.

    새 키 값을 만드는 에뮬레이터 UI의 스크린샷

  3. Save 단추를 클릭하면 구성 탐색기에 키 값이 표시됩니다.

    새 키 값이 있는 에뮬레이터 UI의 스크린샷

  4. http://localhost:8483/kv를 받으면 다음과 같은 응답을 받게 됩니다.

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

Azure CLI with the emulator

Azure CLI 버전 2.83.0 이상은 App Configuration data-plane 명령에 대한 익명 인증을 지원합니다. Azure CLI를 사용해 에뮬레이터가 지원하는 모든 데이터 플레인 작업을 Azure 구독, 자격 증명, 접근 키 없이도 수행할 수 있습니다. Azure CLI를 이용해 앱 구성을 다루는 방법을 배우려면 Azure CLI 샘플을 참고하세요.

소스 컨트롤에서 에뮬레이터 키 값을 구성 파일로 관리하는 것을 고려해 보세요. Azure CLI의 가져오기 및 내보내기 작업을 통해 설정 파일과 에뮬레이터 간의 키 값을 동기화할 수 있어, 개발 환경 전반에 걸쳐 에뮬레이터 데이터를 재현할 수 있습니다. 자세한 내용은 구성 데이터 가져오기 또는 내보내기 와 코드로 구성된 설정을 참조하세요.

다음 단계

애플리케이션에서 에뮬레이터를 사용하는 방법에 대한 예제는 GitHub 리포지토리로 이동합니다.

  • Last updated on