Místní testování pomocí emulátoru služby Azure Event Hubs

Tento článek shrnuje kroky pro místní vývoj a testování pomocí emulátoru služby Azure Event Hubs.

Požadavky

• Desktop Docker
• Minimální požadavky na hardware:
  • 2 GB paměti RAM
  • 5 GB místa na disku
• konfigurace Subsystém Windows pro Linux (WSL) (pouze pro Windows):
  • Instalace WSL
  • Konfigurace Dockeru pro použití WSL

Poznámka:

Než budete pokračovat v krocích v tomto článku, ujistěte se, že je Docker Desktop funkční na pozadí.

Spuštění emulátoru

Ke spuštění emulátoru služby Event Hubs můžete použít automatizovaný skript nebo kontejner Linuxu:

Automatizovaný skript

Před spuštěním automatizovaného skriptu naklonujte místně úložiště instalačního programu GitHubu emulátoru.

Windows

Pomocí následujících kroků spusťte emulátor služby Event Hubs místně ve Windows:

1. Spuštěním tohoto příkazu v okně PowerShellu povolte provádění nepodepsaných skriptů:

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

2. Spusťte instalační skript LaunchEmulator.ps1. Spuštění skriptu zobrazí dva kontejnery: emulátor služby Event Hubs a Azurite (závislost pro emulátor).

Linux a macOS

Místní spuštění emulátoru služby Event Hubs v Linuxu nebo macOS:

• Spusťte instalační skript LaunchEmulator.sh. Spuštění skriptu zobrazí dva kontejnery: emulátor služby Event Hubs a Azurite (závislost pro emulátor).

Docker (kontejner Linuxu)

1. Pokud chcete spustit emulátor, zadejte konfiguraci entit, které chcete použít. Uložte následující soubor JSON místně jako config.json:

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

2. Pokud chcete spustit kontejnery pro emulátor služby Event Hubs, uložte následující soubor .yaml jako 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. Vytvořte soubor .env pro deklaraci proměnných prostředí pro emulátor služby Event Hubs:

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

   ACCEPT_EULA Argument potvrzuje licenční podmínky pro software společnosti Microsoft. Nezapomeňte umístit soubor .env do stejného adresáře jako soubor docker-compose.yaml .

   Důležité

   Při zadávání cest k souborům ve Windows používejte dvojité zpětné lomítka (\\) místo jednoduchých zpětných lomítek (\), abyste se vyhnuli nejasnostem s řídicími znaky.

4. Pokud chcete spustit emulátor, spusťte následující příkaz:

    docker compose -f <PathToDockerComposeFile> up -d
   

Po úspěšném provedení kroků najdete kontejnery spuštěné v Dockeru.

Interakce s emulátorem

Ve výchozím nastavení emulátor používá konfigurační soubor config.json . Entity (témata Event Hubs nebo Kafka) můžete nakonfigurovat provedením změn konfiguračního souboru. Další informace najdete v tématu Provedení změn konfigurace.

K připojení k emulátoru služby Event Hubs můžete použít následující připojovací řetězec:

• Pokud kontejner emulátoru a interakce aplikace běží nativně na místním počítači, použijte následující připojovací řetězec:

"Endpoint=sb://localhost;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=SAS_KEY_VALUE;UseDevelopmentEmulator=true;"

• Aplikace (kontejnerizované nebo nekotenerizované) na jiném počítači a stejné místní síti můžou komunikovat s emulátorem pomocí adresy IPv4 počítače. Použijte následující připojovací řetězec:

"Endpoint=sb://192.168.y.z;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=SAS_KEY_VALUE;UseDevelopmentEmulator=true;"

• Kontejnery aplikací ve stejné síti mostu můžou komunikovat s emulátorem pomocí svého aliasu nebo IP adresy. Následující připojovací řetězec předpokládá, že název emulátoru má výchozí hodnotu, která je eventhubs-emulator:

"Endpoint=sb://eventhubs-emulator;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=SAS_KEY_VALUE;UseDevelopmentEmulator=true;"

• Kontejnery aplikací v jiné síti mostu můžou komunikovat s emulátorem pomocí host.docker.internal jako hostitele. Použijte následující připojovací řetězec:

"Endpoint=sb://host.docker.internal;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=SAS_KEY_VALUE;UseDevelopmentEmulator=true;"

Použití Kafka

Při interakci se systémem Kafka nezapomeňte nastavit konfiguraci producenta a příjemce následujícím způsobem:

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

Hodnota BootstrapServers a SaslPassword by závisela na vaší topologii instalace. Podrobnosti najdete v části Interakce s emulátorem .

Důležité

Při použití kafka jsou s emulátorem služby Event Hubs kompatibilní pouze rozhraní API producenta a příjemce.

Použití AMQP

Nejnovější verze klientské sady SDK umožňují interakci s emulátorem v různých programovacích jazycích. Podrobnosti najdete v tématu Klientské sady SDK.

Napřed si projděte ukázky emulátoru služby Event Hubs na GitHubu.

Související obsah

Přehled emulátoru služby Azure Event Hubs