Skip to content

Latest commit

 

History

History
80 lines (57 loc) · 2.24 KB

hello-sentences-app.md

File metadata and controls

80 lines (57 loc) · 2.24 KB
Raw

Say Hello to the Sentences Application

This exercise introduces the example application, aka. the `sentences application and show how to run it both with docker-compose and on Kubernetes.

Running the Sentences Application with Docker Compose

The sentences application consists of three microservices packaged in three different container images. The sentences application can be run on a Docker host using e.g. docker-compose.

Use the following command to start containers with the three microservices that make up the sentences application:

$ docker-compose -f sentences-app/deploy/docker-compose.yaml up

NB: if docker-compose is missing, you can install it with sudo apt install docker-compose

In another shell, use the following command to request sentences from the sentences application:

$ curl 127.0.0.1:8080
Eric is 66 years

Stop the docker-compose deployment with Ctrl-C.

Running the Sentences Application on Kubernetes

Use the following command to deploy the sentences application to Kubernetes:

$ kubectl apply -f sentences-app/deploy/kubernetes

This will create three microservice deployments with a single POD instance each. Use the following command to see the status of each POD instance:

$ kubectl get pods

The front-end microservice for the sentences application is exposed with a Kubernetes service of type NodePort.

When all three PODs are in a running state, use the following commands to look up the actual NodePort used by the frontend microservice:

$ kubectl get svc sentence
NAME        TYPE       CLUSTER-IP      EXTERNAL-IP   PORT(S)          AGE
sentences   NodePort   10.15.245.208   <none>        8080:30250/TCP   37s

In the example above, the relevant NodePort is 30250. Use the following command to look up an external accessible IP address that can be used to access the front-end microservice.

$ kubectl get nodes -o wide

Any of the IP addresses from the EXTERNAL-IP-column can be used.

To request a sentence from the sentences application, use curl with the external IP address and NodePort found above:

$ curl <EXTERNAL-IP>:30250
John is 73 years

Cleanup

$ kubectl delete -f sentences-app/deploy/kubernetes/