Deploying Spring Boot Application on Kubernetes
In this article, I will explain how you can create a pod, deploy a spring boot application, and manage the single node cluster with Lens IDE on Docker Desktop.
Join the DZone community and get the full member experience.
Join For FreeWhat You Will Learn
- How to enable Kubernetes with Docker Desktop for Mac
- How to create a pod
- How to deploy a working spring boot application on Kubernetes
- How to monitor and manage Kubernetes cluster with Lens IDE
Moving on, you may not know this, but you can have a functional single-node Kubernetes cluster running locally with your Docker Desktop by following the below steps. But wait, What is Docker Desktop?
What is Docker Desktop?
As per the official documentation, Docker Desktop is an application for macOS and Windows machines for the building and sharing of containerized applications and microservices.
You can follow the official Docker Desktop installation guide if you have not installed it already.
How To Enable Kubernetes With Docker Desktop for Mac
Go to Preferences in the Docker menu bar. Then click the Kubernetes tab. Click the checkbox to enable Kubernetes and switch the default orchestrator to Kubernetes. It will take some time to enable Kubernetes.
As per the official documentation, the mac Kubernetes integration provides the Kubernetes CLI command at /usr/local/bin/kubectl. This location may not be in your shell's PATH variable, so you may need to type the full path of the command or add it to the PATH.
kubectl is a Kubernetes CLI tool for running commands against your cluster. Learn more about kubectl here. Now we can verify the setup using the below kubectl command. The output should be something similar to the one below:
Shell
xxxxxxxxxx
1
1
kubectl get nodes
2
NAME STATUS ROLES AGE VERSION
3
docker-desktop Ready master 19d v1.19.3
How To Create a Pod
A pod in Kubernetes is the smallest possible execution unit. It can have one more container in it. However, we will test the setup by creating a simple pod with a single container image on the local Kubernetes cluster by following the below steps. This container runs an Nginx image.
Create a pod using the below YAML file.
YAML
xxxxxxxxxx
1
12
1
apiVersionv1
2
kindPod
3
metadata
4
namenginx
5
labels
6
appnginx
7
spec
8
containers
9
namemycontainer
10
imagedocker.io/nginx
11
ports
12
containerPort80
kubectl create and the name of the YAML file to create a pod.
Shell
x
1
kubectl create -f pod.yaml
2
pod/nginx created
Shell
xxxxxxxxxx
1
1
kubectl get pods
2
NAME READY STATUS RESTARTS AGE
3
nginx 1/1 Running 0 2m38s
kubectl exec command. Once inside the container, we will just use curl to verify the Nginx setup. Let's do that now.
Shell
xxxxxxxxxx
1
25
1
kubectl exec -it nginx -- /bin/sh
2
# curl 10.1.0.65
3
<!DOCTYPE html>
4
<html>
5
<head>
6
<title>Welcome to nginx!</title>
7
<style>
8
body {
9
width: 35em;
10
margin: 0 auto;
11
font-family: Tahoma, Verdana, Arial, sans-serif;
12
}
13
</style>
14
</head>
15
<body>
16
<h1>Welcome to nginx!</h1>
17
<p>If you see this page, the nginx web server is successfully installed and
18
working. Further configuration is required.</p>
19
<p>For online documentation and support please refer to
20
<a href="http://nginx.org/">nginx.org</a>.<br/>
21
Commercial support is available at
22
<a href="http://nginx.com/">nginx.com</a>.</p>
23
<p><em>Thank you for using nginx.</em></p>
24
</body>
25
</html>
How to Deploy a Working Spring Boot Application on Kubernetes
Let's deploy a working Spring Boot application on our local Kubernetes cluster. We will be using the indian-states application for the demo. You can check out this GitHub repository to know more about this application. In my previous article, I have already explained the service and deployment resources for this Kubernetes application.
Now we will just clone this repository and create Kubernetes manifests using the below command.
Shell
xxxxxxxxxx
1
16
1
git clone https://github.com/yrashish/indian-states
2
cd indian-states/k8s
3
kubectl create -f myservice.yaml
4
service/states created
5
kubectl create -f mydeployment.yaml
6
deployment.apps/states created
7
kubectl get all
8
NAME READY STATUS RESTARTS AGE
9
pod/states-6664b9dbf6-l2tgj 1/1 Running 0 8s
10
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
11
service/kubernetes ClusterIP 10.96.0.1 <none> 443/TCP 55s
12
service/states NodePort 10.96.78.225 <none> 8080:31238/TCP 15s
13
NAME READY UP-TO-DATE AVAILABLE AGE
14
deployment.apps/states 1/1 1 1 8s
15
NAME DESIRED CURRENT READY AGE
16
replicaset.apps/states-6664b9dbf6 1 1 1 8s
Shell
xxxxxxxxxx
1
1
curl localhost:31238/states
2
[{“name”:”Andra Pradesh”,”capital”:”Hyderabad”},{“name”:”Arunachal Pradesh”,”capital”:”Itangar”},{“name”:”Assam”,”capital”:”Dispur”},{“name”:”Bihar”,”capital”:”Patna”},{“name”:”Chhattisgarh”,”capital”:”Raipur”},{“name”:”Goa”,”capital”:”Panaji”},{“name”:”Gujarat”,”capital”:”Gandhinagar”},{“name”:”Haryana”,”capital”:”Chandigarh”},{“name”:”Himachal Pradesh”,”capital”:”Shimla”},{“name”:”Jharkhand”,”capital”:”Ranchi”},{“name”:”Karnataka”,”capital”:”Bangalore”},{“name”:”Kerala”,”capital”:”Thiruvananthapuram”},{“name”:”Madhya Pradesh”,”capital”:”Bhopal”},{“name”:”Maharashtra”,”capital”:”Mumbai”},{“name”:”Manipur”,”capital”:”Imphal”},{“name”:”Meghalaya”,”capital”:”Shillong”},{“name”:”Mizoram”,”capital”:”Aizawi”},{“name”:”Nagaland”,”capital”:”Kohima”},{“name”:”Orissa”,”capital”:”Bhubaneshwar”},{“name”:”Rajasthan”,”capital”:”Jaipur”},{“name”:”Sikkim”,”capital”:”Gangtok”},{“name”:”Tamil Nadu”,”capital”:”Chennai”},{“name”:”Telangana”,”capital”:”Hyderabad”},{“name”:”Tripura”,”capital”:”Agartala”},{“name”:”Uttaranchal”,”capital”:”Dehradun”},{“name”:”Uttar Pradesh”,”capital”:”Lucknow”},{“name”:”West Bengal”,”capital”:”Kolkata”},{“name”:”Punjab”,”capital”:”Chandigarh”}]
How To Monitor and Manage Kubernetes Cluster With Lens IDE
Lens IDE for Kubernetes is a desktop application for macOS, Windows, and Linux to manage your cluster. It's completely free and open source. You can download it here. Developers, DevOps engineers, SRE, and also people who are learning Kubernetes on their laptops can use this to view and manage their clusters. Following are some of the highlighted features that it provides.
- Manage multiple clusters with a single IDE
- 360-degree view of your cluster
- Prometheus integration
- Context-aware built-in terminal
- Built-in support for managing Helm charts
After installing it, add a cluster. Lens connects to your Kubernetes cluster using the kubeconfig file which is typically located in your $HOME/.kube directory. You have the option to paste it as a text file also. Now select the kubeconfig file, context, and click on Add cluster.
After adding the cluster you can see it on the left side navigation bar. For demo purposes, I have redeployed the Spring Boot application. Under events, you can see that our application image is getting pulled.
We can also view the logs of the deployment we just completed. As you can see that application is deployed and running.
You can scale, restart, edit, and remove Kubernetes manifests from Lens IDE itself.
Under networks, you can also view Kubernetes services.
Lens has a feature where it allows you to install a Prometheus stack in your cluster so that you can gather metrics about the cluster and its nodes. For installation, right-click on the cluster icon in the Lens UI's top-left corner and select Settings.
On the Settings page, under features, you can see a Metrics section and a button to install Prometheus. Click Install to deploy the Prometheus stack to your cluster.
Lens will start displaying metrics after a minute or so.
We have only covered a handful of features that Lends IDE for Kubernetes provides. It's a wrap for now.
Conclusion
In this article, we have learned how to enable Kubernetes on Docker Desktop for Mac, created a basic pod, deployed a Spring Boot application, and monitored our single-node Kubernetes cluster with the help of Lens IDE. What are you waiting for? Go Containerize and share your applications!
Support Me
If you like what you just read, then you can buy me a coffee by clicking the link in the image below:
Further Reading
You can also read some of my previous articles here.
Topics:
springboot,
docker desktop,
pod,
lens ide,
macos,
kubernetes,
docker and kubernetes
Published at DZone with permission of Ashish Choudhary. See the original article here.
Opinions expressed by DZone contributors are their own.
Comments