Skip to content

Releases: testcontainers/testcontainers-java

1.19.2

15 Nov 02:02
@github-actions github-actions
1.19.2
6d33055
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
1.19.2

Testcontainers for Java 1.19.2

Core

Modules

Elasticserach

JDBC

K3S

Kafka

LocalStack

YugabyteDB

What's Changed

📖 Documentation

📦 Dependency updates

12 changes

Contributors

tgeens, fokion, and 8 other contributors
Assets 2
Loading

1.19.1

02 Oct 16:52
@github-actions github-actions
1.19.1
dd1427e
This commit was signed with the committer’s verified signature.
eddumelendez Eddú Meléndez Gonzales
SSH Key Fingerprint: 2gq90gS5ANw25iD9sCQjrJyMU7pPxCZntbob9YuAeE4 Learn about vigilant mode.
Compare
Choose a tag to compare
1.19.1

Testcontainers for Java 1.19.1

Core

Modules

Redpanda

  • Additional listener should inherit the configured authentication method (#7594) @lburgazzoli

What's Changed

☠️ Deprecations

📖 Documentation

📦 Dependency updates

7 changes

Contributors

frozenwizard, eddumelendez, and 5 other contributors
Assets 2
Loading

1.19.0

21 Aug 17:49
@eddumelendez eddumelendez
1.19.0
15dcb62
This commit was signed with the committer’s verified signature.
eddumelendez Eddú Meléndez Gonzales
SSH Key Fingerprint: 2gq90gS5ANw25iD9sCQjrJyMU7pPxCZntbob9YuAeE4 Learn about vigilant mode.
Compare
Choose a tag to compare
1.19.0

Testcontainers for Java 1.19.0

Core

Modules

ClickHouse

Elasticsearch

DB2

GCloud

JUnit Jupiter

  • Fix call to stop containers when using @Testcontainers(parallel = true) (#7394) @eddumelendez

Kafka

See https://java.testcontainers.org/modules/kafka/

MS SQL Server

QuestDB

Redpanda

  • Add Redpanda improvements (#7320) @eddumelendez
    • Allow to enable authorization and authentication methods
    • Allow to add additional listeners. E.g. using it with toxiproxy or redpanda console
    • Enable rest proxy
    • Configure rpk

See https://java.testcontainers.org/modules/redpanda/

Solace

Spock

What's Changed

☠️ Deprecations

📖 Documentation

🧹 Housekeeping

📦 Dependency updates

14 changes

Contributors

lhotari, megglos, and 9 other contributors
Assets 2
Loading

1.18.3

31 May 16:25
@github-actions github-actions
1.18.3
b0902a9
This commit was signed with the committer’s verified signature.
eddumelendez Eddú Meléndez Gonzales
SSH Key Fingerprint: 2gq90gS5ANw25iD9sCQjrJyMU7pPxCZntbob9YuAeE4 Learn about vigilant mode.
Compare
Choose a tag to compare
1.18.3

Testcontainers for Java 1.18.2 introduced new strategies to detect the docker.sock. There was an issue reported, see #7082. It's is highly recommended to use version 1.18.3.

What's Changed

🧹 Housekeeping

  • Demote "testcontainers.properties not found" message to debug log level (#7035) @perlun

Contributors

perlun and eddumelendez
Assets 2
Loading

1.18.2

30 May 11:07
@github-actions github-actions
1.18.2
ca5824a
This commit was signed with the committer’s verified signature.
eddumelendez Eddú Meléndez Gonzales
SSH Key Fingerprint: 2gq90gS5ANw25iD9sCQjrJyMU7pPxCZntbob9YuAeE4 Learn about vigilant mode.
Compare
Choose a tag to compare
1.18.2

Highlights ✨

🐛 Bug Fixes

🚀 Features & Enhancements

  • Add TestcontainersHostPropertyClientStrategy (#7053) @eddumelendez
  • DockerComposeContainer: add 'removeVolumes' parameter (#7009) @DanWiseProgramming

📖 Documentation

🧹 Housekeeping

Contributors

eddumelendez, bowenliang123, and 3 other contributors
Assets 2
Loading

1.18.1

11 May 04:28
@github-actions github-actions
1.18.1
c64aab9
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
1.18.1

What's Changed

🚀 Features & Enhancements

🐛 Bug Fixes

📖 Documentation

🧹 Housekeeping

📦 Dependency updates

Contributors

shelajev, danielpetisme, and 6 other contributors
Assets 2
Loading

1.18.0

04 Apr 06:16
@github-actions github-actions
1.18.0
a2ac6fd
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
1.18.0

Core module

  • Modules images such as MySQLContainer are now automatically compatible with their corresponding images with the library prefix
MySQLContainer<?> mysql = new MySQLContainer<>("library/mysql");
  • testcontainers/vnc has been bumped to version 1.3.0, which brings ARM support.
  • Goodbye to the whale in the logs. In order to provide an easy way to filter container logs the tc prefix has been added to display all container logs or tc.<image-name:tag> for a specific one. Check the logging docs.
  • There is a new WaitStrategy, ShellStrategy. It can also be used by calling Wait.forSuccessfulCommand(<command>)

New integration

Jib has been integrated to Testcontainers in order to take advantage of the nice API it provides to create containers

GenericContainer<?> busybox = new GenericContainer<>(
                new JibImage(
                    "busybox:1.35",
                    jibContainerBuilder -> {
                        return jibContainerBuilder.setEntrypoint("echo", "Hello World");
                    }
                )
            )
                .withStartupCheckStrategy(new OneShotStartupCheckStrategy().withTimeout(Duration.ofSeconds(3)))

New modules 🆕

CrateDB module

In order to use CrateDBContainer , declare the dependency in your pom.xml/build.gradle

<dependency>
    <groupId>org.testcontainers</groupId>
    <artifactId>cratedb</artifactId>
    <version>1.18.0</version>
    <scope>test</scope>
</dependency>
testImplementation "org.testcontainers:cratedb:1.18.0"

Choose a crate image version and use it as declared below with your postgres driver

CrateDBContainer cratedb = new CrateDBContainer("crate:5.2.5");

Solace Module

In order to use SolaceContainer , declare the dependency in your pom.xml/build.gradle

<dependency>
    <groupId>org.testcontainers</groupId>
    <artifactId>solace</artifactId>
    <version>1.18.0</version>
    <scope>test</scope>
</dependency>
testImplementation "org.testcontainers:solace:1.18.0"

Now, you can use a Solace PubSub running in a container and connecting via AMQP by doing the following:

SolaceContainer solace = new SolaceContainer("solace/solace-pubsub-standard:10.2");
solace.start();
Session session = createSession(
                solaceContainer.getUsername(),
                solaceContainer.getPassword(),
                solaceContainer.getOrigin(Service.AMQP)
            );

More information about SolaceContainer can be found in the documentation.

Container modules

CockroachDB

Starting with cockroachdb/cockroach:22.1.0, there is support for setting the username, password and database name via environment variables. Now, the Testcontainers module provides convenient setters:

CockroachContainer cockroach = new CockroachContainer("cockroachdb/cockroach:22.1.0")
    .withUsername("test_user")
    .withPassword("test_password")
    .withDatabaseName("test_database");

GCloud module

Google has released a new image which supports ARM and therefore BigtableEmulatorContainer, DatastoreEmulatorContainer, FirestoreEmulatorContainer, PubSubEmulatorContainer now support it as well.

So, if previously you were doing something like

DockerImageName.parse("gcr.io/google.com/cloudsdktool/google-cloud-cli:380.0.0-emulators")
    .asCompatibleSubstituteFor("gcr.io/google.com/cloudsdktool/cloud-sdk");

Now, you can simply do

DockerImageName.parse("gcr.io/google.com/cloudsdktool/google-cloud-cli:380.0.0-emulators");

JUnit Jupiter Module

@Testcontainers offers a new attribute parallel, which start those containers classes annotated by @Container

@Testcontainers(parallel = true)
class ParallelTest {

	@Container
private static final PostgreSQLContainer<?> postgres = new PostgreSQLContainer<>("postgres:15-alpine")
    .withCopyFileToContainer(MountableFile.forClasspathResource("db.sql"), "/docker-entrypoint-initdb.d/")
    .withNetwork(network)
    .withNetworkAliases("postgres");

@Container
private static final ToxiproxyContainer toxiproxy = new ToxiproxyContainer("ghcr.io/shopify/toxiproxy:2.5.0")
    .withNetwork(network);

}

Kafka Module

Self-managed or Kraft mode (a.k.a Zookeeperless) support has been added

KafkaContainer kafka = new KafkaContainer(DockerImageName.parse("confluentinc/cp-kafka:7.0.1")).withKraft()

LocalStack Module

SERVICES environment variable became optional in version 0.13.0 and instead LocalStack will initialize a service once the first request is served. So, nowadays LocalStackContainer can be used just like this:

LocalStackContainer localstack = new LocalStackContainer("localstack/localstack:2.0.0");

Also, LocalStack module supports version 2.0. It is highly recommended to use the latest version of LocalStack images.
Last but not least, dependency on AWS SDK V1 was dropped. So, that means by upgrading to version 1.18.0, the dependency can be removed if not used directly.

MongoDB Module

MongoDBContainer by default has been enabling ReplicaSet mode. Starting in this version, sharding has been added.

MongoDBContainer mongodb = new MongoDBContainer("mongo:6")
    .withSharding();

Selenium Module

Selenium 4 has built-in support for Microsoft Edge (which is based on Chromium) and now it is supported by BrowserWebDriverContainer as well:

BrowserWebDriverContainer<?> edge = new BrowserWebDriverContainer<>("selenium/standalone-edge:4.8.0")
    .withCapabilities(new EdgeOptions());

More

⚠️ Breaking API changes

  • Removed deprecated methods and undeclared transitive dependency to AWS SDK v1 (#5827) @AB-xdev
  • Move junit-jupiter-api's dependency configuration to implementation (#5985) @edysli

🚀 Features & Enhancements

  • Improve startup wait checks (#6384) @deejgregor
  • #6667: reset network creation state if network creation fails. (#6668) @k-wall
  • [Feature]: ShellStrategy, a new WaitStrategy (#6672) @m4rii0
  • feat: also check DOCKER_AUTH_CONFIG for registry auth config as an alternative to config.json (#6238) @roseo1
  • Ensure readability of MySQL and MariaDB config override (#6625) @famod
  • Bugfix: Log consumers are now called with exactly one complete log line (#5854) @SgtSilvio
  • ClickHouse uses new driver if it is available and version is compatible (#6236) @trolley813
  • Add devcontainer file (#6412) @eddumelendez
  • Add Docker image name to ContainerLaunchException message (#6408) @Donnerbart
  • Make sure we don't hide exceptions from waitUntilContainerStarted (#6167) @deejgregor
  • feat: enable reuse for mongodb (#6235) @tiboun
  • Avoid Pattern recompilation in log output processing (#6239) @dreis2211
  • Fixes the issue of missing root cause in container launch TimeoutException (e.g. SSLHandshakeException) (#5778) @cdanger

☠️ Deprecations

🐛 Bug Fixes

  • Short-circuit CompletableFuture returned by Startables#deepStart on exception (#5930) @pivovarit
  • fix: Don't return JSON auth config for partial registry name match (#6323) @kiview
  • Fix allowInsecure() on HttpWaitStrategy for non-localhost Docker daemon (#6314) @kiview

Contributors

edysli, cdanger, and 14 other contributors
Assets 2
Loading

1.17.6

16 Nov 12:58
@github-actions github-actions
1.17.6
4a2ca13
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
1.17.6

What's Changed

Highlights

This release has been made possible through the efforts of 20 contributors. The Testcontainers does not cease to amaze us, thanks to everyone of you and thanks for the ongoing support and collaboration 🥰.

This release brings a lot of database love with 2 new modules, and as always a couple of bug fixes and improvements

New Module: QuestDB (#5995) @Vangreen

QuestDB, is a high-performance, open-source SQL database for applications in financial services, IoT, machine learning, DevOps and observability.

var container = new QuestDBContainer("questdb/questdb:6.5.3")
container.start()
var connectionUrl = container.getHttpUrl()
// use the connectionUrl and start testing!

New Module: YugabyteDB (#4372) @srinivasa-vasu

YugabyteDB, is a modern distributed SQL database for transactional cloud native applications. PostgreSQL compatible. It offers two APIs, SQL and CQL.

var container = new YugabyteDBYSQLContainer("yugabytedb/yugabyte:2.14.4.0-b26");
container.start()
var jdbcUrl = container.getJdbcUrl();
// use the jdbcUrl and start testing!
var container = new YugabyteDBYCQLContainer("yugabytedb/yugabyte:2.14.4.0-b26");
container.start()
var contactPoint = container.getContactPoint();
// use the contactPoint and start testing!

🚀 Features & Enhancements

🐛 Bug Fixes

  • Fixes wrong timestamp calculation (#5988) @leblonk
  • Catch and ignore more errors when reflecting into container subclass (#5990) @akhaku
  • Return default for empty environment variable (#5983) @roulpriya

📖 Documentation

🧹 Housekeeping

📦 Dependency updates

9 changes * Ignore updates for org.neo4j:neo4j (#6112) @eddumelendez * Combined dependencies PR (#6210) @eddumelendez * Combined dependencies PR (#6205) @eddumelendez * Combined dependencies PR (#6173) @eddumelendez * Combined dependencies PR (#6153) @eddumelendez * Combined dependencies PR (#6150) @eddumelendez

Contributors

akhaku, edysli, and 17 other contributors
Assets 2
Loading

1.17.5

04 Oct 14:51
@github-actions github-actions
1.17.5
abf87ab
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
1.17.5

What's Changed

Warning
Version 1.17.4 was released upgrading slf4j-api to version 2.x. This dependency has been reverted to 1.17.x.

📖 Documentation

📦 Dependency updates

Contributors

eddumelendez, hariohmprasath, and kiview
Assets 2
Loading

1.17.4

29 Sep 15:12
@github-actions github-actions
1.17.4
2215e21
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
1.17.4

What's Changed

Highlights

This release has been made possible through the efforts of whopping 23 contributors, wow! 🤯

Besides 3 new modules, this release brings a couple of bugfixes, improved compatibility and resilience in certain scenarios, better defaults and more configurability.

You might also notice many PRs related to the documentation, templates for PRs and issues, and automation regarding OSS contributions. Testcontainers has always been a project with a lot of involvement by the community and we are very proud of this. That’s why want to make contributing to Testcontainers a great experience, no matter if you raise an issue, submit a PR or initiate a discussion in GitHhub Discussions.

🐼 New Module: Redpanda (#5740) @eddumelendez

Redpanda, a Kafka-compatible streaming platform, recently added a special dev-container mode to their container image, that allows even faster startup times. A great reason to work in a Testcontainers module that leverages this flag by default to give you a great integration testing experience when using Redpanda. And of course, using Redpanda with Testcontainers is as easy and convenient as you are used to:

var container = new RedpandaContainer("docker.redpanda.com/vectorized/redpanda:v22.2.1")
container.start()
var connectionUrl = container.getBootstrapServers()
// use the connectionUrl and start testing!

You can check out the docs to learn more.

New Module: TiDB (#5511) @Icemap

With TiDB, we are adding support for a new database module. As with other databases that can be accessed via JDBC, you can leverage Testcontainers’ special JDBC URL integration:

jdbc:tc:tidb:v6.1.0:///databasename

New Module: Hashicorp Consul (#4683) @julb

Consul

🚀 Features & Enhancements

  • getContainerByServiceName should work without suffix (#5776) @REslim30
  • Allow Pulsar default WaitStrategy to honour startup timeout (#5674) @nahguam
  • fix: ContainerDatabaseDriver does not register Properties object (#5829) @REslim30
  • couchbase: allow to configure bucket replicas and default to 0. (#5840) @daschl
  • Add compatibility with MongoDB 6 (#5771) @eddumelendez
  • Set default elasticsearch heap size to 2GB (Alternate PR) (#5684) @REslim30
  • Add Transferable.of(String, int) (#5741) @eddumelendez
  • Make TestcontainersExtension public (#5285) @hmatt1
  • Update Cassandra driver to 4.x (#2830) @emerkle826
  • Make outer maximum startup timeout in DockerComposeContainer configurable (#5588) @henri-tremblay
  • Improve Pulsar's wait strategy to rely on clusterName (#5613) @eddumelendez

🐛 Bug Fixes

  • getLivenessCheckPortNumbers() should return mapped port (#5734) @REslim30

📖 Documentation

🧹 Housekeeping

📦 Dependency updates

Contributors

daschl, naveensrinivasan, and 20 other contributors
Assets 2
Loading