Créer une rubrique de test dans Hermes l’utilisation du client Kafka

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 magasin de ServiceNow® clés signés par l’instance. Vous devez fournir des détails de magasin de clés et de confiance lorsque vous configurez un créateur pour créer une rubrique dans Hermes. Consultez Établissez une connexion sécurisée au Service de messagerie Hermes.
• Téléchargez et installez Apache Kafka. Consultez Préparer l’environnement de votre Apache Kafka client.

Rôle requis : admin

Pourquoi et quand exécuter cette tâche

Le nom complet Hermes de la rubrique Kafka est composé des éléments suivants :

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 votre rubrique Kafka appartient (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 Service d'exportation de journal les rubriques
  • sn_streamconnect pour Connexion au flux les rubriques
• <topic_name> est le nom unique de votre rubrique

Remarque :

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

Procédure

1. Accédez au répertoire de configuration dans lequel vous avez extrait Kafka.
   • Par exemple, sur Unix :

     cd /home/user/Software/kafka/config

   • Par exemple, sur Windows :

     cd C:\Software\kafka\config

2. 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 clés de confiance
      • < Mot de passe du magasin de clés > avec votre mot de passe de magasin de clés
      • <chemin d’accès à keystore.p12> avec le chemin d’accès à votre fichier de magasin de clés
   3. Enregistrez vos changements en texte brut.
3. Accédez à votre répertoire Kafka.
4. 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)
   • <espace de noms> avec l’espace de noms du domaine auquel votre rubrique Kafka appartient (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

Créez des messages de test pour une rubrique à l’aide du Hermes client Kafka