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 (testcontainers#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