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

Freigeben Version: Xanadu

Aktualisiert 1. August 2024

1 Minute Lesedauer

Erstellen Sie ein Thema zum Senden und Empfangen von Testnachrichten im Kafka-Cluster Hermes.

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 für die Erstellung eines Themas in Hermeskonfigurieren. Weitere Informationen finden Sie unter Richten Sie eine sichere Verbindung zum ein Hermes Messaging-Service.
Laden Sie Apache Kafkaherunter, und installieren Sie es. Weitere Informationen finden Sie unter Bereiten Sie Ihre Apache Kafka -Client-Umgebung vor.

Erforderliche Rolle: admin

Warum und wann dieser Vorgang ausgeführt wird

Hermes Kafka-Themen werden anhand der folgenden Konvention benannt:

snc.<instance_name>.<namespace>.<app_id>.<topic_name>

wobei:

<instance_name>ist der Name Ihrer Instanz
<namespace>ist der Namespace der Domäne, 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 -Themen
<topic_name>ist der eindeutige Name für Ihr Thema

Hinweis:

Beim vollständigen Themennamen wird zwischen Groß- und Kleinschreibung unterschieden, und er ist auf 200 Zeichen beschränkt.

Prozedur

Navigieren Sie zu dem Konfigurationsverzeichnis, in das Sie Kafka extrahiert haben.
- Beispiel unter Unix:
```
cd /home/user/Software/kafka/config
```
- Beispiel unter Windows:
```
cd C:\Software\kafka\config
```
Konfigurieren Sie einen Ersteller.
1. Öffnen Sie die Datei 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>mit dem Pfad zu Ihrer Truststore-Datei
  - <keystore password>mit Ihrem Schlüsselspeicher-Passwort
  - <path to keystore.p12>mit dem Pfad zu Ihrer Schlüsselspeicherdatei
3. Speichern Sie Ihre Änderungen im Nur-Text-Format.
Navigieren Sie zu Ihrem Kafka-Verzeichnis.

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>durch den Namespace der Domäne, zu der Ihr Kafka-Thema gehört (optional)
<app_id>mit der Anwendungs-ID (Groß-/Kleinschreibung beachten)
<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

Mit dem Kafka-Client Testnachrichten an ein Thema Hermes erstellen