Skip to content

Releases: testcontainers/testcontainers-java

1.17.2

19 May 20:56
fffab55

Choose a tag to compare

What's Changed

While this release had a major focus on stability, we managed to optimize the startup sequence and it should make your tests even faster!

Here is what it takes to have a Redis up and running with Testcontainers, end-to-end from the test's start to an instance ready to be connected:
Before (1.17.1): 2.4s
Before (1.17.2): 1.7s 🚀

And here is just the "initialize Testcontainers" measurements:

Before (1.17.1): 1102ms
Before (1.17.2): 928ms

How we did it? We noticed that we can cache a couple of Docker responses, plus also removed now obsolete (yet expensive!) disk space check.

🚀 Features & Enhancements

🐛 Bug Fixes

📖 Documentation

🧹 Housekeeping

📦 Dependency updates

1.17.1

13 Apr 11:44
66e4be2

Choose a tag to compare

What's Changed

🐛 Bug Fixes

  • Fix StackOverflowError in DockerClientFactory#client (#5262) @bsideup

📖 Documentation

1.17.0

11 Apr 18:39
17407ef

Choose a tag to compare

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

🐛 Bug Fixes

📖 Documentation

🧹 Housekeeping

📦 Dependency updates

Click to expand...
  • Update Gradle Wrapper to 7.4.2 (#5193) @github-actions
  • Update Gradle Wrapper to 7.4.1 (#5168) @github-actions
  • Update to docker-java 3.2.13 (#5045) @bsideup
  • Update Gradle Wrapper to 7.4 (#5036) @github-actions
  • Upgrade mkdocs (#3443) @rnorth
  • Bump zip4j from 2.9.1 to 2.10.0 in /modules/hivemq (#5242) @dependabot
  • Bump hivemq-extension-sdk from 4.7.4 to 4.7.5 in /modules/hivemq (#5241) @dependabot
  • Bump google-cloud-firestore from 3.0.14 to 3.0.21 in /modules/gcloud (#5239) @dependabot
  • Bump google-cloud-pubsub from 1.115.1 to 1.116.3 in /modules/gcloud (#5238) @dependabot
  • Bump google-cloud-datastore from 2.2.2 to 2.3.0 in /modules/gcloud (#5236) @dependabot
  • Bump reactor-core from 3.4.15 to 3.4.16 in /modules/r2dbc (#5234) @dependabot
  • Bump google-cloud-bigtable from 2.5.2 to 2.6.1 in /modules/gcloud (#5233) @dependabot
  • Bump mongodb-driver-sync from 4.5.0 to 4.5.1 in /modules/mongodb (#5231) @dependabot
  • Bump client-java from 14.0.0 to 15.0.0 in /modules/k3s (#5230) @dependabot
  • Bump trino-jdbc from 369 to 375 in /modules/trino (#5228) @dependabot
  • Bump r2dbc-postgresql from 0.8.11.RELEASE to 0.8.12.RELEASE in /modules/r2dbc (#5227) @dependabot
  • Bump okhttp from 3.14.9 to 4.9.3 in /modules/solr (#5229) @dependabot
  • Bump peter-evans/create-pull-request from 3.12.1 to 4.0.1 (#5226) @dependabot
  • Bump actions/cache from 2.1.7 to 3.0.1 (#5225) @dependabot
  • Bump neo4j-java-driver from 4.4.3 to 4.4.5 in /examples (#5223) @dependabot
  • Bump s3 from 2.17.108 to 2.17.162 in /modules/localstack (#5222) @dependabot
  • Bump aws-java-sdk-logs from 1.12.169 to 1.12.191 in /modules/localstack (#5221) @dependabot
  • Bump awaitility from 4.1.1 to 4.2.0 in /core (#5219) @dependabot
  • Bump logback-classic from 1.2.10 to 1.2.11 in /examples (#5216) @dependabot
  • Bump org.jetbrains.kotlin.plugin.spring from 1.6.10 to 1.6.20 in /examples (#5215) @dependabot
  • Bump transport from 7.17.1 to 7.17.2 in /modules/elasticsearch (#5214) @dependabot
  • Bump mockito-core from 4.3.1 to 4.4.0 in /modules/junit-jupiter (#5212) @dependabot
  • Bump jedis from 4.1.1 to 4.2.1 in /examples (#5210) @dependabot
  • Bump java-client from 3.2.5 to 3.2.6 in /modules/couchbase (#5209) @dependabot
  • Bump aws-java-sdk-s3 from 1.12.169 to 1.12.191 in /modules/localstack (#5206) @dependabot
  • Bump rest-assured from 4.5.1 to 5.0.0 in /modules/vault (#5207) @dependabot
  • Bump neo4j-java-driver from 4.4.3 to 4.4.5 in /modules/neo4j (#5205) @dependabot
  • Bump elasticsearch-rest-client from 7.16.2 to 8.1.2 in /modules/elasticsearch (#5202) @dependabot
  • Bump awaitility from 4.1.1 to 4.2.0 in /modules/couchbase (#5199) @dependabot
  • Bump tomcat-jdbc from 10.0.16 to 10.0.20 in /modules/jdbc (#5196) @dependabot
  • Bump tomcat-jdbc from 10.0.16 to 10.0.20 in /modules/jdbc-test (#5195) @dependabot
  • Bump actions/checkout from 2 to 3 (#5140) @dependabot
  • Bump google-cloud-firestore from 3.0.11 to 3.0.14 in /modules/gcloud (#5143) @dependabot
  • Bump google-cloud-spanner from 6.17.4 to 6.20.0 in /modules/gcloud (#5142) @dependabot
  • Bump actions/setup-java from 2.5.0 to 3 (#5141) @dependabot
  • Bump actions/checkout from 2 to 3 (#5140) @dependabot
  • Bump aws-java-sdk-dynamodb from 1.12.150 to 1.12.169 in /modules/dynalite (#5138) @dependabot
  • Bump transport from 7.17.0 to 7.17.1 in /modules/elasticsearch (#5136) @dependabot
  • Bump org.springframework.boot from 2.6.3 to 2.6.4 in /examples (#5137) @dependabot
  • Bump elasticsearch-rest-client from 7.16.2 to 8.0.1 in /modules/elasticsearch (#5135) @dependabot
  • Bump guava from 31.0.1-jre to 31.1-jre in /modules/jdbc-test (#5133) @dependabot
  • Bump aws-java-sdk-logs from 1.12.139 to 1.12.169 in /modules/localstack (#5132) @dependabot
  • Bump neo4j from 3.5.29 to 3.5.31 in /modules/neo4j (#5131) @dependabot
  • Bump aws-java-sdk-sqs from 1.12.150 to 1.12.169 in /modules/localstack (#5130) @dependabot
  • Bump aws-java-sdk-s3 from 1.12.150 to 1.12.169 in /modules/localstack (#5127) @dependabot
  • Bump postgresql from 42.3.2 to 42.3.3 in /examples (#5090) @dependabot
  • Bump google-cloud-datastore from 2.2.2 to 2.2.4 in /modules/gcloud (#5088) @dependabot
  • Bump release-drafter/release-drafter from 5.17.6 to 5.18.1 (#5087) @dependabot
  • Bump amqp-client from 5.14.1 to 5.14.2 in /core (#5080) @dependabot
  • Bump azure-cosmos from 4.24.0 to 4.26.0 in /modules/azure (#5079) @dependabot
  • Bump google-cloud-bigtable from 2.5.2 to 2.5.3 in /modules/gcloud (#5075) @dependabot
  • Bump kubernetes-client from 5.11.0 to 5.12.1 in /modules/k3s (#5071) @dependabot
  • Bump amqp-client from 5.14.1 to 5.14.2 in /modules/rabbitmq (#5070) @dependabot
  • Bump rest-assured from 4.4.0 to 4.5.1 in /modules/vault (#5072) @dependabot
  • Bump postgresql from 42.3.1 to 42.3.3 in /modules/postgresql (#5064) @dependabot
  • Bump postgresql from 42.3.2 to 42.3.3 in /modules/cockroachdb (#5063) @dependabot
  • Bump reactor-core from 3.4.14 to 3.4.15 in /modules/r2dbc (#5065) @dependabot
  • Bump postgresql from 42.3.2 to 42.3.3 in /modules/junit-jupiter (#5059) @dependabot
  • Bump hivemq-extension-sdk from 4.7.3 to 4.7.4 in /modules/hivemq (#5061) @dependabot
  • Bump mongodb-driver-sync from 4.4.1 to 4.5.0 in /modules/mongodb (#5062) @dependabot
  • Bump spock-core from 2.0-groovy-3.0 to 2.1-groovy-3.0 in /modules/spock (#5057) @dependabot
  • Bump google-cloud-datastore from 2.2.2 to 2.2.3 in /modules/gcloud (#5013) @dependabot
  • Bump cu...
Read more

1.16.3

18 Jan 14:58
34cfdc8

Choose a tag to compare

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

📖 Documentation

🧹 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

Click to expand...
  • Bump actions/cache from 2.1.6 to 2.1.7 (#4757) @dependabot
  • Bump actions/setup-java from 2.3.1 to 2.4.0 (#4756) @dependabot
  • Bump actions/setup-java from 2.4.0 to 2.5.0 (#4832) @dependabot
  • Bump amqp-client from 5.13.1 to 5.14.0 in /core (#4745) @dependabot
  • Bump amqp-client from 5.7.0 to 5.14.0 in /modules/rabbitmq (#4889) @dependabot
  • Bump amqp-client from 5.7.0 to 5.14.0 in /modules/rabbitmq (#4889) @dependabot
  • Bump annotations from 20.0.0 to 23.0.0 in /modules/presto (#4880) @dependabot
  • Bump annotations from 20.0.0 to 23.0.0 in /modules/presto (#4880) @dependabot
  • Bump annotations from 20.0.0 to 23.0.0 in /modules/rabbitmq (#4894) @dependabot
  • Bump annotations from 20.0.0 to 23.0.0 in /modules/rabbitmq (#4894) @dependabot
  • Bump annotations from 20.0.0 to 23.0.0 in /modules/trino (#4892) @dependabot
  • Bump annotations from 22.0.0 to 23.0.0 in /core (#4747) @dependabot
  • Bump annotations from 22.0.0 to 23.0.0 in /examples (#4753) @dependabot
  • Bump annotations from 22.0.0 to 23.0.0 in /modules/jdbc (#4726) @dependabot
  • Bump annotations from 22.0.0 to 23.0.0 in /modules/mysql (#4738) @dependabot
  • Bump annotations from 22.0.0 to 23.0.0 in /modules/nginx (#4733) @dependabot
  • Bump annotations from 22.0.0 to 23.0.0 in /modules/oracle-xe (#4725) @dependabot
  • Bump annotations from 22.0.0 to 23.0.0 in /modules/postgresql (#4719) @dependabot
  • Bump annotations from 22.0.0 to 23.0.0 in /modules/selenium (#4718) @dependabot
  • Bump annotations from 22.0.0 to 23.0.0 in /modules/spock (#4723) @dependabot
  • Bump assertj-core from 3.12.0 to 3.22.0 in /modules/orientdb (#4897) @dependabot
  • Bump assertj-core from 3.12.2 to 3.22.0 in /modules/rabbitmq (#4898) @dependabot
  • Bump assertj-core from 3.14.0 to 3.22.0 in /modules/r2dbc (#4900) @dependabot
  • Bump assertj-core from 3.15.0 to 3.22.0 in /modules/azure (#4870) @dependabot
  • Bump assertj-core from 3.15.0 to 3.22.0 in /modules/azure (#4870) @dependabot
  • Bump assertj-core from 3.21.0 to 3.22.0 in /core (#4874) @dependabot
  • Bump assertj-core from 3.21.0 to 3.22.0 in /examples (#4896) @dependabot
  • Bump assertj-core from 3.21.0 to 3.22.0 in /modules/database-commons (#4867) @dependabot
  • Bump assertj-core from 3.21.0 to 3.22.0 in /modules/jdbc (#4866) @dependabot
  • Bump assertj-core from 3.21.0 to 3.22.0 in /modules/junit-jupiter (#4869) @dependabot
  • Bump assertj-core from 3.21.0 to 3.22.0 in /modules/kafka (#4873) @dependabot
  • Bump assertj-core from 3.21.0 to 3.22.0 in /modules/neo4j (#4876) @dependabot
  • Bump assertj-core from 3.21.0 to 3.22.0 in /modules/pulsar (#4893) @dependabot
  • Bump assertj-core from 3.21.0 to 3.22.0 in /modules/pulsar (#4893) @dependabot
  • Bump assertj-core from 3.21.0 to 3.22.0 in /modules/vault (#4878) @dependabot
  • Bump auto-service from 1.0 to 1.0.1 in /modules/mariadb (#4720) @dependabot
  • Bump auto-service from 1.0 to 1.0.1 in /modules/mssqlserver (#4728) @dependabot
  • Bump auto-service from 1.0 to 1.0.1 in /modules/mysql (#4730) @dependabot
  • Bump auto-service from 1.0 to 1.0.1 in /modules/postgresql (#4740) @dependabot
  • Bump auto-service from 1.0-rc6 to 1.0.1 in /modules/r2dbc (#4909) @dependabot
  • Bump awaitility from 4.1.0 to 4.1.1 in /core (#4640) @dependabot
  • Bump awaitility from 4.1.0 to 4.1.1 in /modules/couchbase (#4622) @dependabot
  • Bump awaitility from 4.1.0 to 4.1.1 in /modules/couchbase (#4622) @dependabot
  • Bump aws-java-sdk-dynamodb from 1.12.100 to 1.12.122 in /modules/dynalite (#4734) @dependabot
  • Bump aws-java-sdk-dynamodb from 1.12.122 to 1.12.131 in /modules/dynalite (#4820) @dependabot
  • Bump aws-java-sdk-dynamodb from 1.12.131 to 1.12.137 in /modules/dynalite (#4871) @dependabot
  • Bump aws-java-sdk-dynamodb from 1.12.60 to 1.12.100 in /modules/dynalite (#4621) @dependabot
  • Bump aws-java-sdk-logs from 1.12.119 to 1.12.122 in /modules/localstack (#4750) @dependabot
  • Bump aws-java-sdk-logs from 1.12.122 to 1.12.132 in /modules/localstack (#4849) @dependabot
  • Bump aws-java-sdk-logs from 1.12.132 to 1.12.139 in /modules/localstack (#4919) @dependabot
  • Bump aws-java-sdk-logs from 1.12.132 to 1.12.139 in /modules/localstack (#4919) @dependabot
  • Bump aws-java-sdk-logs from 1.12.60 to 1.12.100 in /modules/localstack (#4641) @dependabot
  • Bump aws-java-sdk-logs from 1.12.60 to 1.12.119 in /modules/localstack (#4710) @dependabot
  • Bump aws-java-sdk-s3 from 1.12.100 to 1.12.122 in /modules/localstack (#4746) @dependabot
  • Bump aws-java-sdk-s3 from 1.12.122 to 1.12.131 in /modules/localstack (#4827) @dependabot
  • Bump aws-java-sdk-s3 from 1.12.131 to 1.12.137 in /modules/localstack (#4904) @dependabot
  • Bump aws-java-sdk-s3 from 1.12.80 to 1.12.100 in /modules/localstack (#4618) @dependabot
  • Bump aws-java-sdk-sqs from 1.12.100 to 1.12.122 in /modules/localstack (#4735) @dependabot
  • Bump aws-java-sdk-sqs from 1.12.100 to 1.12.124 in /modules/localstack (#4766) @dependabot
  • Bump aws-java-sdk-sqs from 1.12.124 to 1.12.131 in /modules/localstack (#4825) @dependabot
  • Bump aws-java-sdk-sqs from 1.12.131 to 1.12.137 in /modules/localstack (#4895) @dependabot
  • Bump aws-java-sdk-sqs from 1.12.131 to 1.12.139 in /modules/localstack (#4920) @dependabot
  • Bump aws-java-sdk-sqs from 1.12.82 to 1.12.100 in /modules/localstack (#4633) @dependabot
  • Bump azure-cosmos from 4.16.0 to 4.24.0 in /modules/azure (#4877) @dependabot
  • Bump clickhouse-jdbc from 0.3.1-patch to 0.3.2 in /modules/clickhouse (#4813) @dependabot
  • Bump com.gradle.enterprise.gradle.plugin from 3.7.2 to 3.8 in /examples (#4836) @dependabot
  • Bump cucumber-java from 6.11.0 to 7.1.0 in /examples (#4709) @dependabot
  • Bump cucumber-java from 7.1.0 to 7.2.2 in /examples (#4907) @dependabot
  • Bump cucumber-java from 7.1.0 to 7.2.2 in /examples (#4907) @dependabot
  • Bump cucumber-junit from 6.11.0 to 7.0.0 in /examples (#4650) @dependabot
  • Bump cucumber-junit from 7.0.0 to 7.1.0 in /examples (#4748) @dependabot
  • Bump cucumber-junit from 7.1.0 to 7.2.2 in /examples (#4911) @dependabot
  • Bump elasticsearch-rest-client from 7.15.0 to 7.15.1 in /modules/elasticsearch (#4625) @dependabot
  • Bump elasticsearch-rest-client from 7.15.0 to 7.15.2 in /modules/elasticsearch (#4707) @dependabot
  • Bump elasticsearch-rest-client from 7.15.2 to 7.16.2 in /modules/elasticsearch (#4823) @...
Read more

1.16.2

22 Oct 15:29
436fde8

Choose a tag to compare

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

🐛 Bug Fixes

📖 Documentation

🧹 Housekeeping

1.16.1

18 Oct 11:16
81317a6

Choose a tag to compare

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

🧹 Housekeeping

📦 Dependency updates

Click to expand...
  • Bump aws-java-sdk-sqs from 1.12.62 to 1.12.82 in /modules/localstack (#4558) @dependabot
  • Bump aws-java-sdk-logs from 1.12.60 to 1.12.82 in /modules/localstack (#4557) @dependabot
  • Bump actions/setup-java from 2.3.0 to 2.3.1 (#4536) @dependabot
  • Bump junit-jupiter-api from 5.7.2 to 5.8.1 in /modules/junit-jupiter (#4530) @dependabot
  • Bump postgresql from 42.2.23 to 42.2.24 in /examples (#4528) @dependabot
  • Bump elasticsearch-rest-client from 7.14.1 to 7.15.0 in /modules/elasticsearch (#4520) @dependabot
  • Bump solr-solrj from 8.9.0 to 8.10.0 in /examples (#4519) @dependabot
  • Bump assertj-core from 3.20.2 to 3.21.0 in /examples (#4506) @dependabot
  • Bump org.jetbrains.kotlin.jvm from 1.5.30 to 1.5.31 in /examples (#4508) @dependabot
  • Bump assertj-core from 3.20.2 to 3.21.0 in /modules/vault (#4510) @dependabot
  • Bump assertj-core from 3.20.2 to 3.21.0 in /modules/database-commons (#4501) @dependabot
  • Bump assertj-core from 3.20.2 to 3.21.0 in /modules/kafka (#4502) @dependabot
  • Bump r2dbc-mssql from 0.8.6.RELEASE to 0.8.7.RELEASE in /modules/mssqlserver (#4497) @dependabot
  • Bump junit-jupiter-params from 5.7.2 to 5.8.1 in /modules/junit-jupiter (#4500) @dependabot
  • Bump s3 from 2.17.34 to 2.17.52 in /modules/localstack (#4547) @dependabot
  • Bump aws-java-sdk-logs from 1.12.60 to 1.12.80 in /modules/localstack (#4543) @dependabot
  • Bump aws-java-sdk-s3 from 1.12.62 to 1.12.80 in /modules/localstack (#4541) @dependabot
  • Bump aws-java-sdk-sqs from 1.12.62 to 1.12.80 in /modules/localstack (#4540) @dependabot
  • Bump kafka-clients from 2.8.0 to 3.0.0 in /examples (#4535) @dependabot
  • Bump okhttp from 4.9.1 to 4.9.2 in /examples (#4534) @dependabot
  • Bump logback-classic from 1.2.5 to 1.2.6 in /examples (#4533) @dependabot
  • Bump org.springframework.boot from 2.5.4 to 2.5.5 in /examples (#4532) @dependabot
  • Bump postgresql from 42.2.23 to 42.2.24 in /modules/junit-jupiter (#4531) @dependabot
  • Bump postgresql from 42.2.23 to 42.2.24 in /examples (#4528) @dependabot
  • Bump org.jetbrains.kotlin.plugin.spring from 1.5.30 to 1.5.31 in /examples (#4526) @dependabot
  • Bump postgresql from 42.2.23 to 42.2.24 in /modules/spock (#4523) @dependabot
  • Bump assertj-core from 3.20.2 to 3.21.0 in /modules/pulsar (#4522) @dependabot
  • Bump assertj-core from 3.20.2 to 3.21.0 in /modules/junit-jupiter (#4521) @dependabot
  • Bump transport from 7.14.1 to 7.15.0 in /modules/elasticsearch (#4516) @dependabot
  • Bump elasticsearch-rest-client from 7.14.1 to 7.15.0 in /modules/elasticsearch (#4520) @dependabot
  • Bump guava from 30.1.1-jre to 31.0.1-jre in /modules/jdbc-test (#4518) @dependabot
  • Bump kafka-clients from 2.8.0 to 3.0.0 in /modules/kafka (#4515) @dependabot
  • Bump r2dbc-mariadb from 1.0.2 to 1.0.3 in /modules/mariadb (#4505) @dependabot
  • Bump org.jetbrains.kotlin.jvm from 1.5.30 to 1.5.31 in /examples (#4508) @dependabot
  • Bump junit-jupiter-engine from 5.7.2 to 5.8.1 in /modules/junit-jupiter (#4513) @dependabot
  • Bump postgresql from 42.2.23 to 42.2.24 in /modules/postgresql (#4509) @dependabot
  • Bump assertj-core from 3.20.2 to 3.21.0 in /modules/neo4j (#4512) @dependabot
  • Bump assertj-core from 3.20.2 to 3.21.0 in /examples (#4506) @dependabot
  • Bump influxdb-java from 2.21 to 2.22 in /modules/influxdb (#4503) @dependabot
  • Bump tomcat-jdbc from 10.0.10 to 10.0.12 in /modules/jdbc (#4498) @dependabot
  • Bump junit-jupiter-params from 5.7.2 to 5.8.1 in /modules/junit-jupiter (#4500) @dependabot
  • Bump annotations from 21.0.1 to 22.0.0 in /modules/oracle-xe (#4495) @dependabot
  • Bump assertj-core from 3.20.2 to 3.21.0 in /core (#4496) @dependabot
  • Bump assertj-core from 3.20.2 to 3.21.0 in /modules/jdbc (#4499) @dependabot
  • Bump tomcat-jdbc...
Read more

1.16.0

20 Jul 13:40
3b3d130

Choose a tag to compare

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

🧹 Housekeeping

📦 Dependency updates

Click to expand...
  • Bump aws-java-sdk-sqs from 1.11.1018 to 1.12.1 in /modules/localstack (#4181) @dependabot
  • Bump annotations from 20.1.0 to 21.0.1 in /modules/selenium (#4150) @dependabot
  • Bump annotations from 20.1.0 to 21.0.1 in /modules/nginx (#4146) @dependabot
  • Bump annotations from 20.1.0 to 21.0.1 in /modules/jdbc (#4145) @dependabot
  • Bump annotations from 20.1.0 to 21.0.1 in /modules/postgresql (#4140) @dependabot
  • Bump org.jetbrains.kotlin.jvm from 1.4.32 to 1.5.10 in /examples (#4139) @dependabot
  • Bump mysql-connector-java from 8.0.22 to 8.0.25 in /modules/junit-jupiter (#4087) @dependabot
  • Bump HikariCP from 3.4.5 to 4.0.3 in /modules/junit-jupiter (#3854) @dependabot
  • Bump actions/setup-java from 1 to 2.1.0 (#4163) @dependabot
  • Bump elasticsearch-rest-client from 7.12.1 to 7.13.0 in /modules/elasticsearch (#4157) @dependabot
  • Bump kafka-clients from 2.6.0 to 2.8.0 in /modules/kafka (#4017) @dependabot
  • Bump r2dbc-mariadb from 1.0.0 to 1.0.1 in /modules/mariadb (#3881) @dependabot
  • Bump okhttp from 4.9.0 to 4.9.1 in /examples (#3743) @dependabot
  • Bump aws-java-sdk-s3 from 1.11.930 to 1.11.1030 in /modules/localstack (#4159) @dependabot
  • Bump testng from 7.3.0 to 7.4.0 in /examples (#4116) @dependabot
  • Bump assertj-core from 3.16.1 to 3.19.0 in /modules/jdbc (#4144) @dependabot
  • Bump annota...
Read more

1.15.3

15 Apr 05:55
dabc99c

Choose a tag to compare

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

🧹 Housekeeping

📦 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

1.15.2

11 Feb 14:30
106463b

Choose a tag to compare

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

🐛 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

🧹 Housekeeping

📦 Dependency updates

1.15.1

11 Dec 14:26
4fc04b6

Choose a tag to compare

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

🐛 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

🧹 Housekeeping

📦 Dependency updates