What's Changed

This is a release candidate build for version 1.15.0, including a large number of small but noticeable changes.

At least one further release candidate build is expected before 1.15.0 final, and some API changes may still be made. We would encourage users to upgrade to this release candidate version if possible, and to give us feedback on any issues that are encountered.

Notable changes

• 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

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

☠️ Deprecations

• Deprecate ambiguous constructors (#2839) @rnorth.

🚀 Features & Enhancements

• Add a rootless Docker strategy (#2985) @bsideup
• Maintain deterministic order in withCopyFileToContainer (#2897) @findepi
• Couchbase: include error response from Couchbase in checkSuccessfulResponse() (#3006) @aaronjwhiteside
• Allow overriding detected host (#2991) @bsideup
• Use EnvAndSysPropClientProviderStrategy only if DOCKER_HOST is set (#2987) @bsideup
• Un-shade docker-java-api (#2882) @bsideup
• Method to enable functions worker in pulsar container (#2711) @lanwen
• Remove deprecated implicit network in KafkaContainer (#2932) @bsideup
• Do not resolve LazyFuture from RemoteDockerImage#toString (#2930) @bsideup
• Cache Ryuk's failure to prevent the double start (#2935) @bsideup
• Upgrade to docker-java 3.2.2, try Apache HttpClient5 (#2803) @bsideup
• Use testcontainers/* Docker Hub images (#2850) @bsideup
• Enable AWS KMS For LocalStack 0.10.8 (#2812) @SahilWadhwa
• Add acceptLicense method to MSSQLServerContainer (#2085) @KyleAure
• Update to latest LocalStack container and support unified port mode (#2825) @artamonovkirill

🐛 Bug Fixes

• Fix PrestoContainer WaitStrategy regex (#2992) @MrBuddyCasino
• Fix local Docker Compose (#2998) @bsideup
• Pin version of RabbitMQ image to 3.7.25-management-alpine (#2941) @rnorth
• Run correct subset of docker compose containers when withServices/withScaledService used (#2922) @rnorth
• Fix log-related leaks (#2883) @bsideup
• Avoid connection leaks in LogUtils (#2834) @bsideup

📖 Documentation

• Add fkorotkov to backers (#2997) @rnorth
• Convert Docs for the Junit5 (#2977) @raynigon
• Add breaking change and deprecation sections to release notes (#2978) @rnorth
• Adapt docs to non deprecated way of setting --memory and --memory-swap (#2511) @tschmidt01
• Add Windows Server 2019 as unsupported to docs (#2963) @kiview
• Add user from Apache SkyWalking (#2967) @kezhenxu94
• Add backers (#2958) @rnorth
• Convert Docs for Kafka Module #1158 (#2925) @raynigon
• Convert Docs for Webdriver Containers (#2927) @raynigon
• Add initial bounty policy documentation. (#2954) @rnorth
• Convert Docs for the Spock Testframework (#2928) @raynigon
• Use codeinclude for Elasticsearch Module (#2828) @raynigon
• Update Windows docs for WSL2 (#2816) @kiview
• Update Mysql and Postgres tests example URLs (#2832) @muzir
• Added jOOQ to the who's using section, and me to the backers section (#2996) @lukaseder

🧹 Housekeeping

• RabbitMQ: correct shouldMountConfigurationFileSysctl test so that it exercises the withRabbitMQConfigSysctl method (#2945) @JeanBaptisteWATENBERG
• Delete pom.xml in examples/singleton-container (#2937) @bsideup
• Continue on ciMate's error (#2933) @bsideup
• Pin registry image used for testing (#2926) @rnorth
• upgrade to Dependabot 2 (#2898) @sullis
• Fix compilation error related to unicode in source code (#2464) @trexinc
• Hard deprecate ProxiedUnixSocketClientProviderStrategy (#2851) @bsideup
• Migrate postgis image to the postgis/postgis docker hub repo. (#2797) @Sanych
• Switch to latest v5 release of release-drafter (#2815) @jetersen

📦 Dependency updates