What's Changed

Highlights

This new version of Testcontainers comes packed with many new features and quality-of-life improvements, so we appropriately bumped the version to 1.17.0.

🐝 New Module: HiveMQ (#4797) @YannickWeber

Having started its Open Source life as its own 3rd-party Testcontainers library, we are very happy to welcome HiveMQ into the main repository.
Now, using HiveMQ as part of your integration tests is as simple as a couple of lines of Java code:

@Container
HiveMQContainer hivemq = new HiveMQContainer(DockerImageName.parse("hivemq/hivemq-ce:2021.3"));
hivemq.start();

Mqtt5BlockingClient client = Mqtt5Client.builder()
    .serverPort(hivemqCe.getMqttPort())
    .serverHost(hivemqCe.getHost())
    .buildBlocking();

client.connect();

Check out the docs to learn more about its many features!

💀 Ryuk JVM mode (#4959) (#4960) @bsideup

Many Testcontainers user love the convenience Ryuk brings to Testcontainers: No matter what you do in your integration tests, Ryuk has got you covered and will cleanup all Docker resources created by Testcontainers after your test run is finished.

But some users operate Testcontainers in environments which do not support our container-based Ryuk implementation. So far their only option was to disable Ryuk alltogether.

Coming with this release, Testcontainers will now fallback to a JVM based resource-cleanup implementation in case of Ryuk being disabled.
While this won't be as robust as the Ryuk container based implementation in all circumstances, it is nevertheless a great addition and acts as a useful compromise.

🚀 Features & Enhancements

• Allow to create a container file from a Transferable (#3814) (#3815) @thomasdarimont
• Elasticsearch: Ensure Elasticsearch 8 works OOTB secure as default (#5099) @spinscale
• Deperecate getContainerIpAddress (#5247) @kiview
• Fix ScriptUtils.runInitScript() in hierarchical classloader setup by using TCCL (#5167) @famod
• [HiveMQ] added tmpFs (#5109) @YannickWeber
• Replace deprecated checkAndPullImage with RemoteDockerImage (#5148) @bsideup
• Enable Neo4j labs plugin definition. (#5035) @meistermeier
• Deprecate getTestHostIpAddress and getContainerIpAddress (#5149) @bsideup
• Add the session header to every Docker request (#5145) @bsideup
• Start Ryuk lazily when in the reusable mode (#4938) @bsideup
• [HiveMQ] replaced MultiLogMessageWaitStrategy.java with WaitAllStrategy (#5093) @YannickWeber
• #5032 - MS SQL Server disable encrypt by default (#5033) @StefanHufschmidt
• [Couchbase] Add support for Eventing service (#4953) @tchlyah

🐛 Bug Fixes

• Fix incorrect path for RABBITMQ_CONFIG_FILE (#5184) @mdedetrich
• Update mkdocs to 1.3.0 (#5186) @kiview
• Do not mount Selenium's SHM on Windows (#5105) @bsideup

📖 Documentation

• Improved jitpack dependencies page (#5189) @YannickWeber
• Update mkdocs to 1.3.0 (#5186) @kiview
• Mention that Spring Data Neo4j uses Testcontainers in the docs. (#5169) @meistermeier
• Fix formatting in docs for image override configuration (#5147) @rnorth
• [docs]Add the used organization Byzer. (#5125) @hellozepp
• [Neo4j] Include code from tests in docs. (#5120) @meistermeier
• Polish code samples so that they are easier to copy & paste (#5038) @maciejwalkowiak
• Upgrade mkdocs (#3443) @rnorth
• Remove the INCUBATING note from CockroachDB module docs (#4963) @kiview
• Update docs version to ${GITHUB_REF##*/} (#4932) @github-actions
• Simplify dependency management for JUnit Jupiter (#4704) @marcphilipp

🧹 Housekeeping

• Increase default client ping timeout from 5 to 10 seconds (#5254) @kiview
• add virtual environment to git ignore (#5156) @jetersen
• Improve Gradle build cacheability (#5188) @jprinet
• Remove OkHttp transport (#5113) @bsideup
• use collapse-after for dependencies category (#5157) @jetersen
• [HiveMQ] replaced non-ascii single quote with ascii single quote (#5102) @YannickWeber
• Run tests using shaded dependencies (#5146) @bsideup
• [HiveMQ] every IT now uses getHost() (#5106) @YannickWeber
• Fix tests on Windows (#5096) @bsideup
• Upgrade mkdocs (#3443) @rnorth
• Remove some dead code from PostgreSQLContainer (#4948) @dajudge
• Use JDK 1.8 in Azure pipelines (#4942) @kiview

📦 Dependency updates