If you are writing 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" below.

1. How to use
2. List of properties per data service
   1. embedded-mariadb
   2. embedded-couchbase
   3. embedded-kafka
   4. embedded-aerospike
   5. embedded-memsql
   6. embedded-redis
   7. embedded-neo4j
   8. embedded-zookeeper
3. How to contribute

<project>
...
      <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter</artifactId>
            ...
        </dependency>
...
</project>

<project>
...
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
            ...
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter</artifactId>
            ...
            <scope>test</scope>
        </dependency>
...
</project>

<project>
...
        <dependency>
            <groupId>com.playtika.testcontainers</groupId>
            <artifactId>embedded-kafka</artifactId>
            <scope>test</scope>
        </dependency>
...
</project>

/src/test/resources/application.properties

spring.kafka.zookeeperHost=${embedded.zookeeper.zookeeperConnect}
spring.kafka.brokerList=${embedded.kafka.brokerList}

/src/test/resources/bootstrap.properties

embedded.kafka.topicsToCreate=some_topic

<dependency>
    <groupId>com.playtika.testcontainers</groupId>
    <artifactId>embedded-mariadb</artifactId>
    <scope>test</scope>
</dependency>

• embedded.mariadb.enabled (true|false, default is 'true')
• embedded.mariadb.encoding (default is 'utf8mb4')
• embedded.mariadb.collation (default is 'utf8mb4_unicode_ci')
• embedded.mariadb.dockerImage (default is set to 'mariadb:10.3.2')
  • You can pick wanted version on dockerhub

• embedded.mariadb.port
• embedded.mariadb.host
• embedded.mariadb.schema
• embedded.mariadb.user
• embedded.mariadb.password

<dependency>
    <groupId>com.playtika.testcontainers</groupId>
    <artifactId>embedded-couchbase</artifactId>
    <scope>test</scope>
</dependency>

• embedded.couchbase.enabled (true|false, default is 'true')
• embedded.couchbase.services (comma separated list, default is 'kv,index,n1ql,fts')
• embedded.couchbase.clusterRamMb (default is set to '256')
• embedded.couchbase.bucketRamMb (default is set to '100')
• embedded.couchbase.dockerImage (default is set to 'couchbase:community-4.5.1')
  • You can pick wanted version on dockerhub
  • NOTE: Versions of couchbase 2.x/3.x are not functional via docker, consider use of CouchbaseMock
• embedded.couchbase.bucketType (default is set to 'couchbase')
  • Used for test bucket creation

• embedded.couchbase.bootstrapHttpDirectPort
  • Please note that this also produced as System property for couchbase java client
• embedded.couchbase.bootstrapCarrierDirectPort
  • Please note that this also produced as System property for couchbase java client
• embedded.couchbase.host
• embedded.couchbase.bucket
• embedded.couchbase.user
• embedded.couchbase.password

<dependency>
    <groupId>com.playtika.testcontainers</groupId>
    <artifactId>embedded-kafka</artifactId>
    <scope>test</scope>
</dependency>

• embedded.zookeeper.enabled (true|false, default is 'true')
• embedded.kafka.enabled (true|false, default is 'true')
• embedded.kafka.topicsToCreate (comma separated list of topic names, default is empty)
• embedded.kafka.dockerImage (default is set to kafka 0.11.x)
  • To use kafka 0.10.x place "confluentinc/cp-kafka:3.2.2" or recent from 3.2.x branch
  • To use kafka 0.11.x place "confluentinc/cp-kafka:3.3.0" or recent from 3.3.x branch

• embedded.zookeeper.zookeeperConnect
• embedded.kafka.brokerList

<dependency>
    <groupId>com.playtika.testcontainers</groupId>
    <artifactId>embedded-aerospike</artifactId>
    <scope>test</scope>
</dependency>

• aerospike client library
• embedded.aerospike.enabled (true|false, default is 'true')
• embedded.aerospike.dockerImage (default is set to 'aerospike:3.15.0.1')
  • You can pick wanted version on dockerhub

• embedded.aerospike.host
• embedded.aerospike.port
• embedded.aerospike.namespace
• AerospikeTimeTravelService
  • timeTravelTo
  • nextDay
  • addDays
  • addHours
  • rollbackTime

<dependency>
    <groupId>com.playtika.testcontainers</groupId>
    <artifactId>embedded-memsql</artifactId>
    <scope>test</scope>
</dependency>

• embedded.memsql.enabled (true|false, default is 'true')
• embedded.memsql.dockerImage (default is set to 'memsql/quickstart:minimal-6.0.8')
  • You can pick wanted version on dockerhub

• embedded.memsql.port
• embedded.memsql.host
• embedded.memsql.schema
• embedded.memsql.user
• embedded.memsql.password

• Images without "minimal" tag do no start withing 30 secs, so they are unusable
• There should be at least 1.5 GB of RAM available for memsql to start
• You can enable debug logs for com.playtika.test category to troubleshoot issues

<dependency>
    <groupId>com.playtika.testcontainers</groupId>
    <artifactId>embedded-redis</artifactId>
    <scope>test</scope>
</dependency>

• embedded.redis.enabled (true|false, default is 'true')
• embedded.redis.dockerImage (default is set to 'redis:4.0.2')
  • You can pick wanted version on dockerhub

• embedded.redis.host
• embedded.redis.port
• embedded.redis.user
• embedded.redis.password

<dependency>
    <groupId>com.playtika.testcontainers</groupId>
    <artifactId>embedded-neo4j</artifactId>
    <scope>test</scope>
</dependency>

• embedded.neo4j.enabled (true|false, default is 'true')
• embedded.neo4j.dockerImage (default is set to 'neo4j:3.2.7')
  • You can pick wanted version on dockerhub

• embedded.neo4j.user
• embedded.neo4j.password
• embedded.neo4j.httpsPort
• embedded.neo4j.httpPort
• embedded.neo4j.boltPort

• There is 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

• Release build is done on 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]