What's Changed

This release includes a number of big improvements, features and bug fixes! To name just a handful:

• 🎉 docker-java is updated to 3.2.x. This is a major milestone for the library that we participated in. Please pay attention to deprecation warnings - ideally com.github.dockerjava.api.* should be the only package in use from com.github.dockerjava.*. Future versions of Testcontainers will no longer shade com.github.dockerjava.api.* and will include it as a dependency (com.github.docker-java:docker-java-api).

• 🎉 R2DBC support for MySQL, MariaDB, PostgreSQL and MS SQL Server! See the docs for more info. Special thanks goes to the R2DBC team for their help and support with this PR.

• 🎉 Vastly improved Couchbase container reliability, thanks to @daschl of @couchbase! This does include some small breaking changes to the Couchbase module's API - but ones that we consider to be worth the migration effort for a more stable build. Please see the documentation for the new usage syntax.

• 🎉 Containers started by the JUnit Jupiter integration are now compatible with TestLifecycleAware, allowing greater hooks into phases of test execution.

• 🎉 Broadened support for authenticated private registries when using Docker Compose.

Read on for many more improvements:

🚀 Features

• Breaking change: Rewrite Couchbase module for improved reliability (#2491, #2447) @daschl, @bsideup.
• Add R2DBC support (#2545) @bsideup
• Pre-pull images required for Docker Compose (#2201, #1799, #1903) @rnorth
• Include image name in RemoteDockerImage#toString (#2558, #2450) @bsideup, @dbyron0
• VNC recording with BrowserWebdriverContainer in Spock-Extension (#2548, #726, #631) @kiview, @dkublik, @erdi, @tamershahin
• Support TestLifecycleAware-ness of containers started by the JUnit Jupiter integration (#1326) @roamingthings
• Expand Container dependsOn parameters to accept Iterable (#2259) @rnorth
• Cache results of auth lookups (#2213) @rnorth
• Add custom exception message when HealthState not present in docker inspect response (#2206) @pivovarit

🐛 Bug Fixes

• Use LogMessageWaitStrategy in VncRecordingContainer (#2547) @srempfer
• Protect NetworkImpl#close from concurrency issues (#2203) @pivovarit
• Fallback to getDefaultGateway() if "bridge" is unavailable. (#2429) @bsideup
• Fix invalid connection URLs returned by PostgreSQLContainer (#1976) (#2049) @pivovarit
• Fix internal port check when other ports are opened as well on the target container (#2363) @codablock
• Make default file recording directory of BrowserWebDriverContainer platform independent (#2562) @kiview
• Fix Spock's TestLifecycleAware integration (#2563) @bsideup

📖 Documentation

• Add more clear warning message instructing users how to enable reusable containers (#2422) @aguibert
• Add more information for using registry mirror (#2477) @sparsick
• Remove unusual public in Groovy example code (#2238) @mkutz
• Use @DynamicPropertySource in the Spring Boot example (#2495) @bsideup
• Extend docs with registry mirror as workaround for custom images (#2452) @sparsick
• Add example for Cassandra module (#2210, #1975) @ftrossbach

🧹 Housekeeping

• Temporarily ignore DB2 test - unrelated CI disk space issues (#2557) @kiview. This will be reinstated shortly, following work to reduce the disk usage of individual CI jobs.
• Add ciMate (#2550) @bsideup
• Move static config in modules to constructor (#2473) @MitchJust
• Fix update-docs-version.yml script (#2519) @rnorth
• Bump Copyrights to 2020 (#2488) @pivovarit

📦 Dependency updates