We are going to learn how to deploy Springboot Microservices Docker container into Azure Kubernetes Cluster(AKS) using Helm and Azure pipelines.
Sample springboot App Code:
I have created a sample Springboot App setup in GitHub. Click here to access code base in GitHub.
Watch steps in YouTube channel:
What is Helm?
Helm is a package manager for Kubernetes. Helm is the K8s equivalent of yum or apt. It accomplishes the same goals as Linux system package managers like APT or YUM: managing the installation of applications and dependencies behind the scenes and hiding the complexity from the user.
Helm Charts
Helm uses a packaging format called Charts. A Helm Chart is a collection of files that describe a set of Kubernetes resources. Helm Charts helps you define, install, and upgrade even the most complex Kubernetes application. Charts are easy to create, version, share, and publish.
Implementation steps:
- Create a resource group, AKS cluster and Azure container registry
- Provide pull access for AKS to pull image from ACR
- Create a namespace for helm deployment
- Create a helm chart for spring boot app
- Create a build pipeline to automate docker image
- Customize pipeline with helm package tasks
- Create a release pipeline
- Customize pipeline with helm upgrade tasks
- Run the pipeline to deploy springboot app into AKS
- Verify deployments in the namespace in AKS
- Use kubectl port forward to access app locally
- Access the app in the browser
Pre-requisites:
- Azure CLI is installed on your local machine.
- Helm installed
- kubectl installed
- Azure subscription, click here if you don't have one.
- AKS cluster needs to be up running. You can create AKS cluster, ACR Repo using shell script provided in my website.
- Azure DevOps project dashboard in https://dev.azure.com/
- Dockerfile created along with the application source code for springboot App.
- Make sure AKS has pull access from ACR
Create Helm chart using helm
helm create mychart
Execute the above command to see the files created.
Add Docker image details to download from ACR before deploying to AKS cluster
open mychart/values.yaml
image:
repository: myacrrepo531.azurecr.io/akannan1087/docker-spring-boot
tag: ""
open mychart/templates/deployment.yaml and change containerPort to 8080
Make sure worker nodes are running
kubectl get nodes
Pipeline Implementation Steps:
Part 1 - Create Azure Build pipeline for building Docker image, uploading image into ACR and packaging helm chart.
Part 2 - Create Azure Release pipeline for deploying Springboot Docker containers into AKS using helm upgrade task.
Part 1 - How to create a Azure Build Pipeline
1. Login into your Azure DevOps dashboard
2. Click on Pipelines.
3. Click on New Pipeline
Click on Continue. Now choose the template by typing Helm, Select Azure Kubernetes service and click Apply.
Now pipeline is created with six tasks already. We need to start customizing the pipeline:
Select Ubuntu as build agent from Agent specification drop down, avoid Windows server as build agent.
Let's also add Maven build task for building the JAR file.
Click on + icon and type Maven. this should be the first task.
And then enter maven goal as package
Let's modify Build an image task.
Select Push an image task
Leave Install Helm Task as it is, we need that task to install Helm on build agent
Remove helm init task by selecting remove selected task
Customize helm package task, select Chart Path by clicking ... dots
Now click Save + Queue and run to start Building the pipeline
Check build output..
Once the build is completed, you should be able to see the Docker image in Azure Portal under Resource Group, ACR repo name --> Repositories
Part 2 - How to Create Release pipeline for deploying Springboot Microservices containers into AKS Cluster
Go to Pipelines --> Click on Releases --> New Release pipeline
Click on Stage 1 and choose a template by typing helm
and choose Deploy an application to K8S cluster using helm chart
Change the stage name to Deploy to AKS
Now click on Add an artifact
Click on Deploy to AKS
Enter right value for Azure subscription, Resource group and AKS Cluster by selecting from down down.
make sure check for latest version of Helm. this will install latest version of Helm which is 3.x
Remove helm init task by selecting remove selected task
Let's start customizing helm upgrade task. Enter helm-deployment as namespace, chart type as File path and click on three dots.
choose the package mychart-0.1.0.tgz and click ok.
Enter first as release name
enter below values for for set values:
image.tag=$(Build.BuildId)
Now click on Save.
Optional step - Enable Continuous Deploy Trigger
This will deploy microservices into AKS cluster for every new build in build pipeline.
Click on Create a release
Click on Release number to see the output
How to access Springboot Application using port forward locally?
Go to the browser enter http://localhost:8080
kubectl get deployments -n helm-deployment
kubectl get pods -n helm-deployment
Get the pod name and use port forward to access locally
kubectl port-forward first-springboot-pod_name 8080 -n helm-deployment
If you see any errors after deploying the pods, you can check the pod logs.
kubectl describe pod <pod_name> -n helm-deployment
You should see below web page.
Clean up Resources
Let us see how to clean up the resources that were created. We can use az group delete command to remove the resource group, AKS cluster, and all related resources.
az group delete --name aks-rg --yes --no-wait
No comments:
Post a Comment