Kick start your own Spring Cloud Config Server with MongoDB

Learn how to start your own Spring Cloud Config Server instance backed with MongoDB.

Imagem de capa

Spring Cloud Config Server MongoDB enables the seamless integration of the regular Spring Cloud Config Server with MongoDB to manage external properties for applications across all environments.

A Simple Config Server

Bootstrapping a configuration server with Spring Cloud Config Server MongoDB is just a matter of the following three steps.

1. Configure your pom.xml:

<dependencies>
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-config-server-mongodb</artifactId>
        <version>0.0.2.BUILD-SNAPSHOT</version>
    </dependency>
</dependencies>
<repositories>
    <repository>
        <id>spring-snapshots</id>
        <name>Spring Snapshots</name>
        <url>https://repo.spring.io/libs-snapshot-local</url>
        <snapshots>
            <enabled>true</enabled>
        </snapshots>
    </repository>
    <repository>
        <id>ojo-snapshots</id>
        <name>OJO Snapshots</name>
        <url>https://oss.jfrog.org/artifactory/libs-snapshot</url>
        <snapshots>
            <enabled>true</enabled>
        </snapshots>
    </repository>
</repositories>

2. Create a standard Spring Boot application with the EnableMongoConfigServer annotation:

@SpringBootApplication
@EnableMongoConfigServer
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

3. Configure the application’s spring.data.mongodb.* properties in application.yml:

spring:
  data:
    mongodb:
      uri: mongodb://localhost/config-db


Usage

We can now add configuration documents to MongoDB and access it via the REST API.

1. Add configuration documents to MongoDB:

    use config-db;

    db.gateway.insert({
      "label": "master",
      "profile": "prod",
      "source": {
        "user": {
          "maxConnections": NumberInt(8),
          "timeoutMs": NumberInt(3600)
        }
      }
    });

2. Access it by invoking http://localhost:8080/master/gateway-prod.properties:

    user.maxConnections: 8
    user.timeoutMs: 3600

Spring Cloud Config Client-backed components can be configured to automatically load configuration from MongoDB by leveraging Spring Cloud Config Server MongoDB. See here for an example!


Like it? Give the project a star on GitHub. You can also comment below. All feedback is welcome!