Deploy Spring Boot Application to the Azure Kubernetes Service


For Spring Boot applications, we recommend using Azure Spring Apps. However, you can still choose to use Azure Kubernetes Service as a destination. For more information, see Choose the right Azure services for your Java applications.

This tutorial walks you through combining Kubernetes and Docker to develop and deploy a Spring Boot application to Microsoft Azure. More specifically, you use Spring Boot for application development, Kubernetes for container deployment, and the Azure Kubernetes Service (AKS) to host your application.

Kubernetes and Docker are open-source solutions that help developers automate the deployment, scaling, and management of their applications running in containers.



Due to the virtualization requirements of this tutorial, you cannot follow the steps in this article on a virtual machine; you must use a physical computer with virtualization features enabled.

Create the Spring Boot on Docker Getting Started web app

The following steps walk you through building a Spring Boot web application and testing it locally.

  1. Open a command-prompt and create a local directory to hold your application, and change to that directory; for example:

    mkdir C:\SpringBoot
    cd C:\SpringBoot

    -- or --

    mkdir /users/$USER/SpringBoot
    cd /users/$USER/SpringBoot
  2. Clone the Spring Boot on Docker Getting Started sample project into the directory.

    git clone
  3. Change directory to the completed project.

    cd gs-spring-boot-docker
    cd complete
  4. Use Maven to build and run the sample app.

    mvn package spring-boot:run
  5. Test the web app by browsing to http://localhost:8080, or with the following curl command:

    curl http://localhost:8080
  6. You should see the following message displayed: Hello Docker World

    Browse Sample App Locally

Create an Azure Container Registry using the Azure CLI

  1. Open a command prompt.

  2. Log in to your Azure account:

    az login
  3. Choose your Azure Subscription:

    az account set -s <YourSubscriptionID>
  4. Create a resource group for the Azure resources used in this tutorial.

    az group create --name=wingtiptoys-kubernetes --location=eastus
  5. Create a private Azure container registry in the resource group. The tutorial pushes the sample app as a Docker image to this registry in later steps. Replace wingtiptoysregistry with a unique name for your registry.

    az acr create --resource-group wingtiptoys-kubernetes --location eastus \
     --name wingtiptoysregistry --sku Basic

Push your app to the container registry via Jib

  1. Log in to your Azure Container Registry from the Azure CLI.

    # set the default name for Azure Container Registry, otherwise you need to specify the name in "az acr login"
    az config set defaults.acr=wingtiptoysregistry
    az acr login
  2. Open the pom.xml file with a text editor; for example Visual Studio Code.

    code pom.xml
  3. Update the <properties> collection in the pom.xml file with the registry name for your Azure Container Registry and the latest version of jib-maven-plugin.

       <!-- Note: If your ACR name contains upper case characters, be sure to convert them to lower case characters. -->
  4. Update the <plugins> collection in the pom.xml file so that the <plugin> element contains an entry for the jib-maven-plugin, as shown in the following example. Note that we are using a base image from the Microsoft Container Registry (MCR):, which contains an officially supported JDK for Azure. For other MCR base images with officially supported JDKs, see Install the Microsoft Build of OpenJDK..

  5. Navigate to the completed project directory for your Spring Boot application and run the following command to build the image and push the image to the registry:

    az acr login && mvn compile jib:build


Due to the security concern of Azure Cli and Azure Container Registry, the credential created by az acr login is valid for 1 hour. If you see a 401 Unauthorized error, you can run the az acr login --name <your registry name> command again to reauthenticate. If you see a Read timed out error, you can try increasing timeouts with mvn -Djib.httpTimeout=7200000 jib:dockerBuild, or -Djib.httpTimeout=0 for an infinite timeout.

