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

Rversion finale: Xanadu

Mis à jour 1 août 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 l’instance. Vous devez fournir les détails du magasin de clés de confiance et du magasin de clés lorsque vous configurez un créateur pour créer une rubrique au format Hermes. Consultez Configurer une connexion sécurisée au Service de messagerie Hermes.
Téléchargez et installez Apache Kafka. Consultez Préparez votre Apache Kafka environnement client.

Rôle requis : administrateur

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>.<app_id>.<topic_name>

où :

<instance_name> est le nom de votre instance
<espace de noms> 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 des Service d'exportation de journal rubriques
- sn_streamconnect des Connexion au flux 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

Accédez au répertoire de configuration dans lequel vous avez extrait Kafka.
- Par exemple, sous Unix :
```
cd /home/user/Software/kafka/config
```
- Par exemple, sous Windows :
```
cd C:\Software\kafka\config
```
Configurez un producteur.
1. Ouvrez le fichier 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 magasin de clés
3. Enregistrez vos changements en texte brut.
Accédez à votre répertoire Kafka.

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 votre nom d’instance (sensible à la casse)
<namespace> avec l’espace de noms du domaine auquel appartient votre rubrique Kafka (facultatif)
<app_id> avec l’ID d’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 le Hermes cluster Kafka.

Que faire ensuite

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