{{announcement.body}}
{{announcement.title}}

Configuration As A Service: Spring Cloud Config – Using Kotlin

DZone 's Guide to

Configuration As A Service: Spring Cloud Config – Using Kotlin

In this article, we will demonstrate the Spring cloud config server using Kotlin. Spring Boot provided a much-needed spark to the Spring projects.

· Java Zone ·
Free Resource

Developing a microservice architecture with Java and Spring Boot is quite popular these days. In microservice architecture we hundreds of services and managing services for each service and for each profile which is a quite tedious task. In this article, we will demonstrate the Spring cloud config server using Kotlin. 

Spring Boot provided a much-needed spark to the Spring projects.

Spring cloud-config provides a server and client-side support for externalizedconfiguration in a distributed system. With the Config Server, you have a central place to manage external properties for applications across all environments.

spring cloud config

From the above diagram, you can easily predict that in distributed systems managing configuration as a central service is a bit tedious task and spring cloud config provide client, server architecture mechanism to manage the configuration easily. 

Let us go to the https://start.spring.io/

spring initializer

When we do any changes in any service we have to restart the services to apply the changes.

Let us create one git repo to manage our configuration and to achieve this we are creating one git repo.

So we will create “springbootclient” as one small spring boot microservice to take the username and that will read username from spring cloud config central configuration server system i.e git here.

We have created three different properties files for each of our different environments. 

  1. springbootclient.properties
  2. springbootclient-dev.properties
  3. springbootclient-prod.properties

https://github.com/maheshwarLigade/cloud-common-config-server

Here is our spring cloud config properties are available, you can clone or use directly this repository too.

Now as we have created spring config server application using spring starter let us download and import that project in your favorite IDE or editor. git repo here we used to store our configuration and spring cloud config server application is to serve those properties to the client.

Basically git is datastore, spring cloud config server is server application and there are multiple microservices are the clients which needs configurations.

Now our git as datastore is ready. In this repository, we have created one sample client application and the name of that app is springbootclient. In the future microservice article we will utilize the same spring cloud config as a configuration server.

Let us go and check the code base for the client app.

This is the sample application.properties file:

Java
 




x


 
1
server.port=8888
2
logging.level.org.springframework.cloud.config=DEBUG
3
spring.cloud.config.server.git.uri=https://github.com/maheshwarLigade/cloud-common-config-server.git
4
spring.cloud.config.server.git.clone-on-start=true
5
spring.cloud.config.server.git.searchPaths=springbootclient



Sample Code for SpringCloudConfigServerexApplication.kt

Java
 




xxxxxxxxxx
1
11


 
1
import org.springframework.boot.autoconfigure.SpringBootApplication
2
import org.springframework.boot.runApplication
3
import org.springframework.cloud.config.server.EnableConfigServer
4
 
          
5
@SpringBootApplication
6
@EnableConfigServer
7
class SpringCloudConfigServerexApplication
8
 
          
9
fun main(args: Array<String>) {
10
   runApplication<SpringCloudConfigServerexApplication>(*args)
11
}



Now run and up the spring cloud-config server and check the below URL:

http://localhost:8888/springbootclient/dev/master

Spring Boot Client App

Let us create one small microservice which will read configuration from the spring cloud config server and serve that property value over the REST endpoint.

Go to the https://start.spring.io/ and create spring boot client microservice using kotlin.

Sample POM.xml dependencies.

Java
 




xxxxxxxxxx
1
20


 
1
<dependency>
2
   <groupId>org.springframework.boot</groupId>
3
   <artifactId>spring-boot-starter-web</artifactId>
4
</dependency>
5
<dependency>
6
   <groupId>com.fasterxml.jackson.module</groupId>
7
   <artifactId>jackson-module-kotlin</artifactId>
8
</dependency>
9
<dependency>
10
   <groupId>org.jetbrains.kotlin</groupId>
11
   <artifactId>kotlin-reflect</artifactId>
12
</dependency>
13
<dependency>
14
   <groupId>org.jetbrains.kotlin</groupId>
15
   <artifactId>kotlin-stdlib-jdk8</artifactId>
16
</dependency>
17
<dependency>
18
   <groupId>org.springframework.cloud</groupId>
19
   <artifactId>spring-cloud-starter-config</artifactId>
20
</dependency>



Now check the SpringCloudClientAppApplication.kt code

Java
 




xxxxxxxxxx
1


 
1
import org.springframework.boot.autoconfigure.SpringBootApplication
2
import org.springframework.boot.runApplication
3
 
          
4
@SpringBootApplication
5
class SpringCloudClientAppApplication
6
 
          
7
fun main(args: Array<String>) {
8
    runApplication<SpringCloudClientAppApplication>(*args)
9
}



Now create one sample REST controller which is serving REST request. We want to check ” /whoami” this endpoint is returning which is the user based on active profile dev, prod, etc.

UserController.kt

Java
 




xxxxxxxxxx
1
15


 
1
import org.springframework.beans.factory.annotation.Value
2
import org.springframework.web.bind.annotation.GetMapping
3
import org.springframework.web.bind.annotation.RestController
4
 
          
5
 
          
6
@RestController
7
class UserController {
8
 
          
9
    @Value("\${app.adminusername}")
10
    var username="Test"
11
//get request serving
12
    @GetMapping("/whoami")
13
    fun whoami() = "I am a  "+ username
14
 
          
15
}



Create a bootstrap.properties file where we will specify the spring cloud config server details, which is a git branch and what is active profile dev, local, prod, etc.

Java
 







All properties are self exclamatory, what is the use of which one.

Once you hit this URL http://localhost:9080/whoami

Output: I am a DevUser

Github source link:

Config Server: https://github.com/maheshwarLigade/cloud-common-config-server

Codebase: https://github.com/maheshwarLigade/spring-cloud-config-kotlin-ex

Topics:
java ,kotlin ,microservice ,spring ,spring cloud config ,spring cloud config server ,spring-cloud ,springboot

Opinions expressed by DZone contributors are their own.

{{ parent.title || parent.header.title}}

{{ parent.tldr }}

{{ parent.urlSource.name }}