Visão geral do emulador do Barramento de Serviço do Azure

O emulador do Barramento de Serviço do Azure oferece uma experiência de desenvolvimento local para o serviço Barramento de Serviço. Você pode usar o emulador para desenvolver e testar o código no serviço isoladamente, livre de interferência na nuvem.

Benefícios

As principais vantagens de usar o emulador são:

  • Desenvolvimento local: o emulador proporciona uma experiência de desenvolvimento local, permitindo que você trabalhe offline e evite a latência da rede.
  • Eficiência de custo: com o emulador, você pode testar seus aplicativos sem incorrer em custos de uso da nuvem.
  • Ambiente de teste isolado: você pode testar seu código isoladamente, para garantir que outras atividades na nuvem não afetem os testes.
  • Loop de desenvolvimento interno otimizado: você pode usar o emulador para criar protótipos e testar rapidamente seus aplicativos antes de implantá-los na nuvem.

Observação

O emulador do Barramento de Serviço está disponível sob os Termos de Licença para Software Microsoft.

O emulador do Barramento de Serviço não é compatível com o Barramento de Serviço Explorer de código aberto de propriedade da comunidade.

Recursos

O emulador fornece estes recursos:

  • Implantação em contêineres: é executado como um contêiner do Docker (baseado em Linux).
  • Compatibilidade entre plataformas: você pode usá-la em qualquer plataforma, incluindo Windows, macOS e Linux.
  • Configurabilidade: você pode gerenciar o número de entidades do Barramento de Serviço usando o cliente de administração do ServiceBus ou a configuração fornecida por JSON.
  • Suporte a streaming: oferece suporte a mensagens de streaming usando o AMQP (Advanced Message Queuing Protocol).
  • Observabilidade: oferece recursos de observabilidade, incluindo registro em console e em arquivo.

Limitações conhecidas

A versão atual do emulador tem as seguintes limitações:

  • Não é possível transmitir mensagens usando o protocolo JMS.
  • As entidades particionadas não são compatíveis com o emulador.
  • Não há suporte para Soquetes Web AMQP. O AMQP TCP é o único tipo de transporte com suporte.

Observação

Após a reinicialização de um contêiner, os dados e as entidades não persistem no emulador.

Diferenças em relação ao serviço de nuvem

Como o emulador do Barramento de Serviço destina-se apenas a fins de desenvolvimento e teste, existem diferenças funcionais entre o emulador e o serviço de nuvem.

O emulador não dá suporte a esses recursos de alto nível:

  • Recursos do Azure, como integração de rede virtual, integração do Microsoft Entra ID, logs de atividades e um portal de interface do usuário
  • Recursos de dimensionamento automático
  • Recursos de recuperação de desastre geográfico
  • Suporte a mensagens grandes
  • Métricas e alertas visuais

Observação

O emulador destina-se a cenários de desenvolvimento e teste, especificamente para casos de uso de teste sequencial. Não use o emulador do Barramento de Serviço para cargas de trabalho de produção, pois ele não oferece um SLA.

Não fornecemos suporte oficial para o emulador. Relatar quaisquer problemas ou sugestões no repositório do instalador do GitHub do emulador.

Cotas de uso

Assim como o serviço de nuvem do Barramento de Serviço, o emulador fornece as seguintes cotas para uso:

Propriedade Valor máximo Configurável pelo usuário dentro dos limites
Número de namespaces com suporte 1 Não
Número de entidades (filas/tópicos) em um namespace 50 Sim
Número de Assinaturas por tópico 50 Sim
Número de filtros de correlação por tópico 1,000 Sim
Número de filtros SQL por tópico 70 Sim
Comprimento da condição de filtro ou da cadeia de caracteres de ação da regra 1,024 Sim
Número de expressões por ação de regra 32 Sim
Número de conexões simultâneas com o namespace 10 Sim
Número de solicitações de recebimento simultâneas na entidade (fila/tópico) ou entidade de assinatura 200 Sim
Tamanho da mensagem 256 KB Não
Tamanho da fila ou do tópico 100 MB Não
Vida útil da Mensagem 1 h Sim

O limite de filtro SQL se aplica por tópico e é compartilhado entre todas as assinaturas desse tema.

Criar e gerenciar entidades no emulador do Barramento de Serviço

Você pode criar e gerenciar entidades do Barramento de Serviço , como filas e tópicos, usando o Cliente de Administração do Barramento de Serviço. Por padrão, o emulador é executado com o arquivo de configuração config.json. Você também pode fazer alterações declarativas no arquivo de configuração de acordo com suas necessidades:

  • Entidades: você pode adicionar mais entidades do barramento de serviço de acordo com as cotas suportadas.
  • Registro em log: o emulador suporta o registro de logs em um console, em um arquivo ou em ambos. Você pode escolher de acordo com sua preferência pessoal.

Importante

Você deve fornecer alterações na configuração JSON antes de executar o emulador. As alterações não são aplicadas em tempo real. Para que as alterações entrem em vigor, você deve reiniciar o contêiner.

Na inicialização do emulador, as configurações definidas no arquivo de configuração substituem todas as entidades criadas ou modificadas anteriormente usando o Cliente de Administração do Barramento de Serviço.

Não é possível renomear o namespace predefinido (name) no arquivo de configuração.

Logs para depuração

Durante o teste, o console ou os logs de arquivos ajudam a depurar falhas inesperadas. Para analisar os logs:

  • Logs do console: na interface de usuário do desktop do Docker, selecione o nome do contêiner.
  • Logs de arquivos: no contêiner, vá para /home/app/EmulatorLogs.

Faça o teste localmente usando o emulador do Barramento de Serviço do Azure

Exemplos de emulador do Barramento de Serviço