Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Cloud Native Starter for Java EE based Microservices on Kubernetes and Istio

This project contains sample code that demonstrates how to get started with cloud-native applications and microservice based architectures. To get a fast overview of this project use our Cloud Native Starter landing page.

The project has three parts:

  1. Basic concepts: The documentation of this part is below. Cloud Native Starter demonstrates how to develop complete enterprise applications with Java and MicroProfile and how to operate them with Kubernetes, OpenShift and Istio. To get a fast overview of the basic-concepts part, use the basic-concepts landing page.
  1. Reactive: The reactive part explains how to use reactive programming and event based messaging in Quarkus applications and how to run them on Kubernetes and OpenShift. For more open the reactive folder and that part can be used completely separately or to get a fast overview of the reactive part, use the reactive landing page.
  1. Security: The security part explains how to do authentication and authorization in Quarkus applications with Keycloak and how to do network encryption with Istio. For more open the security folder and that part can be used completely separately. For a fast overview of the security part, use the security landing page.

Basic concepts

The first part of the project focusses on how to build microservices with Java EE and the open source technologies Eclipse MicroProfile, Eclipse OpenJ9, AdoptOpenJDK and Open Liberty.

The microservices can easily be deployed on Kubernetes environments running Istio like Minikube, IBM Cloud Kubernetes Service, Red Hat OpenShift in CodeReady Containers or OpenShift on the IBM Cloud.

The project showcases the following functionality:

This diagram shows the key components:

The next screenshot shows the web application. More screenshots are in the images folder.


The sample application can be run in four different environments:

  1. Minikube (locally): See instructions below
  2. IBM Cloud Kubernetes Service - see instructions
  3. CodeReady Containers (Red Hat OpenShift locally) - see instructions
  4. Red Hat OpenShift on the IBM Cloud - see instructions

The following instructions describe how to install everything locally on Minikube.

Important: Before the microservices can be installed, make sure you've set up Minikube and Istio correctly or follow these instructions to set up Minikube and Istio from scratch. This should not take longer than 30 minutes.

Before deploying the application, get the code:

$ git clone
$ cd cloud-native-starter
$ ROOT_FOLDER=$(pwd)

The microservices can be installed via scripts. In addition to Minikube and Istio you need the following tools to be available.


Docker always needs to be installed locally. The tools git, curl and kubectl (and ibmcloud) can be installed locally or you can use a Docker image that comes with these tools.

$ docker run -v $ROOT_FOLDER/:/cloud-native-starter -it --rm ibmcom/ibm-cloud-developer-tools-amd64

Deploy (and redeploy):

$ scripts/
$ scripts/
$ scripts/
$ scripts/
$ scripts/
$ scripts/
$ scripts/

After running the scripts above, you will get a list of all URLs in the terminal.

Example URL to open the web app:

Example API endpoint:

At this point you have seen the "base line" of our Cloud Native Starter. The following documents describe how to implement additional functionality:


Run the following command to delete all cloud-native-starter components from Istio.

$ scripts/

You can also delete single components:

$ scripts/
$ scripts/
$ scripts/
$ scripts/
$ scripts/
$ scripts/


Documentation - Overview

The following slides summarize this repo:


Documentation - Kubernetes and MicroProfile

Documentation - OpenShift