Data services library

If you develop services using Spring Boot and maybe Spring Cloud and you do medium sized tests during build process, then this set of Spring Boot auto-configurations might be handy. By adding module into classpath, you will get stateful service, like Couchbase or Kafka, auto-started and available for connection from your application service w/o wiring any additional code. Docker and TestContainers are used to bootstrap stateful service using Spring Cloud bootstrap phase. Usage of Spring Cloud in your production code is optional, but you will need it in tests. See How to use below.

How to use

1. Install Docker on your machine

2. Make sure you have Spring Boot and Spring Cloud in classpath of your tests. In case if you need to pick version.

   pom.xml

   <project>
   ...
         <dependency>
               <groupId>org.springframework.cloud</groupId>
               <artifactId>spring-cloud-starter</artifactId>
               <!-- https://mvnrepository.com/artifact/org.springframework.cloud/spring-cloud-starter -->
               <version>[pick version]</version>
           </dependency>
   ...
   </project>

3. If you do not use Spring Cloud - make it work for tests only:

   pom.xml

   <project>
   ...
           <dependency>
               <groupId>org.springframework.boot</groupId>
               <artifactId>spring-boot-starter</artifactId>
               <!-- https://mvnrepository.com/artifact/org.springframework.boot/spring-boot-starter -->
               <version>[pick version]</version>
           </dependency>
           <dependency>
               <groupId>org.springframework.cloud</groupId>
               <artifactId>spring-cloud-starter</artifactId>
               <!-- https://mvnrepository.com/artifact/org.springframework.cloud/spring-cloud-starter -->
               <version>[pick version]</version>
               <scope>test</scope>
           </dependency>
   ...
   </project>

4. Add data service library:

   pom.xml

   <project>
   ...
           <dependency>
               <groupId>com.playtika.testcontainers</groupId>
               <artifactId>embedded-kafka</artifactId>
               <!-- https://mvnrepository.com/artifact/com.playtika.testcontainers/ -->
               <version>[pick version]</version>
               <scope>test</scope>
           </dependency>
   ...
   </project>

5. Use produced properties in your configuration.

   Example:

   /src/test/resources/application.properties

   spring.kafka.bootstrap-servers=${embedded.kafka.brokerList}

   /src/test/resources/bootstrap.properties

   embedded.kafka.topicsToCreate=some_topic

In-depth guides, how-tos and samples

• Testing Strategies in a Microservice Architecture

• Functional Testing in Spring Boot Using Docker in Tests

• Functional tests best practices sample repo

• Spring Boot Microservices Integration Testing

• Easy Integration Testing With Testcontainers

• SpringBoot Integration Testing using TestContainers Starter

• Easy way to test Spring Boot microservices

Common configuration options

Shutdown of embedded containers on spring application shutdown immediately

/src/test/resources/application.properties

embedded.containers.forceShutdown=true //default is false

Note	Otherwise it will be shutdown with delay, see https://github.com/testcontainers/moby-ryuk

Disables all embedded containers

/src/test/resources/bootstrap.properties

embedded.containers.enabled=true //default is true

Note	If you setup, for example embedded.kafka.enabled + embedded.containers.enabled, result will be same as using AND between two booleans.

Note	embedded.kafka.enabled=false will cause DockerNotPresentException if you don’t have docker installed. But embedded.containers.enabled=false won’t cause any exceptions in this case.

Setting1	Setting2	Outcome
embedded.containers.enabled=false	embedded.memsql.enabled=true	Memsql will not start
embedded.containers.enabled=true	embedded.memsql.enabled=false	Memsql will not start
embedded.containers.enabled=true	embedded.memsql.enabled=true	Memsql will start
embedded.containers.enabled is missing	embedded.memsql.enabled is missing	Memsql will start

Supported services

embedded-mariadb

embedded-couchbase

embedded-kafka

embedded-rabbitmq

embedded-aerospike

embedded-memsql

embedded-redis

embedded-neo4j

embedded-postgresql

embedded-elasticsearch

embedded-dynamodb

embedded-voltdb

embedded-minio

embedded-mongodb

embedded-google-pubsub

embedded-keycloak

embedded-influxdb

embedded-vault

embedded-oracle-xe

embedded-mysql

embedded-localstack

embedded-cassandra

embedded-clickhouse

How to contribute

Flow

• There are 2 branches in project: master and develop

• You need to fork project and create branch from develop

• You do not need to update project version in pom.xml files, this will be done by release job

• Once finished - create pull request to develop from your fork, pass review and wait for merge

• On release, ci job will merge develop into master and remove snapshot + publish artifacts into public maven repo

Checklist for contributing new module

• Naming/formatting patterns match existing code

• Test for success scenario

• Test for negative scenario (autoconfiguration is disabled via properties). How to test autoconfiguration

• Add new module to testcontainers-spring-boot-bom

• Module provides documentation in README.adoc and this documentation is included in parent README.adoc (see an example in already existing modules). Documentation should include:

  • maven module declaration

  • consumed properties

  • produced properties

  • notes (if applicable)

  • example of usage

Release

• Release build is done using gitflow-maven-plugin

• Release is done per each major change, critical bug

• Release can be done by contributor request

• Contacts to start release:

  • [email protected]

  • [email protected]

  • [email protected]