Erstellen Sie mit dem Kafka-Client ein Testthema in Hermes .

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 1 Minute Lesedauer
  • Erstellen Sie ein Thema zum Senden und Empfangen von Testnachrichten im Hermes Kafka-Cluster.

    Vorbereitungen

    Sichern Sie Ihre Kafka-Themen, indem Sie ein von der Instanz ServiceNow® signiertes Zertifikat und einen Schlüsselspeicher generieren. Sie müssen Truststore- und Schlüsselspeicherdetails angeben, wenn Sie einen Ersteller zum Erstellen eines Themas in Hermeskonfigurieren. Weitere Informationen finden Sie unter Richten Sie eine sichere Verbindung zum ein Hermes Messaging-Service.

    Erforderliche Rolle: admin

    Warum und wann dieser Vorgang ausgeführt wird

    Hermes Kafka-Themen werden nach der folgenden Konvention benannt:

    snc.<instance_name>.<namespace>.sn_<app_id>.<topic_name>
    wobei:
    • <instance_name>ist der Name Ihrer Instanz
    • <namespace>der Namespace der Domäne ist, zu der Ihr Kafka-Thema gehört (optional)
    • <app_id>ist Ihre Anwendungs-ID

      Das von Ihnen erstellte Thema gehört zu dieser Anwendung. Geben Sie eine der folgenden Optionen an:

      • sn_logstoanalytics für Log Export Service Themen
      • sn_streamconnect für Stream Connect für Apache Kafka Themen
    • <topic_name>ist der eindeutige Name für Ihr Thema
    Hinweis:
    Beim vollständigen Themennamen wird zwischen Groß- und Kleinschreibung unterschieden. Er darf maximal 200 Zeichen enthalten.

    Prozedur

    1. Laden Sie Apache Kafkaherunter, und installieren Sie sie.
      1. Laden Sie die herunter Apache Kafka Binärdateien.
      2. Entpacken Sie das Kafka-Paket, indem Sie den folgenden Befehl ausführen:
        tar -zxvf kafka_2.13-3.1.2.tgz
    2. Navigieren Sie zum Kafka-Verzeichnis, indem Sie den folgenden Befehl ausführen:
      cd kafka_2.13-3.1.2
    3. Konfigurieren Sie einen Ersteller.
      1. Öffnen Sie die Datei config/producer.properties.
      2. Konfigurieren Sie die folgenden SSL-Eigenschaften:
        security.protocol=SSL
        
        ssl.truststore.password=<truststore password>
        
        ssl.truststore.location=<path to truststore.p12>
        
        ssl.truststore.type=PKCS12
        
        ssl.keystore.password=<keystore password>
        
        ssl.keystore.location=<path to keystore.p12>
        
        ssl.keystore.type=PKCS12
        
        ssl.key.password=<keystore password>
        Ersetzen Sie die folgenden Platzhaltervariablen:
        • <truststore password>mit Ihrem Truststore-Passwort
        • <path to truststore.p12>durch den Pfad zu Ihrer Truststore-Datei
        • <keystore password>mit Ihrem Schlüsselspeicher-Passwort
        • <path to keystore.p12>durch den Pfad zu Ihrer Schlüsselspeicherdatei
    4. Erstellen Sie ein Testthema, indem Sie den folgenden Befehl ausführen:
      • Unix:
        ./bin/kafka-topics.sh --create --topic snc.<instance_name>.<namespace>.sn_<app_id>.<topic_name> --command-config ./config/producer.properties --bootstrap-server <instance_name>.service-now.com:4000,<instance_name>.service-now.com:4001,<instance_name>.service-now.com:4002,<instance_name>.service-now.com:4003
      • Windows:
        ./bin/windows/kafka-topics.bat --create --topic snc.<instance_name>.<namespace>.sn_<app_id>.<topic_name> --command-config ./config/producer.properties --bootstrap-server <instance_name>.service-now.com:4000,<instance_name>.service-now.com:4001,<instance_name>.service-now.com:4002,<instance_name>.service-now.com:4003
      Ersetzen Sie die folgenden Platzhaltervariablen:
      • <instance_name>mit Ihrem Instanznamen (Groß-/Kleinschreibung beachten)
      • <namespace>mit dem Namespace der Domäne, zu der Ihr Kafka-Thema gehört (optional)
      • <app_id>mit der Anwendungs-ID (Groß-/Kleinschreibung beachtet)
      • <topic_name>mit dem eindeutigen Themennamen, den Sie verwenden möchten (Groß-/Kleinschreibung beachten)

    Ergebnisse

    Im Kafka-Cluster Hermes wird ein Testthema erstellt.

    Nächste Maßnahme

    Testnachrichten an ein Hermes -Thema mit dem Kafka-Client erstellen