Partilhar via

Visão geral do emulador de Configuração de Aplicativo do Azure

O emulador de Configuração de Aplicativo do Azure é uma ferramenta de desenvolvimento local que fornece uma implementação leve do serviço de Configuração de Aplicativo do Azure. Esse emulador permite que os desenvolvedores testem e desenvolvam aplicativos localmente sem exigir uma assinatura ativa do Azure ou conexão com o serviço de nuvem.

O emulador de Configuração de Aplicativo do Azure é de código aberto. Para obter mais informações, visite o repositório GitHub.

Visão geral dos recursos

A tabela a seguir lista os recursos suportados pelo emulador de Configuração de Aplicativo do Azure mais recente.

Característica Situação
Interface do usuário da Web Disponível
Autenticação Anônima Disponível
Autenticação HMAC Disponível
Integração com o .NET Aspire Disponível
API Situação
/keys Disponível
/kv Disponível
/labels Disponível
/locks Disponível
/revisions Disponível
/snapshots WIP

Instalar o emulador

Use o Docker para extrair a imagem mais recente do emulador de Configuração de Aplicativo usando o seguinte comando de console:

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

Execute o emulador

O comando a seguir executa a imagem do Docker do emulador de Configuração de Aplicativo. O -p 8483:8483 parâmetro redireciona solicitações da porta 8483 da máquina host para a instância do Docker. Os -e Tenant:AnonymousAuthEnabled=true parâmetros e -e Authentication:Anonymous:AnonymousUserRole=Owner configuram a autenticação anônima para o 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

Se quiser ter dados persistentes para o emulador, pode usar um 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.0.2

Emulador em ação

Uma vez iniciado, o emulador está disponível em: http://localhost:8483

  1. Abra o navegador e navegue até http://localhost:8080.

    Captura de tela da interface do usuário do emulador sem valor de chave.

  2. Clique no Create botão e adicione uma nova chave Message.

    Captura de tela da interface do usuário do emulador, criando um novo valor de chave.

  3. Clique no Save botão e você verá o valor da chave no gerenciador de configurações.

    Captura de tela da interface do usuário do emulador com o novo valor de chave.

  4. Obtenha http://localhost:8483/kv e obtenha a seguinte resposta.

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

Próximos passos

Para obter exemplos sobre como usar o emulador em seus aplicativos, vá para o repositório GitHub.

  • Last updated on