使用 Azure 事件中心模拟器在本地进行测试

在运行自动化脚本之前，请在本地克隆模拟器的 GitHub 安装程序存储库。

Windows

使用以下步骤在本地 Windows 上运行事件中心模拟器。

1. 打开 PowerShell 并导航到已使用克隆的cd脚本文件夹所在的目录：

   cd <path to your common scripts folder> # Update this path
   
   

2. 发出 wsl 命令以在此目录中打开 WSL。

   wsl
   
   

3. 运行安装程序脚本./LaunchEmulator.sh 运行脚本会引发两个容器：事件中心模拟器和 Azurite（模拟器的依赖项）。

   ./Launchemulator.sh
   
   

Linux 和 macOS

若要在 Linux 或 macOS 上本地运行事件中心模拟器，请执行以下操作：

• 运行安装脚本 LaunchEmulator.sh。运行该脚本会启动两个容器：事件中心模拟器和 Azurite（模拟器的依赖项）。

1. 若要启动模拟器，请为要使用的实体提供配置。 在本地将以下 JSON 文件保存为 config.json：

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

2. 若要启动事件中心模拟器的容器，请将以下 .yaml 文件保存为 docker-compose.yaml。

name: microsoft-azure-eventhubs
services:
  emulator:
    container_name: "eventhubs-emulator"
    image: "mcr.microsoft.com/azure-messaging/eventhubs-emulator:latest"
    pull_policy: always
    volumes:
      - "${CONFIG_PATH}:/Eventhubs_Emulator/ConfigFiles/Config.json"
    ports:
      - "5672:5672"
      - "9092:9092"
      - "5300:5300"
    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"
    pull_policy: always
    ports:
      - "10000:10000"
      - "10001:10001"
      - "10002:10002"
    networks:
      eh-emulator:
        aliases:
          - "azurite"
networks:
  eh-emulator:

3. 创建 .env 文件以声明事件中心模拟器的环境变量：

   # 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 确认 Microsoft 软件许可条款。 请务必将 .env 文件放置在与 docker-compose.yaml 文件相同的目录中。

   重要

   在 Windows 中指定文件路径时，请使用双反斜杠 (\\) 而不是单反斜杠 (\)，以免与转义字符混淆。

4. 若要运行模拟器，请执行以下命令：

    docker compose -f <PathToDockerComposeFile> up -d
   

与 Kafka 交互时，请确保设置生成者和使用者配置，如下所示：

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

BootstrapServers 和 SaslPassword 的值取决于设置拓扑。 有关详细信息，请参阅与模拟器交互部分。

通过最新的客户端 SDK 版本，可使用各种编程语言与仿真器进行交互。 有关详细信息，请参阅客户端 SDK。