Installing on Kubernetes


One easy way if installing Microcks is to do it on Kubernetes. Kubernetes in version 1.6 or greater is required. It is assumed that you have some kind of Kubernetes cluster up and running available. This can take several forms depending on your environment and needs :

  • Lightweight Minikube on your laptop, see Minikube project page,
  • Google Cloud Engine account in the cloud, see how to start a Free trial,
  • Any other Kubernetes distribution provider.
We provide basic Kubernetes manifest for simple needs but also a Chart for using with Helm Packet Manager. This is definitely the preferred way of installing apps on Kubernetes.
Just clone the GitHub repository, go to Helm directory and install the chart with these commands:
git clone
cd microcks/install/kubernetes/helm
helm install ./microcks --name microcks --namespace=microcks

After some minutes and components have been deployed, you should end up with a Spring-boot Pod, a MongoDB Pod, a Postman-runtime Pod, a Keycloak Pod and a PostgreSQL Pod like in the screenshot below.

Now you can retrieve the URL of the created ingress using kubectl get ingress -n microcks. Before starting playing with Microcks, you'll have to connect to Keycloak component in order to configure an identity provider or define some users for the Microcks realm (see Keycloak documentation). Connection to Keycloak can be done using username and password stored into a microcks-keycloak-config secret created during setup.