Maintainers' note

We want to inform you about an issue that occurred with the release, v0.20.0. Due to an unintended error, the git tags associated with v0.20.0 were created in an inconsistent state. As a result, the tags were removed and recreated to accurately reflect the intended release state. This situation could have affected users relying on the Go proxy cache during the short time window between the initial release and the tag correction.

To address this issue, we have now created the patch release v0.20.1, which is based on the correct state of the project and provides a seamless transition from v0.20.0.

To ensure that you have the latest updates, we recommend updating your dependencies to use v0.20.1 instead of v0.20.0 to ensure you have the correct and stable version.

We apologise for any inconvenience this may have caused and appreciate your understanding. If you have any questions or encounter any issues, please don't hesitate to reach out to us.

Thank you for your continued support!

What's Changed

⚠️ Breaking Changes

The signature of the testcontainers.NewDockerClient has changed in order to provide a simpler API for the future changes, and for that reason we were forced to break it and simplify its signature, returning the client and an error, instead of an instance of the Testcontainers properties and the host. At the same time, the TestContainersConfig struct representing the configuration properties has been renamed to TestcontainersConfig, which is brings consistency with the name of the project.

• break: disable reaper at config level (#941) @mdelapenya

🚀 Features

• feat: Add Redpanda module (#1058) @weeco
• feat: Add ability to disable internal checks for wait.HostPortStrategy (#1039) @RiverPhillips
• feat: use an interface for container customization in modules (#1042) @mdelapenya
• Add support for LocalStack v2 (#994) @eddumelendez
• feat: provide container lifecycle hooks (#1036) @mdelapenya
• feat: support for wait.ForExec with response matcher (#1035) @mdelapenya
• feat: building blocks for Go modules (#1016) @mdelapenya
• feat: add Redis module (#993) @mdelapenya
• feat: Auto detect the use of Podman from DOCKER_HOST (#982) @jtwatson
• feat: add Neo4j module (#937) @fbiville
• Add MySQL module (#943) @eddumelendez
• feat: add Vault Module (#942) @alihanyalcin
• feat: add Postgres module (#945) @mdelapenya
• feat: add status check to wait strategies (#944) @frozenbonito
• add couchbase module (#876) @alihanyalcin

🐛 Bug Fixes

• fix: don't panic when logs waits for more than 5 seconds (#947) @martin-sucha
• fix: generated code must compile (#1059) @mdelapenya
• fix: proper lifecycle for following logs using consumers (#366) @slsyy

📖 Documentation

• docs: include the testcontainers-go version in which a module was added (#1081) @mdelapenya
• docs: use consistent format in Neo4j docs (#1057) @mdelapenya
• docs: document tc_host inside the networking section (#1041) @sgloutnikov
• docs: add permalink to mkdocs headings (#1032) @mdelapenya
• docs: fix technology name (#990) @mdelapenya
• Reorder docs language links (#985) @leocross
• docs: simplify MySQL code snippet in docs (#984) @mdelapenya
• docs: extend Couchbase docs (#971) @mdelapenya
• fix: update code snippet for Docker Auth (#940) @mdelapenya

🧹 Housekeeping

• Revert "chore: run pipelines in order (#1130)" (#1157) @mdelapenya
• chore: run pipelines in order (#1130) @mdelapenya
• fix: escape slashes (#1084) @mdelapenya
• chore: support for multiple lifecycles defined by the user (#1037) @mdelapenya
• Add support for Neo4j configuration (#992) @fbiville
• Revert "chore: render logos from the base location (#995)" (#998) @mdelapenya
• chore: skip CI builds when updating the docs (#996) @mdelapenya
• chore: render logos from the base location (#995) @mdelapenya
• chore: include how to install the module in the generated docs (#991) @mdelapenya
• chore: use testdata as a Go idiom (#983) @mdelapenya
• chore: do not force SSL disabled in the connection string (#981) @mdelapenya
• Use hashicorp/consul in examples (#950) @eddumelendez
• chore: always close Docker client (#939) @mdelapenya
• fix: move to the right dir to git commit when releasing (#931) @mdelapenya

📦 Dependency updates

• chore(deps): bump dependencies in /modules/localstack (#1158) @mdelapenya
• chore(deps): bump golang.org/x/sys from 0.6.0 to 0.7.0 (#1088) @dependabot
• chore(deps): bump github.com/couchbase/gocb/v2 from 2.6.2 to 2.6.3 in /modules/couchbase (#1107) @dependabot
• chore(deps): bump github.com/docker/docker v23.0.5+incompatible in modules and examples (#1156) @mdelapenya
• chore(deps): bump google dependencies in /examples (#1155) @mdelapenya
• chore(deps): bump github.com/docker/docker from 23.0.3+incompatible to 23.0.5+incompatible (#1134) @dependabot
• chore(deps): bump golang.org/x/sync from 0.1.0 to 0.2.0 in /modules/compose (#1143) @dependabot
• chore(deps): bump github.com/docker/compose/v2 from 2.17.2 to 2.17.3 in /modules/compose (#1149) @dependabot
• chore(deps): bump dependencies in /modules/redpanda (#1154) @mdelapenya
• chore(deps): bump github.com/apache/pulsar-client-go from 0.9.0 to 0.10.0 in /modules/pulsar (#1105) @dependabot
• chore(deps): bump github.com/docker/{cli|docker} from 23.0.3+incompatible to 23.0.5+incompatible in /modules (#1132) @mdelapenya
• chore(deps): bump google.golang.org/api to 0.120.0 in /examples (#1131) @mdelapenya
• chore(deps): bump github.com/cenkalti/backoff/v4 from 4.2.0 to 4.2.1 in /modules/couchbase (#1099) @dependabot
• chore(deps): bump github.com/go-sql-driver/mysql from 1.7.0 to 1.7.1 in /modules/mysql (#1122) @dependabot
• chore(deps): bump github.com/lib/pq from 1.10.7 to 1.10.9 in /modules/postgres (#1127) @dependabot
• chore(deps): bump github.com/neo4j/neo4j-go-driver/v5 from 5.7.0 to 5.8.0 in /modules/neo4j (#1126) @dependabot
• chore(deps): bump golang.org/x/text from 0.8.0 to 0.9.0 in /modulegen (#1095) @dependabot
• chore(deps): bump gotest.tools/gotestsum from 1.9.0 to 1.10.0 (#1129) @mdelapenya
• chore(deps): bump aws deps in /modules/localstack (#1077) @mdelapenya
• chore(deps): bump docker libs in /modules/compose (#1076) @mdelapenya
• chore(deps): bump github.com/docker/docker from 23.0.2+incompatible to 23.0.3+incompatible in /modules (#1074) @mdelapenya
• chore(deps): bump github.com/docker/docker from 23.0.2+incompatible to 23.0.3+incompatible (#1060) @mdelapenya
• chore(deps): bump github.com/neo4j/neo4j-go-driver/v5 from 5.6.0 to 5.7.0 in /modules/neo4j (#1030) @dependabot
• chore(deps): bump github.com/docker/docker from 23.0.1+incompatible to 23.0.2+incompatible (#1026) @mdelapenya
• chore(deps): bump github.com/opencontainers/runc from 1.1.3 to 1.1.5 (#1017) @mdelapenya
• chore(deps): bump localstack dependencies in /modules/localstack (#980) @mdelapenya
• chore: update Go deps in modules (#979) @mdelapenya
• chore(deps): bump google.golang.org/grpc from 1.53.0 to 1.54.0 in /examples (#973) @mdelapenya
• chore(deps): bump compose dependencies in /modules/compose (#974) @mdelapenya
• chore(deps): bump github.com/aws/aws-sdk-go in /modules/localstack (#972) @mdelapenya
• chore(deps): bump cloud.google.com/go/pubsub from 1.28.0 to 1.30.0 in /examples/pubsub (#968) @dependabot
• chore(deps): bump go.mongodb.org/mongo-driver from 1.11.2 to 1.11.3 in /examples/mongodb (#953) @dependabot
• chore(deps): bump github.com/couchbase/gocb/v2 from 2.6.1 to 2.6.2 in /modules/couchbase (#952) @dependabot
• chore: bump Ryuk to v0.4.0 release (#936) @mdelapenya
• chore(deps): bump github.com/aws/aws-sdk-go from 1.44.211 to 1.44.217 in /modules/localstack (#934) @dependabot
• chore(deps): bump github.com/hashicorp/consul/api from 1.19.1 to 1.20.0 in /examples/consul (#933) @dependabot