Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/wpanas/testcontainers-examples
Bunch of sample projects that showcase how to use Testcontainers with Spring Boot, JUnit 5, Kotest together with PostgreSQL or Kafka. Finally, this repo shows not only how to test with Testcontainers, but also how to run your application locally
https://github.com/wpanas/testcontainers-examples
docker hacktoberfest junit kotlin samples spring-boot test-automation testcontainers
Last synced: about 2 months ago
JSON representation
Bunch of sample projects that showcase how to use Testcontainers with Spring Boot, JUnit 5, Kotest together with PostgreSQL or Kafka. Finally, this repo shows not only how to test with Testcontainers, but also how to run your application locally
- Host: GitHub
- URL: https://github.com/wpanas/testcontainers-examples
- Owner: wpanas
- License: unlicense
- Created: 2020-07-22T17:21:40.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-10-28T16:00:14.000Z (about 2 months ago)
- Last Synced: 2024-11-01T21:28:18.830Z (about 2 months ago)
- Topics: docker, hacktoberfest, junit, kotlin, samples, spring-boot, test-automation, testcontainers
- Language: Kotlin
- Homepage:
- Size: 290 KB
- Stars: 9
- Watchers: 2
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Testcontainers Examples
This repository contains sample projects
that use [Testcontainers](https://www.testcontainers.org/)
with different technologies.
I hope it will help you use it in your own projects.
All samples are build with [Kotlin](https://kotlinlang.org/), [Gradle](https://gradle.org/)
& [JUnit 5](https://junit.org/junit5/).
👉 If you use JDK 17+ & Spring Boot 3.1+ go straight
to the [simplest project](./spring6-junit5/README.md).
Other projects use older Spring Boot 2.7 to show
how to use Testcontainers without all great advancements
that since were made. As for now, 2.7 is still commercially supported
until 2025-08-24. I encourage you to update Spring Boot according
to the [official support timeline](https://spring.io/projects/spring-boot#support)
to have the best experience with Testcontainers and what not.
## Current tests status is:
[](https://github.com/wpanas/testcontainers-examples/actions/workflows/ci.yml?query=branch%3Amaster)
# Sample projects
- **NEW!** [[Spring Boot 3.1+]: The simplest Spring MVC, JPA on PostgreSQL & local running](./spring6-junit5/README.md)
- [[Spring Boot 2.7]: MVC & JPA with PostgreSQL](./spring-junit5/README.md)
- [[Spring Boot 2.7]: MVC & JPA with Kotest tests](./spring-kotest/README.md)
- [[Spring Boot 2.7]: MVC & JPA with PostgreSQL & local running](./local-db/README.md)
- [[Spring Boot 2.7]: Kafka with local running](./kafka/README.md)
# How to use it?
## Run all tests
```shell script
./gradlew check
```
## Run kafka module tests
```shell
./gradlew kafka:check
```
## Run postgres module tests
```shell
./gradlew local-db:check
```
## Run spring6-junit5 tests
```shell
./gradlew spring6-junit5:check
```
## Run spring-junit5 tests
```shell
./gradlew spring-junit5:check
```
## Run spring-kotest tests
```shell
./gradlew spring-kotest:check
```
# How to run local development?
💥 **NEW!** To run locally application with a Postgresql container configured by Testcontainers & Spring Boot 3.1+.
```shell
./gradlew spring6-junit5:bootTestRun
```
To run locally application with a Kafka container configured by Testcontainers.
```shell
./gradlew kafka:bootLocalRun
```
To run locally application with a Postgresql container configured by Testcontainers.
```shell
./gradlew local-db:bootLocalRun
```
# Troubleshooting
## ContainerFetchException
If you got `ContainerFetchException`
because of failing `Docker environment should have more than 2GB free disk space`,
increase available disc space in Docker for Mac. See [more](https://github.com/testcontainers/testcontainers-java/issues/1726).