[Enhancement]: Add Support for ClickHouse Cluster in Testcontainers ClickHouseContainer #11242

Module

Clickhouse

Proposal

Description

As of today, ClickHouseContainer supports only a single ClickHouse server instance.
Most real-world use cases require running tests against a cluster setup (distributed tables, replication, sharding, and more).

Requested Enhancements

• A new ClickHouseClusterContainer (or similar abstraction) able to:

  • Start N nodes sharing the same cluster configuration.

  • Provide connection URLs for each node and/or a load-balanced endpoint.

  • Handle internal network setup for inter-node communication.

  • Optionally support Zookeeper-less clusters (newer versions support this).

• Maintain backward compatibility with the existing ClickHouseContainer.