Create a Kubernetes Cluster on AKS using the Azure CLI

  1. Create a Kubernetes cluster in Azure Kubernetes Service. The following command creates a kubernetes cluster in the wingtiptoys-kubernetes resource group, with wingtiptoys-akscluster as the cluster name, with Azure Container Registry (ACR) wingtiptoysregistry attached, and wingtiptoys-kubernetes as the DNS prefix:

    az aks create --resource-group=wingtiptoys-kubernetes --name=wingtiptoys-akscluster \
     --attach-acr wingtiptoysregistry \
     --dns-name-prefix=wingtiptoys-kubernetes --generate-ssh-keys

    This command may take a while to complete.

  2. Install kubectl using the Azure CLI. Linux users may have to prefix this command with sudo since it deploys the Kubernetes CLI to /usr/local/bin.

    az aks install-cli
  3. Download the cluster configuration information so you can manage your cluster from the Kubernetes web interface and kubectl.

    az aks get-credentials --resource-group=wingtiptoys-kubernetes --name=wingtiptoys-akscluster

Deploy the image to your Kubernetes cluster

This tutorial deploys the app using kubectl, then allows you to explore the deployment through the Kubernetes web interface.

Deploy with kubectl

  1. Open a command prompt.

  2. Run your container in the Kubernetes cluster by using the kubectl run command. Give a service name for your app in Kubernetes and the full image name. For example:

    kubectl run gs-spring-boot-docker

    In this command:

    • The container name gs-spring-boot-docker is specified immediately after the run command

    • The --image parameter specifies the combined login server and image name as

  3. Expose your Kubernetes cluster externally by using the kubectl expose command. Specify your service name, the public-facing TCP port used to access the app, and the internal target port your app listens on. For example:

    kubectl expose pod gs-spring-boot-docker --type=LoadBalancer --port=80 --target-port=8080

    In this command:

    • The container name gs-spring-boot-docker is specified immediately after the expose pod command.

    • The --type parameter specifies that the cluster uses load balancer.

    • The --port parameter specifies the public-facing TCP port of 80. You access the app on this port.

    • The --target-port parameter specifies the internal TCP port of 8080. The load balancer forwards requests to your app on this port.

  4. Once the app is deployed to the cluster, query the external IP address and open it in your web browser:

    kubectl get services -o=jsonpath='{.items[*].status.loadBalancer.ingress[0].ip}'

    Browse Sample App on Azure

Deploy with the Kubernetes resource view

  1. Select Add from any of the resource views (Namespace, Workloads, Services and ingresses, Storage, or Configuration).

    Kubernetes resources view.

  2. Paste in the following YAML:

    apiVersion: apps/v1
    kind: Deployment
      name: gs-spring-boot-docker
      replicas: 1
          app: gs-spring-boot-docker
            app: gs-spring-boot-docker
          - name: gs-spring-boot-docker
  3. Select Add at the bottom of the YAML editor to deploy the application.

    Kubernetes resources view, add resource.

    After deploying the Deployment, just like above, select Add at the bottom of the YAML editor to deploy Service using the following YAML:

    apiVersion: v1
    kind: Service
      name: gs-spring-boot-docker
      type: LoadBalancer
      - port: 80
        targetPort: 8080
        app: gs-spring-boot-docker
  4. Once the YAML file is added, the resource viewer shows your Spring Boot application. The external service includes a linked external IP address so you can easily view the application in your browser.

    Kubernetes resources view, services list.

    Kubernetes resources view, services list, external endpoints highlighted.

  5. Select External IP. You'll then see your Spring Boot application running on Azure.

    Browse Sample App on Azure

Next steps

To learn more about Spring and Azure, continue to the Spring on Azure documentation center.

See also

For more information about using Spring Boot on Azure, see the following article:

For more information about using Azure with Java, see the Azure for Java Developers and the Working with Azure DevOps and Java.

For more information about deploying a Java application to Kubernetes with Visual Studio Code, see Visual Studio Code Java Tutorials.

For more information about the Spring Boot on Docker sample project, see Spring Boot on Docker Getting Started.

The following links provide additional information about creating Spring Boot applications:

  • For more information about creating a simple Spring Boot application, see the Spring Initializr at

The following links provide additional information about using Kubernetes with Azure:

More information about using Kubernetes command-line interface is available in the kubectl user guide at

The Kubernetes website has several articles that discuss using images in private registries:

For additional examples for how to use custom Docker images with Azure, see Using a custom Docker image for Azure Web App on Linux.

For more information about iteratively running and debugging containers directly in Azure Kubernetes Service (AKS) with Azure Dev Spaces, see Get started on Azure Dev Spaces with Java