pega_external_kafka_dockers

Pega PE with external kafka for stream services in dockers

Note! Current instruction is used for Pega PE 8.7 and kafka 3.6.0. It might works wrong with other versions

You may use current project for start up Pega PE without stream node type and external kafka for queue processors. OS that was used for this project is ubuntu. In addition you have to have minimum ~10 gb free space

Getting started

Docker

• Before start your host should has the docker and the docker compose. You can install it by using links below:

  Install docker

  Install docker compose

Kafka

• You might read about bitnami/kafka by using this link. However you just can donwload current project with all settings

Configure kafka docker container

• Run the docker-compose file

• Inside kafka docker you should run kafka-storage.sh to generate kafka cluster id (path to script /opt/bitnami/kafka/bin):

        ./kafka-storage.sh random-uuid

• Update docker-compose.yml by generating uuid above

• Next step is to add network for our dockers (you can use any ip you want) and don`t forget to apply a new network for kafka-ui and kafka services:

        networks:
        Your_Network_Name:
            ipam:
            driver: default
            config:
                - subnet: {ip}/16
                gateway: {ip}

• Run docker-compose and check that kafka ui and kafka broker work fine at localhost:8080

Configure Pega PE

• Firstly, you have to prepare pega for next using. You may use this project to install pega with docker. However before build pega image you have to change prconfig.xml from project. Change prconfig.xml and put your gateway_ip from previous step to the line below

        <env name="services/stream/broker/url" value="{gateway_ip}:9092" />

• The following setting allows you to run the application with the required node types: open the docker-compose file with pega services and put next thr line in the environment for pega pe service:

        - NODE_TYPE=Batch,RealTime,BackgroundProcessing,Search,WebUser

• Build and run Pega PE from the project pega-pe-docker

Summary

• If all of the steps were done correctly, then it will be possible to see in pega the external kafka in the normal status (Configure -> Deciding -> Infrastructure -> Services -> Stream). It will possible to see new topics for all QPs in the kafka ui tool