Créer une rubrique de test à Hermes l’aide du client Kafka

Rversion finale: Washingtondc

Mis à jour 1 févr. 2024

2 minutes de lecture

Créez une rubrique pour l’envoi et la réception de messages de test dans le Hermes cluster Kafka.

Avant de commencer

Sécurisez vos rubriques Kafka en générant un certificat et un ServiceNow® magasin de clés signés par une instance. Vous devez fournir les détails du magasin de confiance et du magasin de clés lorsque vous configurez un créateur pour créer une rubrique dans Hermes. Consultez Configurer une connexion sécurisée au Service de messagerie Hermes.

Rôle requis : admin

Pourquoi et quand exécuter cette tâche

Hermes Les rubriques Kafka sont nommées à l’aide de la convention suivante :

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

où :

<instance_name> est le nom de votre instance
<namespace> est l’espace de noms du domaine auquel appartient votre rubrique Kafka (facultatif)
<app_id> est votre ID d’application
La rubrique que vous créez appartient à cette application. Spécifiez l’une des options suivantes :
- sn_logstoanalytics pour Log Export Service les rubriques
- sn_streamconnect des Connexion au flux pour Apache Kafka rubriques
<topic_name> est le nom unique de votre rubrique

Remarque :

Le nom complet de la rubrique est sensible à la casse et limité à 200 caractères.

Procédure

Téléchargez et installez Apache Kafka.
1. Télécharger le Apache Kafka Binaires.
2. Décompressez le package Kafka en exécutant la commande suivante :
```
tar -zxvf kafka_2.13-3.1.2.tgz
```
Accédez au répertoire Kafka en exécutant la commande suivante :
```
cd kafka_2.13-3.1.2
```
Configurez un producteur.
1. Ouvrez le fichier config/producer.properties .
2. Configurez les propriétés SSL suivantes :
```
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>
```
  Remplacez les variables d’espace réservé suivantes :
  - < mot de passe du magasin de confiance > avec votre mot de passe du magasin de confiance
  - <chemin d’accès à truststore.p12> avec le chemin d’accès à votre fichier de magasin de confiance
  - <mot de passe du keystore> avec votre mot de passe du keystore
  - <chemin d’accès à keystore.p12> avec le chemin d’accès à votre fichier de magasin de clés

Créez une rubrique de test en exécutant la commande suivante :

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

Remplacez les variables d’espace réservé suivantes :

<instance_name> avec le nom de votre instance (sensible à la casse)
<namespace> avec l’espace de noms du domaine auquel appartient votre rubrique Kafka (facultatif)
<app_id> avec l’ID de l’application (sensible à la casse)
<topic_name> avec le nom de rubrique unique que vous souhaitez utiliser (sensible à la casse)

Résultats

Une rubrique de test est créée dans la Hermes grappe Kafka.

Que faire ensuite

Produire des messages de test pour une Hermes rubrique à l’aide du client Kafka