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 Disponível

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.2.0

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.2.0

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.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: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"}]}

Usa o 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 App Configuration. Pode usar o CLI do Azure para realizar qualquer operação de plano de dados suportada pelo emulador sem subscrição do Azure, credenciais ou chaves de acesso. Para aprender a trabalhar com Configuração de Aplicações usando CLI do Azure, consulte exemplos de CLI do Azure.

Considere gerir os valores-chave do emulador como ficheiros de configuração no controlo de versão. Pode usar operações de importação e exportação do CLI do Azure para sincronizar os valores-chave entre ficheiros de configuração e o emulador, o que ajuda a reproduzir os dados do emulador entre ambientes de desenvolvimento. Para mais informações, consulte Importar ou exportar dados de configuração e Configuração como Código.

Próximos passos

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

  • Last updated on