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

What's Changed

Highlights

Testcontainers 1.16.3 includes many changes, but there are two key highlights in this release:

k3s module (#4582) @rnorth, @kiview

We've had plenty of feedback from users wanting to use Testcontainers to help test Kubernetes components.
In particular, this is useful for people developing Kubernetes controllers/operators, who need something more than just a mocked Kubernetes API.
In this release we're bringing the k3s module, which gives you a neat way to spin up the K3S lightweight Kubernetes inside of a container.
We believe that k3s hits a sweet spot for ease of use and performance, so is a good option for testing Kubernetes components.

Now, launching a lightweight single-node Kubernetes cluster within your tests is easy as:

K3sContainer k3s = new K3sContainer(DockerImageName.parse("rancher/k3s:v1.21.3-k3s1"));
k3s.start();

String kubeConfigYaml = k3s.getKubeConfigYaml();
ApiClient client = Config.fromConfig(new StringReader(kubeConfigYaml));

// now use `client` to talk to your cluster!

Check out the docs to find out more!

Selenium 4 compatibility (#4914) @GannaChernyshova, @tobiasstadler, @kiview, @rnorth

Selenium 4 was announced a while back, but we needed to make some changes to Testcontainers' Selenium/Webdriver module for compatibility.
We're happy to announce that these changes have now been made, so you can now use Selenium 4 with Testcontainers!

As part of this upgrade we have to drop compatibility with Selenium 2, but believe that this will not have any practical impact.

🚀 Features & Enhancements

• [Reusable mode] Don't log about starting container unnecessarily (#4844) @pkubowicz
• Display Ryuk logs when it fails to start (#4842) @vincz7777
• [couchbase] Explicitly configure service quotas (and allow customizat… (#4802) @daschl
• removed hardcoded log level setting on mockserver (#4798) @szymonprz
• [couchbase] Ignore transient primary index creation error. (#4681) @daschl
• Execute Docker credential program through shell on Windows (#4763) @mruemeli

🐛 Bug Fixes

• change external port check to it can timeout and retry (#4680) @kmcgovern-apixio

📖 Documentation

• Add Gradle Enterprise badge in README (#4850) @jprinet
• Remove references to Atlassian for LocalStack (#4796) @HarshCasper
• Update sponsors as of Dec 2021 (#4806) @rnorth
• Use a relative path to the Selenium module (#4700) @bsideup
• Add link to webdrivers module (#4699) @brunoborges
• jdbc.md: Fix typo (#4678) @perlun
• Fix Documentation not displaying properly for 'Docker wormhole pattern' (#4658) @wimdeblauwe

🧹 Housekeeping

• Replace jcenter with mavenCentral in all examples (#4931) @kiview
• Update dependabot rules for new modules (#4864) @rnorth
• Tweak logging around reusable mode (#4858) @rnorth
• Add GE remote cache to examples project (#4855) @kiview
• Increase AzureCI timeout to 120 minutes instead of using the default of 60 minutes (#4854) @kiview
• Reinstate usage of READ_ONLY_REMOTE_GRADLE_CACHE to avoid wrong cache hits (#4853) @kiview
• Gradle Enterprise Trial (#4705) @kiview
• Update GE plugin in examples to 3.6.1 (#4672) @kiview
• Use key=value format for GRADLE_ENTERPRISE_ACCESS_KEY value (#4671) @kiview
• Add Gradle Enterprise (#4057) @kiview
• Use automated PR to update docs version (#4606) @rnorth
• Add Thundra test summary badge to README (#4604) @rwxdash

📦 Dependency updates

What's Changed

1.16.2 fixes a race condition that was inadvertently added in 1.16.1. This bug can potentially cause unstable builds in some environments, manifesting as port wait timeouts at container startup.

🚀 Features & Enhancements

• Added started log message used in Selenium 4.0.0 (#4580) @tobiasstadler
• [couchbase] Add support for Couchbase Analytics. (#4592) @daschl

🐛 Bug Fixes

• Make Bolt log wait strategy more lenient (#4455) @fbiville
• Fix nested lambda in getWithTimeout (#4470) @Flugtiger
• Fix race condition in external port check (#4597) @kiview

📖 Documentation

• Update RELEASING.md (#4590) @kiview

🧹 Housekeeping

• Upgrade to Docker Compose 1.29.2 (#4164) (#4461) @rombert
• Don't run tests as part of the release build (#4600) @kiview
• Revert "Temporarily disable Thundra on master branch" (#4571) @rwxdash
• Remove Linux Azure pipelines build (#4452) @rnorth

What's Changed

1.16.1 inadvertently introduced a race condition. This bug can potentially cause unstable builds in some environments, manifesting as port wait timeouts at container startup. We recommend upgrading to 1.16.2 or higher.

Testcontainers 1.16.1 has been released! 🎉

This release brings a lot of eagerly awaited new features and fixes, such as:

🔮 Better Oracle Database support

Thanks to the engagement of the community and @gvenzl's new Docker images for Oracle Database Express Edition we were able to update our OracleContainer module to ensure its compatibility with a wide range of Oracle XE versions.

And at the same time, thanks to the new images, we were able to re-integrate the Oracle module into our CI. This means we can verify compatibility for using Testcontainers with Oracle Database going forward.

☁️ New Azure Cosmos DB module

With the new Azure Comos DB module we finally added Azure to our list of cloud service testing facilities.
It is based on Microsoft's Azure Cosmos DB-Emulator and provides you with a way to do your integration testing without the need for an actual Azure service.

public CosmosDBEmulatorContainer emulator = new CosmosDBEmulatorContainer(
        DockerImageName.parse("mcr.microsoft.com/cosmosdb/linux/azure-cosmos-emulator:latest")
);

Please check out the module docs to learn how to use it for your integration testing needs.

⛴ Host port access for containers

For further improving the developer experience of our users, we added a new API to make hosts ports accessible to containers:

container.withAccessToHost(true)

You still need to use exposeHostPorts, as per the docs, but this can now be done after the container has started, thereby allowing new usage patterns in your tests.

🌪 Faster Cassandra startup

By making clever use of the configuration settings available in Cassandra, CassandraContainer will now start up to 3 times faster.
It is now also configured to be less resource hungry out of the box.

✨ Better startup performance for all containers

We found a couple of ways to improve the container startup performance for our users, no matter the Testcontainers module you use.
This comes through some internal changes with regards to how Testcontainers checks for open ports during container startup and will shave up to a couple of seconds from your test suite.

We are grateful for the ongoing support of our community and users and thank each of our awesome contributors!

🚀 Features & Enhancements

• Oracle Database: Update OracleContainer and re-activate on CI (#4298) @kiview & (#4402) @KyleAure
• Azure Cosmos DB: Introduce CosmosDBEmulatorContainer (#4303) @okohub
• Host Port Access: Provide an API to force access to the host (#4584) @bsideup
• Cassandra: Tune Cassandra options for faster startup (#4309) @bsideup
• Performance: Perform container startup port checks in parallel (#4463) @bsideup
• Performance: Retry internal port checking in the same exec (#4460) @bsideup
• OrientDB: Use log wait strategy for more reliable readiness detection (#4471) @rnorth
• Fix flaky kafka cluster example (#4549) @rnorth
• Give EnvironmentAndSystemPropertyClientProviderStrategy the highest priority (#4472) @kiview
• Avoid overriding of files copied to container using subsequent withCopyFileToContainer (#2957) @findepi
• Make TimescaleDB available with JDBC syntax (#3891) @raynigon
• Refactor JDBC URL parsing to support different Oracle URLs (#4476) @rnorth
• Allow to disable configuration of EnvironmentAndSystemPropertyClientProviderStrategy through Testcontainers (#4387) @kiview
• Shorten fallback to another strategy (#4386) @pioorg
• Update Kafka config dynamically (#4316) @bsideup
• Disable Chrome's GPU support in BrowserWebDriverContainer (#4315) @kiview

🐛 Bug Fixes

• Prevent Compose image pre-fetching from pulling all tags when tag is absent (#4538) @rnorth
• Randomize naming for createVolumeDirectory method (#4195) @johnathana
• Perform distinct/applicable filtering after identifying configured and available Docker client strategies (#4467) @bsideup
• Use POSIX mode for large numbers in tar archives (#4384) (#4388) @schmidt-galen-heb

📖 Documentation

• Update GitLab CI docs: Add --tls=false to docker-in-docker to avoid startup delays (#4573) @ulrichwinter
• Document Dependabot merge process (#4556) @kiview
• Add togglz as user (#4484) @bennetelli
• Add Alkira as user (#4370) @sankee168
• Add Elastic as user (#4369) @mdelapenya
• Update RELEASING.md (#4295) @kiview

🧹 Housekeeping

• Remove unused @ClassRule container in KafkaContainerTest and use cp-kafka:6.2.1 as default (#4564) @kiview
• Remove httpclient5_test (#4562) @bsideup
• Temporarily disable Thundra on master branch (#4570) @rnorth
• Enable JUnitPlatform for Spock tests (#4568) @kiview
• Skip japicmp for new modules (#4569) @rnorth
• Fix AuthenticatedImagePullTest (#4560) @bsideup
• Switch from AdoptOpenJDK to Temurin and latest JDK 8. (#4537) @pioorg
• Fix dangling constructor reference in deprecation note (#4443) @JarvisCraft
• Tidy up core's build file (#4207) @bsideup
• couchbase: add debug-level phase timings. (#4466) @daschl
• Fix CmdModifierTest#testMemoryLimitModified in cgroup2 environment. (#4375) @cac03
• Add Thundra Foresight Integration to the CI Build (#4313) @rwxdash
• Add japicmp to every module (#4364) @bsideup
• Fix failing PublicBinaryAPITest for DynamicPollInterval (#4353) @kiview

📦 Dependency updates

• Upgrade ryuk image to 0.3.3 (#4581) @rnorth
• Upgrade ryuk image to 0.3.2 (#4359) @rnorth
• Update Gradle Wrapper to 7.2 (#4379) @github-actions
• Update JUnit 4.12 to 4.13.2. (#4167) @michael-simons
• Update to docker-java 3.2.12 (#4459) @bsideup

What's Changed

Testcontainers 1.16.0 is here! 🎉

This release brings many small fixes and improvements; among them:

Better M1 Mac compatibility

Users of M1 Mac will be pleased to know that Testcontainers now falls back to pulling x86_64 images when ARM64 images are unavailable, meaning that Docker's QEMU compatibility mode will be used to run the image. It's not perfect - not every image runs under QEMU. However, this allows Testcontainers users with M1 Macs to use more images than they could previously.

If possible, users should use recently published images for their dependencies which have a native ARM64 variant, rather than relying on QEMU emulation.

Startup performance and reliability improvements

Some issues affecting container startup time and reliability (especially with Docker for Windows) have been fixed.

Additionally, this release uses the latest version of docker-java and uses an Apache HttpClient5 transport by default. This resolves bugs encountered by some users when the previous default transport (okhttp) relating to image pulling.

As always, thank you to our many users and contributors!

🚀 Features & Enhancements

• Fallback to x86 image if image pulling fails (#4290) @bsideup
• Spock Testcontainers annotation is now inherited (#4053) @tlefevre
• Use Apache HttpClient5 transport as the default (#4287) @bsideup
• Remove visible assertions dependency (#4010) @bsideup
• Couchbase: Add support for community edition of couchbase server (#4221) @Gerschtli
• Couchbase: Update to latest version, add flushEnabled flag (#4041) @Gerschtli
• Only publish exposed ports (#4122) @rnorth
• Allow DOCKER_HOST and related settings to be set in ~/.testcontainers.properties (#4118) @rnorth
• Use implicit strategy when docker.host configuration is set (#4175) @rnorth
• Improve logging in InternalCommandPortListeningCheck (#2984) (#3001) @vcvitaly

🐛 Bug Fixes

• Remove withPublishAllPorts from Ryuk and stabilize containerInfo content on start (#4263) @kiview
• Allow for docker timestamps with timezone offsets (#4073) @candrews
• Fix KafkaContainer with multiple networks defined (#4213) @DennisFederico
• Fixed potential NPE in MountableFile (#4193) @fkorotkov
• Improve log messages when database container test query fails (#3015) @vcvitaly

📖 Documentation

• Remove GitHub Sponsors button (#4217) @rnorth
• Add @oleg-nenashev as backer, reference @jenkinsci and @cloudbees as adopters (#4170) @oleg-nenashev
• Docs: Use testImplementation instead of deprecated testCompile (#4054) @slovdahl
• Docs: Add Backbase as Bronze sponsor (#4039) @torrespro

🧹 Housekeeping

• Split Windows CI into core and non-core steps (#4293) @rnorth
• Upgrade alpine images for better M1 compatibility (#4291) @rnorth
• Switch from using Travis to GitHub Actions for release (#3434) @rnorth
• Remove stalebot (#4216) @rnorth
• Cleanup japicmp excludes (#4192) @bsideup
• Update to Gradle 7 (#4171) @bsideup
• Add combine-prs workflow (#4176) @rnorth
• Bump actions/cache from 2.1.3 to 2.1.6 (#4162) @dependabot
• Combined dependencies PR (#4135) @rnorth
• Only run update-* and release-drafter on original repository, not on forks (#4104) @mrotteveel
• Reduce dependabot bump rate to monthly (#4083) @rnorth
• Use up-to-date MySQL docker images (#4059) @rnorth

📦 Dependency updates

• Remove visible assertions dependency (#4010) @bsideup
• Update docker-java to 3.2.11 (#4220) @bsideup
• Update to Gradle 7 (#4171) @bsideup

What's Changed

🚀 Features & Enhancements

• Localstack: Make it possible to provide custom LocalStack services (#3995) @bsideup
• Localstack: Add EC2 to localstack services enum (#3955) @pinzon
• Add TrinoContainer, a container for Trino (#3668) @findepi
• Compose: Make DockerComposeContainer only pull necessary images when multiple compose files were given (#3787) @askfor
• Delegate copyFile{To,From}Container's state verification to Docker (#3805) @michael-simons

🐛 Bug Fixes

• MySQL: Fix problem of starting up mysql 5.7.33 version when user is root (#3953) @seveneves
• JDBC: Prevent ContainerDatabaseDriver from throwing NPEs when on classpath but not initialized (#3976) @mrotteveel
• Filter mapped ports when port numbers are not specified (replaces #3948) (#3979) @rnorth
• Compose: Fix NPE bug with docker-compose files in working directory (#3866) @GooseMagnet
• Selenium: Fix mp4 recording to be compatible with Firefox (#3812) @leonard84

📖 Documentation

• Update docs to clarify shading approach (#3974) @bsideup
• Gitlab: add information for TLS disabled mode (#2466) @pmihalcin
• Add example of mapping from file in system (#3808) @kevinrobayna
• Add Cloudflare Web Analytics to docs site (#3896) @rnorth
• Bump docs environment to python 3.7 (#3871) @xp-vit
• Add Backbase (#3870) @torrespro
• Documentation TransferWise has changed its name as Wise. (#3873) @muzir
• Add Google (#3868) @jamesward

🧹 Housekeeping

• Pin localstack to 0.12.8 (#3981) @rnorth
• Bump docs environment to python 3.7 (#3871) @xp-vit
• Fix GitHub Actions error due to short SHA form (#3874) @rnorth

📦 Dependency updates

• Update docker-java to 3.2.8 (#3980) @bsideup
• Bump s3 from 2.15.56 to 2.16.34 in /modules/localstack (#3963) @dependabot
• Bump pulsar-client from 2.7.0 to 2.7.1 in /modules/pulsar (#3913) @dependabot
• Bump aws-java-sdk-sqs from 1.11.930 to 1.11.986 in /modules/localstack (#3942) @dependabot
• Bump elasticsearch-rest-client from 7.10.1 to 7.12.0 in /modules/elasticsearch (#3945) @dependabot
• Bump org.jetbrains.kotlin.jvm from 1.4.21-2 to 1.4.32 in /examples (#3947) @dependabot
• Bump release-drafter/release-drafter from e5ccf147077e46b0225a80bbe314d795d77bb7a2 to 5.15.0 (#3915) @dependabot
• Bump testcontainers from 1.15.1 to 1.15.2 in /core (#3795) @dependabot
• Docs: Bump jinja2 from 2.11.2 to 2.11.3 (#3897) @dependabot

What's Changed

• What 1984 means to you? To us, this number means PR #1984, one of the oldest PRs we had open and... finally merged! 😅 Thanks to an amazing contribution by @seglo, we now provide an example of testing Kafka clusters where multiple KafkaContainers are connected into one network. Try it!
• Another "old" PR is #3180 by @oussamabadr. Those of you who run Selenium tests with Testcontainers will appreciate this newly added option to use (scrollable!) MP4 format instead of FLV.
• The connection with Ryuk (our watchdog sidecar container) now sets the socket timeout and retries the failures - helps with some rare networking edge cases. (#3682) @diegolovison
• The logs consumer no longer adds extra new lines thanks to #3752 by @perlun
• Locally built images no longer get affected by the hub.image.name.prefix setting! (#3666) @reda-alaoui
• Jackson dependency is now forced to an older version to help with NoClassDefFoundError (com/fasterxml/jackson/annotation/JsonMerge).

And more!

🚀 Features & Enhancements

• Switch to Presto image hosted on GHCR (#3667) @findepi
• Implement getDatabaseName() in CockroachContainer (#3778) @croemmich
• Make recorder .flv videos scrollable (#512) (#3180) @oussamabadr
• Support HTTP headers on HttpWaitStrategy (#2549) @renatomefi
• Show port mappings in HttpWaitStrategy (#2341) @aguibert
• Support newer versions of CockroachDB by changing the docker command (#3608) @giger85
• Improve logging for port listener (#3736) @artjomka
• couchbase: wait until all services are part of the config (#3003) @daschl
• Support Ryuk socket timeout (#3682) @diegolovison
• Add init command parameter to Vault container (#3188) @tandrup
• Startables#deepStart with varargs (#3261) @jochenchrist

🐛 Bug Fixes

• Remove extra newlines in container log output (#3752) @perlun
• Fix handling of locally built images when used with hub.image.name.prefix (#3666) @reda-alaoui

📖 Documentation

• Kafka cluster example (#1984, #3758) @seglo
• Documentation PostGIS JDBC url sample version update (#3606) @aulea
• GenericContainer: fix typo in Javadoc (#3684) @perlun
• Added documentation for Bigtable Emulator container (#3708) @RamazanYapparov
• Clarify usage of host port exporting (#3421) @alxgrk
• Rename Presto to Trino (#3649) @martint

🧹 Housekeeping

• update release drafter to v5.13.0 (#3632) @jetersen
• Remove duplicated dependency in jdbc-test module (#3664) @giger85
• add github actions to dependabot config (#3633) @jetersen
• Remove ciMate (#3631) @bsideup

📦 Dependency updates

• update release drafter to v5.13.0 (#3632) @jetersen
• Force Jackson version (#3602) @bsideup
• Bump aws-java-sdk-sqs from 1.11.884 to 1.11.930 in /modules/localstack (#3660) @dependabot
• Bump guava from 30.0-jre to 30.1-jre in /modules/jdbc-test (#3622) @dependabot
• Bump aws-java-sdk-s3 from 1.11.929 to 1.11.930 in /modules/localstack (#3659) @dependabot
• Bump org.jetbrains.kotlin.plugin.spring from 1.3.31 to 1.4.21-2 in /examples (#3646) @dependabot
• Bump gradle-update/update-gradle-wrapper-action from 74a035c to 1.0.9 (#3653) @dependabot
• Bump cucumber-junit from 6.8.1 to 6.9.1 in /examples (#3625) @dependabot
• Bump testcontainers from 1.14.3 to 1.15.1 in /core (#3587) @dependabot
• Bump transport from 7.10.0 to 7.10.1 in /modules/elasticsearch (#3590) @dependabot
• Bump aws-java-sdk-s3 from 1.11.882 to 1.11.929 in /modules/localstack (#3654) @dependabot
• Bump s3 from 2.15.14 to 2.15.56 in /modules/localstack (#3650) @dependabot
• Bump org.jetbrains.kotlin.jvm from 1.3.31 to 1.4.21-2 in /examples (#3645) @dependabot
• Bump guava from 30.0-jre to 30.1-jre in /core (#3627) @dependabot
• Bump ad-m/github-push-action from 68af9897f2b021035ca3952bf354bbb4675c1762 to 0.6.0 (#3658) @dependabot
• Bump aws-java-sdk-dynamodb from 1.11.901 to 1.11.929 in /modules/dynalite (#3652) @dependabot
• Bump gradle/wrapper-validation-action from e2c57ac to 1.0.3 (#3657) @dependabot
• Update actions/cache requirement to v2.1.3 (#3651) @dependabot
• Bump solr-solrj from 8.6.3 to 8.7.0 in /examples (#3446) @dependabot
• Bump cucumber-java from 6.8.1 to 6.9.1 in /examples (#3624) @dependabot
• Bump r2dbc-mariadb from 0.8.4-rc to 1.0.0 in /modules/mariadb (#3593) @dependabot
• Bump org.springframework.boot from 2.3.4.RELEASE to 2.4.1 in /examples (#3594) @dependabot
• Bump jedis from 3.3.0 to 3.4.0 in /examples (#3595) @dependabot
• Bump tomcat-jdbc from 9.0.40 to 10.0.0 in /modules/jdbc (#3592) @dependabot
• Bump elasticsearch-rest-client from 7.10.0 to 7.10.1 in /modules/elasticsearch (#3589) @dependabot
• Bump jedis from 3.3.0 to 3.4.0 in /core (#3586) @dependabot
• Bump rest-assured from 4.3.1 to 4.3.3 in /modules/vault (#3588) @dependabot
• Bump r2dbc-mssql from 0.8.4.RELEASE to 0.8.5.RELEASE in /modules/mssqlserver (#3397) @dependabot
• Bump mockito-core from 3.5.15 to 3.6.28 in /modules/junit-jupiter (#3539) @dependabot
• Bump mockito-core from 3.5.13 to 3.6.28 in /core (#3542) @dependabot
• Bump mssql-jdbc from 9.1.0.jre8-preview to 9.1.1.jre8-preview in /modules/mssqlserver (#3563) @dependabot
• Bump pulsar-client-admin from 2.6.1 to 2.7.0 in /modules/pulsar (#3566) @dependabot
• Bump pulsar-client from 2.6.1 to 2.7.0 in /modules/pulsar (#3565) @dependabot
• Bump json from 20180813 to 20201115 in /examples (#3567) @dependabot
• Bump influxdb-java from 2.20 to 2.21 in /modules/influxdb (#3568) @dependabot
• Bump assertj-core from 3.18.0 to 3.18.1 in /modules/vault (#3486) @dependabot
• Upgrade Ryuk to 0.3.1 (#3629) @rnorth

What's Changed

This release focuses on stability and compatibility:

• Docker 20.10 introduced a new version of the API, 1.41, where they removed quite a few deprecations, and we were using one of them. If you were getting "No such image: testcontainers/ryuk:0.3.0" - that's the cause.
• In 1.15.0, ImageNameSubstitutor was added to help dealing with Docker Hub's rate limits. 1.15.1 introduces a default implementation that automatically prefixes every image without the registry. See the docs for more details.
• docker-java was updated to the latest version that improves the BitBucket Pipelines compatibility, Windows path handling, Socket I/O and related thread stucking on recv.
• The MockServer module is now compatible with the latest version of the image (5.11.x) and got an improved wait strategy.

🚀 Features & Enhancements

• Make MockServer compatible with newer (5.11.x) versions (#3437) @lanwen
• Update to docker-java 3.2.7 (#3577) @bsideup
• Expose Toxiproxy control port and proxy name (#3454) @aartigao
• Add HttpWaitStrategy#withMethod (#3533) @xaviarias
• Added Bigtable emulator container support (#3466) @saturnism
• Default prefixing image substitutor (#3413) @rnorth
• avoid code duplication by using ContainerState in ResourceReaper (#3573) @bsideup
• Pre-resolve LazyDockerClient from GenericContainer#start() (#3530) @bsideup

🐛 Bug Fixes

• Always use toAbsolutePath() for MountableFile (#3514) @kiview
• PostgisContainerProvider ignores tag parameter and uses DEFAULT_TAG (#3465) @hlavki
• Avoid using the image name filter. Fixes #3574 (#3575) @bsideup
• Support timestamps with offset from "inspect image" (#3055) @acanda
• Search Oracle image name in classpath (#3439) @eyalkoren
• Selenium: Restore getDockerImageForCapabilities method to public scope (#3441) @rnorth

📖 Documentation

• More examples in the gcloud module doc (#3463) @saturnism
• Update Presto URL to use https in 'Who is using' list (#3438) @findepi
• Add Presto project as Testcontainers user (#3435) @findepi

🧹 Housekeeping

• Add toxiproxy to dependabot.yml (#3502) @sullis

📦 Dependency updates

• Use lower Jackson version to avoid conflicts. (#3579) @bsideup
• Update to docker-java 3.2.7 (#3577) @bsideup
• Bump toxiproxy-java from 2.1.3 to 2.1.4 in /modules/toxiproxy (#3524) @dependabot
• Bump transport from 7.9.2 to 7.10.0 in /modules/elasticsearch (#3473) @dependabot
• Bump assertj-core from 3.17.2 to 3.18.1 in /core (#3471) @dependabot
• Bump assertj-core from 3.18.0 to 3.18.1 in /modules/junit-jupiter (#3470) @dependabot
• Bump assertj-core from 3.17.2 to 3.18.1 in /modules/kafka (#3469) @dependabot
• Bump assertj-core from 3.17.2 to 3.18.1 in /modules/pulsar (#3475) @dependabot
• Bump tomcat-jdbc from 9.0.39 to 9.0.40 in /modules/jdbc (#3509) @dependabot
• Bump tomcat-jdbc from 9.0.39 to 9.0.40 in /modules/jdbc-test (#3513) @dependabot
• Update to docker-java 3.2.6 (#3498) @bsideup
• Bump assertj-core from 3.17.2 to 3.18.1 in /modules/database-commons (#3479) @dependabot
• Bump assertj-core from 3.18.0 to 3.18.1 in /modules/neo4j (#3477) @dependabot
• Bump elasticsearch-rest-client from 7.9.2 to 7.10.0 in /modules/elasticsearch (#3474) @dependabot
• Bump aws-java-sdk-dynamodb from 1.11.882 to 1.11.901 in /modules/dynalite (#3472) @dependabot

What's Changed

Notable changes from previous release candidates (1.15.0-rc1, 1.15.0-rc2) are called out in these release notes. If migrating from 1.14.3, please see the RC release notes for other changes.

🚀 Features & Enhancements

• 🎉 Image substitution (#3102) @rnorth

  This change introduces a mechanism for programmatic image name substitution, as one of a number of mitigations for Docker Hub image pull rate limiting. For more information, please see the documentation.

• 🥳 Add GCloud module for Google Cloud Datastore, Firestore, PubSub, and Spanner emulators (#2690) @eddumelendez

  For more information, please check out the documentation for this module!

Included in 1.15.0-rc2

• Add image compatibility checks (#3021) @rnorth
  The majority of modules make assumptions about the container image being used - for example, port numbers, expected log lines, etc. When asking users to provide their own images with modules, it is potentially confusing if the provided image diverges from the original 'vendor-provided' image that the module was built to support.

  This change is intended to ensure that, if the user provides their own image that is not the same as the vendor-provided one, they are given adequate warning and forced to signal that this is intentional.

  For example:

  • new KafkaContainer(DockerImageName.parse("confluentinc/cp-kafka:any")) will just work, because confluentinc/cp-kafka matches the image name that KafkaContainer was designed to work with
  • but new KafkaContainer(DockerImageName.parse("some-other-kafka")) will not work immediately, because some-other-kafka may be an entirely divergent image from confluentinc/cp-kafka. In this case, the user would be prompted to add .asCompatibleSubstituteFor("confluentinc/cp-kafka") which tells Testcontainers that this is a conscious decision

  This PR adds to DockerImageName:

  • asCompatibleSubstituteFor(DockerImageName) and asCompatibleSubstituteFor(String) methods which may be used to claim compatibility with a vendor-provided image
  • isCompatibleWith(DockerImageName) and assertCompatibleWith(DockerImageName) methods which can be used by Testcontainers to check that the provided image is compatible with the expected vendor-provided image

Included in 1.15.0-rc1

• Add a rootless Docker strategy (#2985) @bsideup. This allows Testcontainers to be used with Docker's rootless mode. All Testcontainers' features and modules are compatible with Docker rootless mode, but we would appreciate feedback on unidentified edge cases.

• Deprecate ambiguous constructors (#2839) @rnorth. This change affects the majority of constructors for container classes. This is intended to encourage users to specify an exact docker image and tag for dependencies, rather than relying on a (potentially outdated) default image chosen by Testcontainers.

  • new XyzContainer()-style and new XyzContainer(String)-style constructors are deprecated throughout, in favour of a strongly typed new XyzContainer(DockerImageName)-style constructor.
  • Users should identify an appropriate Docker image for their test dependencies, and use as follows: new XyzContainer( DockerImageName.parse( "the/image:tag" ) ).
  • We expect to make some further improvements in this area before the final 1.15.0 release.

• Un-shade docker-java-api (#2882) @bsideup. This change follows some significant refactoring of the docker-java library, and should resolve various issues associated with shading of dependencies.

• New optional transport based on Apache HttpClient5. This is a very promising transport that most probably will become the default in future versions of Testcontainers. You can give it a try by putting transport.type = httpclient5 to $HOME/.testcontainers.properties.

⚠️ Breaking API changes

Included in 1.15.0-rc1

While we expect that the vast majority of users will notice no difference, these changes can be considered breaking, so warrant special mention:

• Un-shade docker-java-api (#2882) @bsideup
• Remove deprecated implicit network in KafkaContainer (#2932) @bsideup
• Clean up deprecated methods (#2835) @bsideup
• Migrate postgis image to the postgis/postgis docker hub repo. (#2797) @Sanych

Other improvements

• Refactor TestcontainersConfiguration to allow config by env var (#3411) @rnorth
• Elasticsearch: Add withPassword(String) method for secure access (#2321) @dadoonet
• Vault: add a fluent API for configuring Vault's logging level (#2231) @fullkomnun
• Add gcloud endpoint accessors (#3344) @rnorth
• docker-machine: get full remote daemon URL, to allow for use of custom daemon port (#2769) (#3237) @vcvitaly
• Allow users to specify a MongoDB database name (#2980) @silaev
• Presto: Bump default Presto version (used in deprecated constructor and unversioned JDBC URL) from 329 to 344 (#3312) @findepi
• Reduce severity of warning for failed auth config lookups (fixes #1399) (#3353) @DevilzOwn
• When an image version is not specified, use latest as the default tag (#3313) @rnorth
• Don't display a stack trace in the logs when .testcontainers.properties is not found (#2293) @rishumehrotra

🐛 Bug Fixes

• Fix use of HostPortWaitStrategy with Postgres container (fixes #3382) (#3403) @pawellozinski
• Support Confluent Platform 6 in Kafka (#3293) @bsideup
• Add support for MongoDB 4.4 (#3083) @kiview
• Remove potential NullPointerException when trying to log an error in VNC recorder (#3408) @codefiddler

📖 Documentation

• Correct documentation for ryuk image (#3383) @ae-govau
• Latest kafka container 5.4.3 (#3402) @artamonovkirill
• Fix a small typo in documentation (#3349) @dadoonet
• Update image references in Localstack module docs (#3076) @artamonovkirill
• Elasticsearch: Add test and documentation for secured cluster, bump default Elasticsearch version (deprecated constructor) from 6.4.1 to 7.9.2 (#2320) @dadoonet
• Increase memory limits used in example (#3340) @rnorth

🧹 Housekeeping

• Bump Python mkdocs tool dependency to address CVE-2019-10906 (#3379) @artamonovkirill
• Update sponsors (#3410) @rnorth
• Latest kafka container 5.4.3 (#3402) @artamonovkirill
• Update tests to use emulators image (#3406) @eddumelendez
• Change image used for test to avoid image name cache preventing proper pull (#3378) @rnorth
• Fix remote gradle cache 400 InvalidArgument error (#3346) @rnorth
• Use a lighter weight image for MultiplePortsExposedTest (#3343) @rnorth
• Remove GitHub Actions cache restore keys (#3342) @rnorth
• Increase memory limits used in example (#3340) @rnorth
• Upgrade mkdocs-codeinclude-plugin (#3354) @rnorth
• Always continue on error for examples CI (#3339) @rnorth
• Add workflow for Update Gradle Wrapper Action. (#3297) @cristiangreco

📦 Dependency updates

What's Changed

This release includes a fix for a breaking change that appeared in Docker for Mac v2.4.0.0 (#3159). We recommend upgrading to this version of Testcontainers ASAP.

🚀 Features & Enhancements

• Add image compatibility checks (#3021) @rnorth
  The majority of modules make assumptions about the container image being used - for example, port numbers, expected log lines, etc. When asking users to provide their own images with modules, it is potentially confusing if the provided image diverges from the original 'vendor-provided' image that the module was built to support.

  This change is intended to ensure that, if the user provides their own image that is not the same as the vendor-provided one, they are given adequate warning and forced to signal that this is intentional.

  For example:

  • new KafkaContainer(DockerImageName.parse("confluentinc/cp-kafka:any")) will just work, because confluentinc/cp-kafka matches the image name that KafkaContainer was designed to work with
  • but new KafkaContainer(DockerImageName.parse("some-other-kafka")) will not work immediately, because some-other-kafka may be an entirely divergent image from confluentinc/cp-kafka. In this case, the user would be prompted to add .asCompatibleSubstituteFor("confluentinc/cp-kafka") which tells Testcontainers that this is a conscious decision

  This PR adds to DockerImageName:

  • asCompatibleSubstituteFor(DockerImageName) and asCompatibleSubstituteFor(String) methods which may be used to claim compatibility with a vendor-provided image
  • isCompatibleWith(DockerImageName) and assertCompatibleWith(DockerImageName) methods which can be used by Testcontainers to check that the provided image is compatible with the expected vendor-provided image

• Add support for Docker compose withOptions(...) (#2827) @Gapmeister66

☠️ Deprecations

• Exclude id from NetworkImpl.NetworkImplBuilder (#8125) (#2807) @quincy

🐛 Bug Fixes

• Fix bind mounts for ResourceReaper/ryuk and ContainerisedDockerCompose on macOS (#3159) @gesellix
• Remove dependency upon internet URLs for selenium tests (#3271) @rnorth
• #3057 Fix jetbrains annotations configuration scope (#3157) @wpanas
• Whitespace configuration fix (#3127, fixes #3053) (#3127) @artjomka

📖 Documentation

• Remove use of implicit network for multi-container Kafka (#3128) @iaintatchbbc
• #3129 Fix dead link for CircleCI configuration (#3156) @wpanas

🧹 Housekeeping

• Make testMatrix task emit all check tasks, rather than filtering out up-to-date tasks (#3287) @rnorth
• Remove dependency upon internet URLs for selenium tests (#3271) @rnorth
• Use testCompileClasspath instead of testCompileOnly (#3219) @colltoaction
• Add some more logs to bash script used for DockerHealthcheckWaitStratgyTest (#2988) @kiview
• Fix the Rootless Docker CI job (#3050) @bsideup
• Add continue-on-error for cache step, and upgrade GH cache action (#3133) @rnorth

📦 Dependency updates