Azure Event Hubs öykünücüsü kullanarak yerel olarak test edin

Azure Event Hubs öykünücüsü, geliştiricilerin buluta bağlanmadan uygulamalarını yerel olarak test etmelerini ve doğrulamalarını sağlar. Bu kılavuz, Docker veya otomatik betikler kullanarak emülatörü ayarlamak, çalıştırmak ve emülatör ile etkileşim kurmak için adım adım yönergeler sağlar.

Prerequisites

• Docker desktop
• En düşük donanım gereksinimleri:
  • 2 GB RAM
  • 5 GB disk alanı
• Linux için Windows Alt Sistemi (WSL) yapılandırması (yalnızca Windows için):
  • Install WSL
  • Docker'ı WSL kullanacak şekilde yapılandırma

Note

Bu makaledeki adımlara devam etmeden önce Docker Desktop'ın arka planda çalışır durumda olduğundan emin olun.

Azure Event Hubs emülatörünü çalıştırın

Otomatik bir betik veya Linux kapsayıcısı kullanarak Azure Event Hubs öykünücüyü çalıştırın. Geliştirme ortamınıza en uygun yöntemi seçin.

Automated script

Otomatik bir betik çalıştırmadan önce öykünücünün GitHub yükleyici deposunu yerel olarak kopyalayın.

Windows

Event Hubs öykünücüslerini Windows'da yerel olarak çalıştırmak için aşağıdaki adımları kullanın.

1. PowerShell'i açın ve kullanarak cd betikler klasörünün kopyalandığı dizine gidin:

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

2. WSL'yi bu dizinde açmak için wsl komutu gönderin.

   wsl
   
   

3. Kurulum betiğini çalıştırın./LaunchEmulator.sh Betiği çalıştırmak iki kapsayıcı getirir: Event Hubs öykünücüsü ve Azurite (öykünücü için bir bağımlılık).

   ./Launchemulator.sh
   
   
   

Linux ve macOS

Event Hubs öykünücüsİnİ Linux veya macOS üzerinde yerel olarak çalıştırmak için:

• Kurulum betiğini LaunchEmulator.sh çalıştırın. Betiği çalıştırmak iki kapsayıcı getirir: Event Hubs öykünücüsü ve Azurite (öykünücü için bir bağımlılık).

Docker (Linux kapsayıcısı)

1. Öykünücüyü başlatmak için, kullanmak istediğiniz varlıklar için bir yapılandırma sağlayın. Aşağıdaki JSON dosyasını yerel olarak config.json olarak kaydedin:

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

2. Event Hubs öykünücüsü için kapsayıcıları çalıştırmak için aşağıdaki .yaml dosyasını docker-compose.yaml olarak kaydedin.

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. Event Hubs öykünücüsü için ortam değişkenlerini bildirmek için bir .env dosyası oluşturun:

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

   bağımsız değişkeni ACCEPT_EULA Microsoft Yazılım Lisans Koşulları'nı onaylar. .env dosyasını docker-compose.yaml dosyasıyla aynı dizine yerleştirdiğinizden emin olun.

   Important

   Windows'ta dosya yolları belirtirken, kaçış karakterleriyle karışıklığı önlemek için tek ters eğik çizgi () yerine çift ters eğik\\ çizgi (\) kullanın.

4. Öykünücüyü çalıştırmak için aşağıdaki komutu yürütün:

    docker compose -f <PathToDockerComposeFile> up -d
   

Adımlar başarılı olduktan sonra Docker'da çalışan kapsayıcıları bulabilirsiniz.

Öykünücü ile etkileşim kurma

Öykünücü varsayılan olarak config.json yapılandırma dosyasını kullanır. Yapılandırma dosyasında değişiklik yaparak varlıkları (Event Hubs/ Kafka konuları) yapılandırabilirsiniz. Daha fazla bilgi edinmek için yapılandırma değişiklikleri yapma adresini ziyaret edin

Event Hubs öykünücüsine bağlanmak için aşağıdaki bağlantı dizesi kullanabilirsiniz:

• Öykünücü kapsayıcısı ve etkileşimli uygulama yerel makinede yerel olarak çalışırken aşağıdaki bağlantı dizesi kullanın:

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

• Farklı makinedeki ve aynı yerel ağdaki uygulamalar (Kapsayıcılı/Kapsayıcısız) makinenin IPv4 adresini kullanarak Öykünücü ile etkileşimde bulunabilir. Aşağıdaki bağlantı dizesi kullanın:

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

• Aynı köprü ağında yer alan uygulama kapsayıcıları, Diğer adını veya IP'sini kullanarak Öykünücü ile etkileşimde bulunabilir. Aşağıdaki bağlantı dizesi Öykünücüsü adının varsayılan değeri "eventhubs-emulator" olduğunu varsayar:

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

• Farklı köprü ağındaki uygulama kapsayıcıları, "host.docker.internal" öğesini konak olarak kullanarak Öykünücü ile etkileşimde bulunabilir. Aşağıdaki bağlantı dizesi kullanın:

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

Using Kafka

Kafka ile etkileşim kurarken Üretici ve tüketici yapılandırmasını aşağıdaki gibi ayarladığınızdan emin olun:

        {
            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 ve SaslPassword değeri kurulum topolojinize bağlıdır. Ayrıntılar için Öykünücü ile etkileşim kurma bölümüne bakın.

Important

Kafka kullanılırken yalnızca Üretici ve tüketici API'leri Event Hubs öykünücüsü ile uyumludur.

Using AMQP

En son istemci SDK sürümleriyle, öykünücü ile çeşitli programlama dillerinde etkileşim kurabilirsiniz. Ayrıntılar için bkz . İstemci SDK'ları.

Başlamak için GitHub'daki Event Hubs öykünücüsü örneklerine bakın.

Related content

Azure Event Hubs öykünücüsine genel bakış
GitHub'da Event Hubs emülatör örnekleri