Visão geral do emulador da 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 Aplicativos do Azure. Esse emulador permite que os desenvolvedores testem e desenvolvam aplicativos localmente sem a necessidade de uma assinatura ou conexão ativa do Azure com o serviço de nuvem.

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

Visão geral do recurso

A tabela a seguir lista os recursos compatíveis com o emulador mais recente da Configuração de Aplicativos do Azure.

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 do .NET Aspire Disponível
API Situação
/keys Disponível
/kv Disponível
/labels Disponível
/locks Disponível
/revisions Disponível
/snapshots Disponível

Instalar o emulador

Use o Docker para efetuar pull da 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.2.0

Executar o emulador

O comando a seguir executa a imagem do Docker do emulador de Configuração de Aplicativos. O -p 8483:8483 parâmetro redireciona solicitações da porta 8483 do computador 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.2.0

Se você quiser ter dados persistentes para o emulador, poderá 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.2.0

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:8483.

    Captura de tela da interface do usuário do emulador sem nenhum 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ção.

    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 resposta a seguir.

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

Use a CLI do Azure com o emulador

A versão 2.83.0 ou posterior do CLI do Azure suporta autenticação anônima para comandos do plano de dados do App Configuration. Você pode usar o CLI do Azure para realizar qualquer operação de plano de dados suportada pelo emulador sem assinatura do Azure, credenciais ou chaves de acesso. Para aprender a trabalhar com Configuração de Aplicativos usando CLI do Azure, veja exemplos de CLI do Azure.

Considere gerenciar os valores-chave do emulador como arquivos de configuração no controle de versão. Você pode usar operações de importação e exportação do CLI do Azure para sincronizar os valores-chave entre arquivos de configuração e o emulador, o que ajuda a reproduzir os dados do emulador entre ambientes de desenvolvimento. Para mais informações, veja Importar ou exportar dados de configuração e Configuração como Código.

Próximas etapas

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

  • Last updated on