Overview

In this tutorial we will show how to build two simple examples of serverless enabled microservice architecture.

In the first one we will explore how events coming from Kafka can trigger the execution of a serveless component that, based on the payload of the event, will query an external service.

In the second example we will see how variations in a NoSQL database can trigger events and get visualized.

Prerequisites

• having a running OpenShift cluster or CodeReady Containers (v4.6+)
• have cluster admin rights on the cluster to install some of the components
• having installed Serverless operators on the cluster like this
• having prepared the cluster for Fuse deployment
• having a working version of Apache Maven v3.8.1 minimum
• updating the maven settings to point to Red Hat repository like this

---

Components setup

AMQ Streams installation

You first need to install AMQ Streams operator like this
AMQ Streams as an Operator will give you access to the whole Kafka ecosystem managed in a kubernetes way

You can then create a Kafka cluster by providing a CR Kafka definition to the AMQ Streams Operator (you can find an example of definition here)
As you might have noticed, I've added a configMap to the definition, which you can find here to enable advanced monitoring of your Kafka cluster using Prometheus

monitoring AMQ Streams

Serverless installation

You would need as a starter to install Knative operator like this.
As you can read in the documentation, Serverless platform feature includes 3 main components:

1. Knative Serving
2. Knative Eventing
3. Knative Kafka here

You would need to instatiate all 3 of them for this demo.

create event source kafkasource in case of connecting directly kafkasource with serving endpoint otherwise connect kafkasource to default knative broker and then create trigger with filtering

monitoring Knative components

You can monitor the health of Serverless components by using the embdedded Monitoring stack inside OpenShift.
For more information you can check the docs

---

First example

The first example is composed of a Fuse and a Quarkus microservice. The following is the dependency workflow

  graph TD;
    A(Fuse: SwaggerUI) -->|User sends a request| B[Fuse: REST]
    B --> C[Fuse: logging]
    C --> |Fuse prepares the msg| D[Fuse: to Kafka]
    D --> E(Kafka topic)
    F(Knative: KafkaSource) --> |notification to Eventing| E
    F --> G(Knative: Broker)
    G --> |channel - filtering| H(Knative:Trigger)
    H --> I(Knative: Serving)
    I --> L(Quarkus: REST)
    L --> |calling external web service| M[Quarkus: REST client]
    M --> |Quarkus reads the reply| N[Quarkus: to Kafka]
    N --> E
    style A fill:#f00
    style B fill:#f00
    style C fill:#f00
    style D fill:#f00
    style E fill:#f80
    style F fill:#ff0
    style G fill:#ff0
    style H fill:#ff0
    style I fill:#ff0
    style L fill:#0f0
    style M fill:#0f0
    style N fill:#0f0

Fuse project

description

deployment

JKube plugin is added to the POM docs
You can use the following command to deploy on OpenShift (assuming you are logged in):
mvn install -Popenshift

Quarkus project

description

deployment

Quarkus is quite easy to deploy on several platform, you can find more details on this here
You can use the following command to deploy on OpenShift (please notice the serverless (knative) deployment parameter in the application.properties)
To deploy on top of OpenShift you can use the following:
mvn clean package -Dquarkus.kubernetes.deploy=true

usage

---

Second example

flow

The second example is composed of a MongoDB database and a very simple GO microservice.
The following is the dependency workflow

  graph TB;
    A(MongoUI) -->|User adds a document| B[MongoDB]
    B <--> |Kamelet MongoDB Source| C[Knative: Eventing]
    C --> D[Knative: Serving]
    D --> |Capture incoming Cloud Events| E(GO: logging)
    style A fill:#f00
    style B fill:#f00
    style C fill:#ff0
    style D fill:#ff0
    style E fill:#0ff

MongoDB deployment

In my case I installed MongoDB based on a Helm template from bitnami here
The values I used in the chart are here

https://dev.to/tylerauerbeck/deploying-bitnami-s-postgres-helm-chart-on-openshift-1mcl

the modification I introduced are related to securitycontext and are needed to deploy correctly on top of OpenShift

Kamelet MongoDB Source

This serverless eventing source is based off this kamelet component tracking id option working only with capped collection (https://www.mongodb.com/docs/manual/reference/glossary/#std-term-capped-collection)

Knative: Serving

serving with event display

usage

Open mongo-ui interface leverage mongo-ui check the pod logs