Spring Cloud Kubernetes


Spring Cloud Kubernetes provides implementations of well known Spring Cloud interfaces allowing developers to build and run Spring Cloud applications on Kubernetes. While this project may be useful to you when building a cloud native application, it is also not a requirement in order to deploy a Spring Boot app on Kubernetes. If you are just getting started in your journey to running your Spring Boot app on Kubernetes you can accomplish a lot with nothing more than a basic Spring Boot app and Kubernetes itself. To learn more, you can get started by reading the Spring Boot reference documentation for deploying to Kubernetes and also working through the workshop material Spring and Kubernetes.


  • Kubernetes awareness

  • DiscoveryClient implementation

  • PropertySource objects configured via ConfigMaps

  • Client side loadbalancing via Netflix Ribbon

Getting Started

The easiest way to get started is by including the Spring Cloud BOM and then adding spring-cloud-starter-kubernetes-all to your application’s classpath. If you don’t want to include all of the Spring Cloud Kubernetes features you can add individual starters for the features you would like. By default Spring Cloud Kubernetes will enable the kubernetes profile when it detects it is running inside a Kubernetes cluster. You can take advantage of this by creating a kubernetes-application configuration properties for anything specific to Kubernetes you might want to configure. Once the starter is on the classpath the application should behave as any other Spring Cloud application.

Spring Initializr

Quickstart Your Project

Bootstrap your application with Spring Initializr.


Each Spring project has its own; it explains in great details how you can use project features and what you can achieve with them.
2.1.0 CURRENT GA Reference Doc.
3.0.0-M1 PRE Reference Doc.
2.1.1-SNAPSHOT SNAPSHOT Reference Doc.
2.0.5-SNAPSHOT SNAPSHOT Reference Doc.
2.0.4 GA Reference Doc.
1.1.10.RELEASE GA Reference Doc.
Branch Initial Release End of Support End Commercial Support *
2021-11-30 2023-05-18 2024-08-22
2020-12-21 2022-05-19 2023-09-19
2019-11-26 2020-11-26 2022-03-26

OSS support

Free security updates and bugfixes with support from the Spring community. See VMware Tanzu OSS support policy.

Commercial support

Business support from Spring experts during the OSS timeline, plus extended support after OSS End-Of-Life.
Publicly available releases for critical bugfixes and security issues when requested by customers.

Future release

Generation not yet released, timeline is subject to changes.

About commercial support (*)

This page shows the current state of project releases and does not define the commercial support policy. Please refer to the official support policy for more information.

A few examples to try out: