{"id":1994,"date":"2022-02-05T12:00:00","date_gmt":"2022-02-05T11:00:00","guid":{"rendered":"https:\/\/kindsonthegenius.com\/blog\/setup-kubernetes-locally-deploy-springboot-application-step-by-step-tutorial\/"},"modified":"2026-07-05T03:26:19","modified_gmt":"2026-07-05T01:26:19","slug":"setup-kubernetes-locally-deploy-springboot-application-step-by-step-tutorial","status":"publish","type":"post","link":"https:\/\/kindsonthegenius.com\/blog\/setup-kubernetes-locally-deploy-springboot-application-step-by-step-tutorial\/","title":{"rendered":"Setup Kubernetes Locally \u2013 Deploy SpringBoot Application \u2013 Step by Step Tutorial"},"content":{"rendered":"

In this tutorial, you will learn how to easily setup local Kubernetes cluster. Then we would create a simple Spring Boot application and deploy to Kubernetes. I would be explaining each step as I go.<\/p>\n

In the next tutorial, we would learn how to deploy both database and application to Kubernetes cluster. Finally, we’ll learn how to automate the deployment using a Helm Chart.<\/p>\n

    \n
  1. Overview of Kubernetes and its Components<\/a><\/li>\n
  2. Setup Local Kubernetes Cluster (Minikube)<\/a><\/li>\n
  3. Build the SpringBoot Image<\/a><\/li>\n
  4. Create the Deployment<\/a><\/li>\n
  5. Create the Service<\/a><\/li>\n
  6. Access the Minikube Dashboard<\/a><\/li>\n<\/ol>\n

     <\/p>\n

    1. Overview of Kubernetes and its Components<\/strong><\/h4>\n

    Kubernetes is a container orchestration platform that helps you create and deploy images of of your application. To understand how it works, you need to know about these components.<\/p>\n

    Cluster<\/strong> – A cluster in Kubernetes has the same meaning as in other contexts. It is a collection of nodes (or Virtual Machines)<\/p>\n

    Minikube<\/strong> – Minikube is simply a local Kubernetes. In this way you don’t need to a cloud environment to learn and develop Kubernetes.<\/p>\n

    Node<\/strong> – A node is a single virtual machine. Think of it as a single computer.<\/p>\n

    Pod<\/strong> – A pod is the smallest unit of deployment in Kubernetes.\u00a0 A node can contain one or more pod. So your application actually runs in containers called pods.<\/p>\n

     <\/p>\n

    2. Setup Local Kubernetes Cluster<\/strong><\/h4>\n

    We would go through how to setup and test Kubernetes cluster on Mac. And it would be just a few simple steps.<\/p>\n

    Step 1<\/strong> – Download and install Docker (it’s quite simple but you can find steps here)<\/p>\n

    Step 2<\/strong> – Install Minikube. For Mac, the easiest way is the use Homebrew via the command<\/p>\n

    brew install minikube\r\n<\/pre>\n
    Other ways to install here – https:\/\/minikube.sigs.k8s.io\/docs\/start\/<\/a><\/p>\n
    You can also see learn about Docker, Containers and Kubernetes here<\/a><\/p>\n
    Step 3<\/strong> – Start Kubernetes using the following command:<\/p>\n
    minikube start\r\n<\/pre>\n
    This command starts the local kubernetes cluster.<\/p>\n
     <\/p>\n
    3. Build the Image of Your SpringBoot Application<\/strong><\/h4>\n
    You need to have an existing Spring Boot application. Now we would first create a Dockerfile, then we use the Dockerfile to build an image of our SpringBoot application.<\/p>\n
    Step 1<\/strong> – Create a Dockerfile. The content is shown below:<\/p>\n
    FROM adoptopenjdk\/openjdk11:alpine-jre\r\nADD target\/fleetmsv2-0.0.1-SNAPSHOT.jar app.jar\r\nENTRYPOINT [\"java\",\"-jar\",\"\/app.jar\"]\r\n<\/pre>\n
     <\/p>\n
    Step 2<\/strong> – Run the application to create the jar file.<\/p>\n
    Step 3<\/strong> – Run this command to make Kubernetes work with your local Docker installation<\/p>\n
    eval $(minikube docker-env)\r\n<\/pre>\n
     <\/p>\n
    Step 4<\/strong>\u00a0– Build the docker image using the command below:<\/p>\n
    docker build -t springboot-kubernetes:1.0 .\r\n<\/pre>\n
     <\/p>\n
    4. Create the\u00a0 Deployment<\/strong><\/h4>\n
    First we need to create a deployment. We can do this either using a command or using a yaml file. In this tutorial, we would use a command. In subsequent tutorial, we would use a yaml file. Same goes for the service.<\/p>\n
    Step 1<\/strong> – Run this command to create the deployment<\/p>\n
    kubectl create deployment springboot-kubernetes --image=springboot-kubernetes:1.0 --port=8080\r\n<\/pre>\n
    This command creates a deployment which starts your SpringBoot application inside a Kubernetes cluster.<\/p>\n
    Step 2<\/strong> – Use the kubectl get pods<\/strong><\/em> command to check that the pod is up and running. This command also gives you the name of the pod<\/p>\n
    Step 3<\/strong> – Use the kubectl logs <pod_name><\/em><\/strong> to view the logs. You’ll see that the application is started at pot 8080.<\/p>\n
     <\/p>\n
    5. Create the Service and Access the Application<\/strong><\/h4>\n
    We would now create a service. A service would help us to connect to the application running in a node inside the Kubernetes cluster. So we need to expose the deployment<\/p>\n
    Step 1<\/strong> – Get the name of the deployment using the command kubectl get deployments<\/em><\/strong><\/p>\n
    Step 2<\/strong> – Create a service by exposing the deployment using the command below:<\/p>\n
    kubectl expose deployment springboot-kubernetes --type=NodePort\r\n<\/pre>\n
    You can get the services name using the kubectl get services<\/em><\/strong> command<\/p>\n
    Step 3<\/strong> – Get the service url using the command<\/p>\n
    minikube service springboot-kubernetes\r\n<\/pre>\n
    This command would display the services url for container running inside the pod. It would also open the default browser and redirect to the url.<\/p>\n
     <\/p>\n
    6. Access the Kubernetes Dashboard<\/strong><\/h4>\n
    The minikube dashboard gives you a user interface showing the Kubernetes status as well as the services, workloads, pods, jobs etc.<\/p>\n
    To access the Kubernetes dashboard, enter the command:<\/p>\n
    minikube dashboard\r\n<\/pre>\n
    This command would start the Minikube dashboard and display the corresponding url. Click on the link and it would launch the dashboard as shown below:<\/p>\n
    \"Kubernetes<\/a>
    Kubernetes Minikube Dashboard<\/figcaption><\/figure>\n","protected":false},"excerpt":{"rendered":"
    In this tutorial, you will learn how to easily setup local Kubernetes cluster. Then we would create a simple Spring Boot application and deploy to … <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"pagelayer_contact_templates":[],"_pagelayer_content":"","footnotes":""},"categories":[414],"tags":[],"class_list":["post-1994","post","type-post","status-publish","format-standard","hentry","category-programming"],"_links":{"self":[{"href":"https:\/\/kindsonthegenius.com\/blog\/wp-json\/wp\/v2\/posts\/1994","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/kindsonthegenius.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/kindsonthegenius.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/kindsonthegenius.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/kindsonthegenius.com\/blog\/wp-json\/wp\/v2\/comments?post=1994"}],"version-history":[{"count":1,"href":"https:\/\/kindsonthegenius.com\/blog\/wp-json\/wp\/v2\/posts\/1994\/revisions"}],"predecessor-version":[{"id":2162,"href":"https:\/\/kindsonthegenius.com\/blog\/wp-json\/wp\/v2\/posts\/1994\/revisions\/2162"}],"wp:attachment":[{"href":"https:\/\/kindsonthegenius.com\/blog\/wp-json\/wp\/v2\/media?parent=1994"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/kindsonthegenius.com\/blog\/wp-json\/wp\/v2\/categories?post=1994"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/kindsonthegenius.com\/blog\/wp-json\/wp\/v2\/tags?post=1994"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}