1.10.3

🎉 Neo4j container class is here 🎉

Thanks to @michael-simons, we now have Neo4j as a provided container class. Now creating a container to test against Neo4j is as easy as writing new Neo4jContainer(). Please check out the docs for more information and examples.

What else has Changed

As always, thank you to everyone who has contributed in any way to this release.

• Add Neo4j-OGM to 'Who is using Testcontainers'. (#996) @michael-simons
• [Docs] Change withDockerfileFromBuilder example to use expression Lamda (#975) @bmuschko
• Bump org.mock-server dependency set from 5.4.1 to 5.5.0 (#983) @bbednarek
• Disable Gradle daemon (#1004) @rnorth
• Use ChromeOptions and FirefoxOptions instead of DesiredCapabilities (#995) @pavelpp
• Remove SLF4J Profiler (#1002) @rnorth

1.10.2

What's Changed

• (Docs): Show appropriate build tool scope/configuration when showing Testcontainers Maven/Gradle dependency declarations (#969) @bmuschko
• Support using MariaDB JDBC URL to set database name, user and password (#950) @guss77
• Add TcpHost support to ElasticsearchContainer (#956) @reda-alaoui
• Update Docker Hub repository used for MS SQL Server (#992) @chungngoops
• Allow to set Shared Memory size (shmSize) for GenericContainer (#957, #952) @fzakaria

1.10.1

What's Changed

• Adjust API of ElasticsearchContainer so as to not expose shaded transient dependency (#964, fixes #958) Note: This means that usages of elasticsearchContainer.getHost() should be replaced with HttpHost.create(elasticsearchContainer.getHttpHostAddress()) @rnorth
• Add self-typing generics to ElasticsearchContainer (#963, fixes #962) @kiview
• Publish artifacts to Maven Local before running examples on CircleCI (#903) @kiview

1.10.0

It's 1.10.0! 🎆

We have some exciting new features in this release:

Official JUnit 5 support! 5️⃣

Our users have been asking for this for a long time, and we're delighted to finally add an official JUnit 5 (Jupiter) extension to Testcontainers. Thanks to @britter and several members of the JUnit team for their support and contribution!

Usage couldn't be easier:

@Testcontainers
class SomeTest {

    @Container
    private MySQLContainer mySQLContainer = new MySQLContainer();

    @Test
    void someTestMethod() {
        String url = mySQLContainer.getJdbcUrl();
         // create a connection and run test as normal
    }
}

Check out the documentation for more information.

Elasticsearch container class! 😎

Testing against elasticsearch just became much easier, thanks to this great contribution by @dadoonet.

This is based on the official Docker image provided by elastic. Check out the docs to see how easy it is to use.

What else has Changed

• Test against OpenJDK 11 (#883) @bsideup
• Use latest available VNC recorder image (#888) @rnorth
• Add missing argument to log statement (#895) @atomfrede
• Docs: Added an example using TestNG (#778) (#893) @vpondala
• Docs: Add Travis job for examples (#897) @kiview
• Docs: Update ROADMAP link in CONTRIBUTING.md (#901) @chungngoops
• Add property to start ryuk in privileged mode (#894) @atomfrede
• Docs: Adds description for JUnit 5 usage (#911) @artjomka and (#918) @TimRiemer
• Support empty password for mysql (#899) @chungngoops
• Fix examples in Couchbase README.md (#935) @kiview
• Add configuration for probot-stale bot (#907) @rnorth
• Remove old docs (#890) @rnorth
• Add WARN log if provided Couchbase password offends default policy (#936) @kiview
• Update commons-compress to 1.18 (#943) @nickbabcock
• Add Elasticsearch testcontainer (#826) @dadoonet
• Update Pulsar to 2.2.0 (#941) @haphut
• remove @nullable annotations and dependency on com.google.code.findbugs:jsr305 (#920) @dbyron0
• JUnit 5 extension (#887) @britter, (#947) @kiview
• Add JUnit5/Jupiter usage instructions to docs (#954) @kiview
• Support init script at JdbcDatabaseContainer level (#575) @AnkBurov
• Activate gradle build scans for CI builds (#916) @britter

1.9.1

What's Changed

• Fix AutoRemove of Ryuk container (#882) @bsideup
• Fix HttpWaitStrategy.forStatusCodeMatching used with HttpWaitStrategy.forStatusCode (#881) @dadoonet

1.9.0

🎉 1.9.0 is here and it's a big release! 🎉

Many bugs were squashed, and we have some awesome new features for you. As always, thanks so much to our growing list of amazing contributors! Everybody on this list deserves thanks (and beers!).

Here are some highlights of the 1.9.0 release:

A vastly improved way to expose host ports to containers ✨

It's similar to host.docker.internal, except this should work anywhere that Testcontainers works. It's like magic:

// tell Testcontainers which host ports to expose to your containers
Testcontainers.exposeHostPorts(someHostPortNumber);

// later, just give your container this address to use to reach back to the host:
address = "http://host.testcontainers.internal:" + someHostPortNumber;

For a more complete example see here.

Npipe support for Docker on Windows 🎈

Testcontainers now uses OkHttp by default to talk to Docker, with Npipe support. This means no more need to configure Docker for Windows to use TCP mode.

Many improvements to registry authentication 🔑

Support for Docker credential stores/credential helpers has continued to be improved, and is now supported on Windows!

Many updates and improvements to the Couchbase module 🎊

And lots, lots more:

What's Changed

Changed

• Switch to OkHttp as default transport (#853) @bsideup
• Add cross-platform support for exposing host ports to containers using SSH port forwarding (#806) @bsideup
• Add ClickHouse module (#846) @VladRassokhin
• Allow Couchbase container to support random ports using socat sidecar container (#815) @Kaidowei
• Add support to override default username and password in Oracle XE container (#823) @kiptix
• Docs: Added example of using Kafka Test Containers (#840) @iNikem
• Tests: replace boolean parameters with EnumSet in JDBCDriverTest (#849) @VladRassokhin
• Improve copyFileToContainer support (#829) @bsideup
• Allow specifying the rate limiter for AbstractWaitStrategy (#838, #837) @chibenwa
• Make MYSQL_ROOT_PASSWORD and MYSQL_PASSWORD the same value (#857) @dougEfresh
• Update mockserver to 5.4.1 (#832) @lanwen
• Update Pulsar to 2.1.0 (#824) @haphut
• Update CouchbaseContainer to 5.1.1 (#830) @Kaidowei
• Update docker-java to 3.1.0-rc4 (fixes support for identitytoken auth - #293)
• Add support for Postgis to JDBC driver (#864) @kiview
• Update Pulsar Container (#858) @aahmed-se
• Mark Windows npipe support as stable (with a fix) (#865) @bsideup
• Enable RegistryAuthLocator for Windows, improve, and add Windows test coverage (#868) @aulea
• Remove Netty classes from OkHttpInvocationBuilder (#869) @bsideup
• Update Pulsar to 2.1.1 (#874) @haphut
• Check FS mounting lazily (#875) @bsideup
• Allow configuration of user settings to support couchbase community version (#777) @kstrek

Fixed

• Improve support for docker registry authentication and docker hub private registry credentials (#845) @rnorth
• Fix NginxContainer wait behaviour (#818) @rnorth
• Fix inverted logic in Selenium module - ensures that correct sessions are captured when using RECORD_FAILING mode (#821) @bsideup
• Fix deadlock when ryuk does not acknowledge filters (#843) @thammerl
• Various CouchbaseContainer fixes (#830) @Kaidowei
• CouchbaseContainer: Fix java.net.SocketException exception in stop() (#859) @dnault
• Fix UnixDomainSocketInitializer to use configured docker host in connect() (#855) @aantoniadisatypon
• Fix local docker-compose support on Windows10 (#863) @kiview
• MockServerContainer: remove dependency to java api (#833) @lanwen
• Guard against potential NPE if startup fails before container creation (#876) @rnorth
• Remove unnecessary start() call in initCouchbaseContainer() method - improves stability of tests based on AbstractCouchbaseTest (#877) @kiview

1.9.0-rc2

What's Changed

Changed

• Add support for Postgis to JDBC driver (#864) @kiview
• Update Pulsar Container (#858) @aahmed-se
• Mark Windows npipe support as stable (with a fix) (#865) @bsideup
• Enable RegistryAuthLocator for Windows, improve, and add Windows test coverage (#868) @aulea
• Remove Netty classes from OkHttpInvocationBuilder (#869) @bsideup

Fixed

• Fix local docker-compose support on Windows10 (#863) @kiview
• MockServerContainer: remove dependency to java api (#833) @lanwen

1.9.0-rc1

Please note: this release candidate build is not published to Maven Central, but is published to Bintray.

What's Changed

Changed

• Switch to OkHttp as default transport (with opt-inable Npipe support) (#853) @bsideup
• Add cross-platform support for exposing host ports to containers using SSH port forwarding (#806) @bsideup
• Add ClickHouse module (#846) @VladRassokhin
• Allow Couchbase container to support random ports using socat sidecar container (#815) @Kaidowei
• Add support to override default username and password in Oracle XE container (#823) @kiptix
• Docs: Added example of using Kafka Test Containers (#840) @iNikem
• Tests: replace boolean parameters with EnumSet in JDBCDriverTest (#849) @VladRassokhin
• Improve copyFileToContainer support (#829) @bsideup
• Allow specifying the rate limiter for AbstractWaitStrategy (#838, #837) @chibenwa
• Make MYSQL_ROOT_PASSWORD and MYSQL_PASSWORD the same value (#857) @dougEfresh
• Update mockserver to 5.4.1 (#832) @lanwen
• Update Pulsar to 2.1.0 (#824) @haphut
• Update CouchbaseContainer to 5.1.1 (#830) @Kaidowei
• Update docker-java to 3.1.0-rc4 (fixes support for identitytoken auth - #293)

Fixed

• Improve support for docker registry authentication and docker hub private registry credentials (#845) @rnorth
• Fix NginxContainer wait behaviour (#818) @rnorth
• Fix inverted logic in Selenium module - ensures that correct sessions are captured when using RECORD_FAILING mode (#821) @bsideup
• Fix deadlock when ryuk does not acknowledge filters (#843) @thammerl
• Various CouchbaseContainer fixes (#830) @Kaidowei
• CouchbaseContainer: Fix java.net.SocketException exception in stop() (#859) @dnault
• Fix UnixDomainSocketInitializer to use configured docker host in connect() (#855) @aantoniadisatypon

1.8.3

Fixed

• Fixed with* methods of CouchbaseContainer (#810)
• Fix problem with gzip encoded streams (e.g. copy file from container), by adding decompression support to netty exec factory (#817, fixes #681, relates to docker-java/docker-java#1079)

1.8.2

Fixed

• Add support for transparently using local images with docker-compose (#798, fixes #674)
• Fix bug with Dockerfile image creation with Docker for Mac 18.06-ce (#808, fixes #680)

Changed

• Update Visible Assertions to 2.1.1 (#779).
• KafkaContainer optimization (group.initial.rebalance.delay.ms=0) (#782).