Showcase Istio’s Distributed Tracing via a (minimally) instrumented set of Spring Boot applications

1. Openshift 3.10 cluster

2. Istio 1.0.x installed on the aforementioned cluster using the Istio Operator.

   1. Follow these instructions for more information about the Operator

3. Login to the cluster with the admin user

Create a new project/namespace on the cluster. This is where your application will be deployed.

In OpenShift each service account must be granted permissions with the anyuid and privileged Security Context Constraints (SCC) to enable the sidecars to run correctly.

With Fabric8 Maven Plugin (FMP)

mvn clean fabric8:deploy -Popenshift

With Source to Image build (S2I)

    find . | grep openshiftio | grep application | xargs -n 1 oc apply -f

    oc new-app --template=istio-distributed-tracing-example-greeting-service -p SOURCE_REPOSITORY_URL=https://github.com/snowdrop/istio-distributed-tracing-example -p SOURCE_REPOSITORY_REF=master -p SOURCE_REPOSITORY_DIR=spring-boot-istio-distributed-tracing-greeting-service
    oc new-app --template=istio-distributed-tracing-example-cute-name-service -p SOURCE_REPOSITORY_URL=https://github.com/snowdrop/istio-distributed-tracing-example -p SOURCE_REPOSITORY_REF=master -p SOURCE_REPOSITORY_DIR=spring-boot-istio-distributed-tracing-cute-name-service

1. Create a RouteRule to forward traffic from istio-ingress to the demo application

       oc create -f rules/greeting-gateway.yml

2. Access the application

   Run the following command to determine the appropriate URL to access our demo. Make sure you access the url with the HTTP scheme. HTTPS is NOT enabled by default:

   echo http://$(oc get route istio-ingressgateway -o jsonpath='{.spec.host}{"\n"}' -n istio-system)/greeting/

   The result of the above command is the istio-system istio-ingress URL, appended with the RouteRule path. Open this URL in your a web browser.

3. Follow the instructions in the application UI

1. Access the Jaeger tracing dashboard

   The traces from the invocation of the two endpoints should look like the following:

   

   Note that it could take a few seconds for all the spans to be collected and presented in a trace that matches the picture above

With Fabric8 Maven Plugin (FMP)

mvn fabric8:undeploy

With Source to Image build (S2I)

oc delete all --all
oc delete ingress --all
find . | grep openshiftio | grep application | xargs -n 1 oc delete -f

Remove the namespace

oc delete project <your project name>

To run integration tests, create a new namespace and run maven job