Testar localmente usando o emulador dos Hubs de Eventos do Azure

Antes de executar um script automatizado, clone o Repositório do instalador do GitHub do emulador localmente.

Windows

Use as seguintes etapas para executar o emulador dos Hubs de Eventos localmente no Windows:

1. Permitir a execução de scripts não assinados executando esse comando na janela do PowerShell:

   $>Start-Process powershell -Verb RunAs -ArgumentList 'Set-ExecutionPolicy Bypass –Scope CurrentUser'

2. Execute o script de instalação LaunchEmulator.ps1. A execução do script introduz dois contêineres: o emulador dos Hubs de Eventos e o Azurite (uma dependência do emulador).

Linux e macOS

Para executar o emulador dos Hubs de Eventos localmente no Linux ou no macOS:

• Execute o script de instalação LaunchEmulator.sh. A execução do script introduz dois contêineres: o emulador dos Hubs de Eventos e o Azurite (uma dependência do emulador).

1. Para iniciar o emulador, forneça uma configuração para as entidades que você quer usar. Salve o arquivo JSON a seguir localmente como config.json:

   {
       "UserConfig": {
           "NamespaceConfig": [
           {
               "Type": "EventHub",
               "Name": "emulatorNs1",
               "Entities": [
               {
                   "Name": "eh1",
                   "PartitionCount": "2",
                   "ConsumerGroups": [
                   {
                       "Name": "cg1"
                   }
                   ]
               }
               ]
           }
           ], 
           "LoggingConfig": {
               "Type": "File"
           }
       }
   }
   
   

2. Para criar contêineres para o emulador dos Hubs de Eventos, salve o arquivo .yaml a seguir como docker-compose.yaml.

   name: microsoft-azure-eventhubs
   services:
     emulator:
       container_name: "eventhubs-emulator"
       image: "mcr.microsoft.com/azure-messaging/eventhubs-emulator:latest"
       volumes:
         - "${CONFIG_PATH}:/Eventhubs_Emulator/ConfigFiles/Config.json"
       ports:
         - "5672:5672"
         - "9092:9092"
       environment:
         BLOB_SERVER: azurite
         METADATA_SERVER: azurite
         ACCEPT_EULA: ${ACCEPT_EULA}
       depends_on:
         - azurite
       networks:
         eh-emulator:
           aliases:
             - "eventhubs-emulator"
     azurite:
       container_name: "azurite"
       image: "mcr.microsoft.com/azure-storage/azurite:latest"
       ports:
         - "10000:10000"
         - "10001:10001"
         - "10002:10002"
       networks:
         eh-emulator:
           aliases:
             - "azurite"
   networks:
     eh-emulator:
   

3. Crie um arquivo .env para declarar as variáveis de ambiente para o emulador dos Hubs de Eventos:

   # Centralized environment variables store for docker-compose
   
   # 1. CONFIG_PATH: Path to config.json file
   CONFIG_PATH="<Replace with path to config.json file>" 
   
   # 2. ACCEPT_EULA: Pass 'Y' to accept license terms. 
   ACCEPT_EULA="N"
   
   

   O argumento ACCEPT_EULA confirma os Termos de Licença de Software da Microsoft. Certifique-se de colocar o arquivo .env no mesmo diretório do arquivo docker-compose.yaml.

   Importante

   Ao especificar caminhos de arquivo no Windows, use barras invertidas duplas (\\) em vez de barras invertidas simples (\) para evitar confusão com caracteres de escape.

4. Para executar o emulador, execute o seguinte comando:

    docker compose -f <PathToDockerComposeFile> up -d
   

Ao interagir com o Kafka, certifique-se de definir a configuração do produtor e do consumidor da seguinte maneira:

        {
            BootstrapServers =  //Value of bootstrap servers would depend on kind of connection string being used
            SecurityProtocol = SecurityProtocol.SaslPlaintext,
            SaslMechanism = SaslMechanism.Plain,
            SaslUsername = "$ConnectionString",
            SaslPassword = //Value of connection string would depend on topology
        };

O valor de BootstrapServers e SaslPassword dependeria da topologia de configuração. Consulte a seção Interagir com o Emulador para obter detalhes.

Com as versões mais recentes do SDK de cliente, você poderá interagir com o emulador em várias linguagens de programação. Para obter mais detalhes, confira SDKs de Cliente.