Eseguire il test in locale usando l'emulatore di Hub eventi di Azure

Prima di eseguire uno script automatizzato, clonare il repository del programma di installazione GitHub dell'emulatore in locale.

Finestre

Usare la procedura seguente per eseguire l'emulatore di Hub eventi in locale in Windows:

1. Consentire l'esecuzione di script non firmati eseguendo questo comando nella finestra di PowerShell:

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

2. Eseguire lo script di installazione LaunchEmulator.ps1. L'esecuzione dello script visualizza due contenitori: l'emulatore di Hub eventi e Azurite (una dipendenza per l'emulatore).

Linux e macOS

Per eseguire l'emulatore di Hub eventi in locale in Linux o macOS:

• Eseguire lo script di installazione LaunchEmulator.sh. L'esecuzione dello script visualizza due contenitori: l'emulatore di Hub eventi e Azurite (una dipendenza per l'emulatore).

1. Per avviare l'emulatore, specificare una configurazione per le entità da usare. Salvare il file JSON seguente in locale come config.json:

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

2. Per creare contenitori per l'emulatore di Hub eventi, salvare il file yaml seguente come 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. Creare un file con estensione env per dichiarare le variabili di ambiente per l'emulatore di Hub eventi:

   # 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"
   
   

   L'argomento ACCEPT_EULA conferma le Condizioni di licenza software Microsoft. Assicurarsi di inserire il file con estensione env nella stessa directory del file docker-compose.yaml .

   Importante

   Quando si specificano percorsi di file in Windows, usare doppie barre rovesciata (\\) invece di singole barre rovesciata () per\ evitare confusione con i caratteri di escape.

4. Per eseguire l'emulatore, eseguire il comando seguente:

    docker compose -f <PathToDockerComposeFile> up -d
   

Durante l'interazione con Kafka, assicurarsi di impostare la configurazione producer e consumer come segue:

        {
            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
        };

Il valore di BootstrapServers e SaslPassword dipende dalla topologia di installazione. Per informazioni dettagliate, vedere la sezione Interagire con l'emulatore .

Con le versioni più recenti dell'SDK client, è possibile interagire con l'emulatore in vari linguaggi di programmazione. Per informazioni dettagliate, vedere SDK client.