IBM/Lagom-Liberty-Kubernetes

Name: Lagom-Liberty-Kubernetes

Owner: International Business Machines

Description: null

Created: 2018-02-22 17:49:17.0

Updated: 2018-03-23 07:41:31.0

Pushed: 2018-04-08 14:01:56.0

Homepage: null

Size: 9630

Language: Java

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

Lagom integration with IBM Message Hub and WebSphere Liberty

Lagom is a framework for developing reactive microservices in Java or Scala. Created by Lightbend, Lagom is built on the proven Akka toolkit and Play Framework, and provides a highly productive, guided path for creating responsive, resilient, elastic, message-driven applications.

IBM Message Hub is a fully-managed Apache Kafka service running on the IBM Cloud PaaS. It exposes a native Kafka interface, so Lagom services can communicate with it using the standard Lagom Message Broker API.

This project demonstrates a simple service that integrates with the IBM Message Hub Kafka Liberty sample application. The source code demonstrates how to write a Lagom service that can both consume messages produced by the Liberty sample application, and produce messages that can be consumed by it. You can run the service in a local development environment, a local Kubernetes cluster created using IBM Cloud Private ICP, or in the cloud using IBM Cloud Container Service.

Flow

architect

  1. User sets up message hub
  2. User sets up Lagom service
  3. User edit and build the sample app in local Liberty server
  4. User deploys the app to IBM Cloud Container Service
  5. User deploys the app to IBM Cloud Private
Included components

Lagom
IBM Message Hub
IBM Cloud Private
IBM Cloud Container Service
IBM Liberty
Apache Kafka

Steps
  1.  Prerequisites
  2.  Gather Message Hub credentials
  3.  Download and set up the Lagom service
  4.  Next steps
Video on the pattern

Video

Prerequisites

To build and run this example, you need:

Gather Message Hub credentials

Follow these steps to get a copy of the Message Hub credentials that are needed for the Lagom service to authenticate with Message Hub.

  1. Log in to the IBM Cloud console.
  2. Navigate to the Message Hub service you have created.
  3. Navigate to “Service credentials”.
  4. Create new credentials if needed (no special parameters are required).
  5. Click “View credentials”.
  6. Copy the following credential values to use in the Lagom service:
    • "kafka_brokers_sasl" ? Note: the Lagom service requires the list of brokers to be formatted as a single-line, comma-separated list of hostname:port pairs. For example: "host1:port1,host2:port2".
    • "user"
    • "password"
Download and set up the Lagom service

Follow these steps to get a local copy of this project and configure it with the Message Hub credentials you saved in the previous step.

  1. Open a command line shell and clone this repository:

    clone https://github.com/lagom/ibm-integration-examples.git

  2. Change into the root directory for this example:

    bm-integration-examples/lagom-message-hub-liberty-integration-example

  3. Open the message-hub-liberty-integration-impl/src/main/resources/message-hub.conf file in a text editor and fill in the empty values of the brokers, user and password properties from the credentials retrieved above.

    Note: Be sure not to commit this file with your credentials in it.

Next steps

Now that the project has been downloaded and configured, you can proceed to running it in any of these three ways:

Links
License

Apache 2.0

This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.