Skip to main contentFreight Trust

Kafka Query

Kafka-based Command Query Responsibility Segregation (CQRS) and event sourcing patterns.
Overview
Build
Run
Usage Details

Overview

Description: Main goal of the Order Management component is to manage B2B Messaging utilziing the Command Query Responsibility Segregation (CQRS) Pattern.

Kafka topics consumed from:

Kafka topics produced to: None

Events reacted to:

Events produced: None

EDA Patterns implemented:

  • Command Query Responsibility Segregation (CQRS)

Build

This microservice is built using the Appsody development framework. The Appsody CLI is a required prerequisite for building the application locally.

  • You can optionally specify a container tag. If left blank, latest will be used.
  • You can optionally supply the --push flag to automatically push the built image to specified remote repository.

Performing an Appsody build will update the app-deploy.yaml file in the same directory with current information for the application image, labels, and annotations fields.

Run

Deployment parameters

The following deployment parameters are defined in the app-deploy.yaml file:

NameRequiredDescription
KAFKA_BROKERSYESComma-separated list of Kafka brokers to connect to
KAFKA_APIKEYNOAPI Key used to connect to SASL-secured Kafka brokers. This is required when connecting to Event Streams clusters.
TRUSTSTORE_ENABLEDNORequired to be set to true when connecting to Event Streams on the Cloud Pak for Integration (CP4I).
TRUSTSTORE_PATHNOThe local path to the required truststore file when connecting to Event Streams on CP4I. See Volume Mounts below.
TRUSTSTORE_PWDNOThe password for the truststore file used for Event Streams server verification.
ORDER_TOPICYESThe topic name used for communication relating to the orders entity.
CONTAINER_TOPICYESThe topic name used for communication relating to the containers entity.
ERROR_TOPICYESThe topic name used for communication relating to general application errors.

Volume Mounts

The Order Query microservice requires up to one file to be injected at runtime for proper operation. As noted in the TRUSTSTORE_PATH parameter above, these files are SSL-based certificates which are required to verfiy the identity of the external service when calling it. These files are provided as --docker-options "-v host-src:container-dest ..." when running the microservice locally and as a Volume Mount when running the microservice on a Kubernetes cluster.

The TRUSTSTORE_PATH parameter is documented in the Event Streams Certificates section of the Prerequisites page. The Appsody run command should include a parameter similar to -v /Users/myuser/Downloads/es-cert.jks:/config/resources/security/es-ssl/es-cert.jks in its --docker-options string to run this microservice locally.

Example: appsody run --docker-options "-v /Users/myuser/Downloads/es-cert.jks:/config/resources/security/es-ssl/es-cert.jks" ...

Running the microservice locally

When running the microservice locally, you must specify all the required deployment parameters from above as environment variables via the --docker-options flag being passed in from the Appsody CLI command.

Example: appsody run --docker-options "-e KAFKA_BROKERS=remotebroker1:9092,remotebroker2:9092 -e ORDER_TOPIC=orders -e CONTAINERS_TOPIC=containers -v /Users/myuser/Downloads/es-cert.jks:/config/resources/security/es-ssl/es-cert.jks" ...

For more details on running the microservice locally, consult the Appsody run documentation as well as the deployment information contained in the app-deploy.yaml file.

Running the microservice remotely

The Appsody Operator is a required prerequisite for deploying the microservice to a remote Kubernetes or OpenShift cluster.

To deploy the microservice to a remote cluster:

appsody deploy <yournamespace>/kcontainer-order-query-ms[:tag] --no-build

  • You can omit the --no-build flag to have Appsody perform a build before deploying the application.
  • Note: Performing a build at deploy time requires specifying the absolute container reference path, as well as the --push flag.
  • The neccesary deployment parameter information will be read from the app-deploy.yaml file in the same directory.

Usage Details

REST APIs

REST APIs documentation via Swagger