Logistics Wizard with Kubernetes

This repository is part of the larger Logistics Wizard project.

Overview

In this variation of the Logistics Wizard deployment, the ERP and Controller services are deployed as containers within a Kubernetes cluster. The web user interface stays deployed as a Cloud Foundry application.

Prerequisites

1. Ensure you have a GitHub account.

2. Ensure you have a Bluemix account.

3. Ensure you have a Kubernetes cluster in IBM Bluemix Container Service with Kubernetes 1.7.4 or newer installed.

4. Install Istio 0.2.6 from https://istio.io/docs/tasks/installing-istio.html in your Kubernetes cluster

   The following commands should be executed once you have retrieved the Istio installation:

   kubectl apply -f install/kubernetes/istio.yaml
   kubectl apply -f install/kubernetes/addons/prometheus.yaml
   kubectl apply -f install/kubernetes/addons/grafana.yaml
   kubectl apply -f install/kubernetes/addons/servicegraph.yaml
   

Deploy the toolchain in IBM Bluemix

1. Ensure you have 1GB of free memory and space for 4 additional services in your Bluemix organization.

2. It is recommended to create a new space named logistics-wizard-kube in your Bluemix organization. This helps grouping the apps and services together in the console.

3. To get started, click this button:

   

4. The toolchain configuration page opens.

5. Give a name to your toolchain. This name is used as the prefix for the deployed applications. The name must be unique within your organization.

   A simple trick is to use your name or initials or to leave the default generated name.

6. Select the GitHub box.

7. Optionally change the name of the GitHub repositories that will be created in your GitHub account.

   You can choose to fork the main repositories so that you can import changes as they become available or to clone the repositories.

8. Select the Delivery Pipeline box.

9. Give a unique name to the Logistics Wizard web application

10. Select the region, organization and space where you want to deploy the application.

    ⚠️ Make sure the organization and the space have no space in their names.

    ⚠️ Only the US South region is currently supported.

11. Select the region, organization and space where quota for IBM Containers have been specified. If you never used the IBM Containers before, you may need to initialize one space with IBM Container quotas.

12. Specify a Bluemix API key. You can obtain one using bx iam api-key-create my-new-key or from the Bluemix console under Manage / Security / Bluemix API Keys. The API key is used to interact with the Bluemix Container Service.

13. Specify the name of the existing Kubernetes cluster where you have installed Istio.

14. Click Create

15. Once the toolchain is created, you will end up with several delivery pipelines for all applications in the sample. Wait for the pipelines to build all Docker images and deploy all the apps. You can open all pipelines in new browser tabs to follow the deployments or you can wait for all apps to be ready in the Bluemix dashboard.

16. Your apps are deployed. Head over the walkthrough for a tour of the app.

Using the Istio addons

Grafana

The Grafana addon provides an Istio dashboard visualization of the metrics (request rates, success/failure rates) in the cluster.

kubectl port-forward $(kubectl get pod -l app=grafana -n istio-system -o jsonpath='{.items[0].metadata.name}') -n istio-system 3000:3000

http://localhost:3000/dashboard/db/istio-dashboard

dotviz

Servicegraph shows the connections between services.

kubectl port-forward $(kubectl get pod -l app=servicegraph -n istio-system -o jsonpath='{.items[0].metadata.name}') -n istio-system 8088:8088

http://localhost:8088/dotviz

Uninstall Istio

kubectl delete -f install/kubernetes/addons/
kubectl delete -f install/kubernetes/istio.yaml