-
-
Notifications
You must be signed in to change notification settings - Fork 1.7k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
* Deprecate `org.testcontainers.containers.KafkaContainer` * Add `org.testcontainers.kafka.ConfluentKafkaContainer` which works with `confluentinc/cp-kafka` images with version `7.4.0` or later. * `KafkaHelper` container common env vars, command, wait strategy to be shared with `org.testcontainers.kafka.KafkaContainer` --------- Co-authored-by: Kevin Wittek <[email protected]>
- Loading branch information
1 parent
c1f4796
commit ba22a7b
Showing
6 changed files
with
360 additions
and
9 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
142 changes: 142 additions & 0 deletions
142
modules/kafka/src/main/java/org/testcontainers/kafka/ConfluentKafkaContainer.java
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,142 @@ | ||
package org.testcontainers.kafka; | ||
|
||
import com.github.dockerjava.api.command.InspectContainerResponse; | ||
import org.testcontainers.containers.GenericContainer; | ||
import org.testcontainers.images.builder.Transferable; | ||
import org.testcontainers.utility.DockerImageName; | ||
|
||
import java.util.ArrayList; | ||
import java.util.HashSet; | ||
import java.util.List; | ||
import java.util.Set; | ||
import java.util.function.Supplier; | ||
|
||
/** | ||
* Testcontainers implementation for Confluent Kafka. | ||
* <p> | ||
* Supported image: {@code confluentinc/cp-kafka} | ||
* <p> | ||
* Exposed ports: 9092 | ||
*/ | ||
public class ConfluentKafkaContainer extends GenericContainer<ConfluentKafkaContainer> { | ||
|
||
private static final DockerImageName DEFAULT_IMAGE_NAME = DockerImageName.parse("confluentinc/cp-kafka"); | ||
|
||
private final Set<String> listeners = new HashSet<>(); | ||
|
||
private final Set<Supplier<String>> advertisedListeners = new HashSet<>(); | ||
|
||
public ConfluentKafkaContainer(String imageName) { | ||
this(DockerImageName.parse(imageName)); | ||
} | ||
|
||
public ConfluentKafkaContainer(DockerImageName dockerImageName) { | ||
super(dockerImageName); | ||
dockerImageName.assertCompatibleWith(DEFAULT_IMAGE_NAME); | ||
|
||
withExposedPorts(KafkaHelper.KAFKA_PORT); | ||
withEnv(KafkaHelper.envVars()); | ||
|
||
withCommand(KafkaHelper.COMMAND); | ||
waitingFor(KafkaHelper.WAIT_STRATEGY); | ||
} | ||
|
||
@Override | ||
protected void configure() { | ||
KafkaHelper.resolveListeners(this, this.listeners); | ||
|
||
String firstNetworkAlias = getNetworkAliases().stream().findFirst().orElse(null); | ||
String networkAlias = getNetwork() != null ? firstNetworkAlias : "localhost"; | ||
String controllerQuorumVoters = String.format("%s@%s:9094", getEnvMap().get("KAFKA_NODE_ID"), networkAlias); | ||
withEnv("KAFKA_CONTROLLER_QUORUM_VOTERS", controllerQuorumVoters); | ||
} | ||
|
||
@Override | ||
protected void containerIsStarting(InspectContainerResponse containerInfo) { | ||
String brokerAdvertisedListener = String.format( | ||
"BROKER://%s:%s", | ||
containerInfo.getConfig().getHostName(), | ||
"9093" | ||
); | ||
List<String> advertisedListeners = new ArrayList<>(); | ||
advertisedListeners.add("PLAINTEXT://" + getBootstrapServers()); | ||
advertisedListeners.add(brokerAdvertisedListener); | ||
|
||
advertisedListeners.addAll(KafkaHelper.resolveAdvertisedListeners(this.advertisedListeners)); | ||
String kafkaAdvertisedListeners = String.join(",", advertisedListeners); | ||
|
||
String command = "#!/bin/bash\n"; | ||
// exporting KAFKA_ADVERTISED_LISTENERS with the container hostname | ||
command += String.format("export KAFKA_ADVERTISED_LISTENERS=%s\n", kafkaAdvertisedListeners); | ||
|
||
command += "/etc/confluent/docker/run \n"; | ||
copyFileToContainer(Transferable.of(command, 0777), KafkaHelper.STARTER_SCRIPT); | ||
} | ||
|
||
/** | ||
* Add a listener in the format {@code host:port}. | ||
* Host will be included as a network alias. | ||
* <p> | ||
* Use it to register additional connections to the Kafka broker within the same container network. | ||
* <p> | ||
* The listener will be added to the list of default listeners. | ||
* <p> | ||
* Default listeners: | ||
* <ul> | ||
* <li>0.0.0.0:9092</li> | ||
* <li>0.0.0.0:9093</li> | ||
* <li>0.0.0.0:9094</li> | ||
* </ul> | ||
* <p> | ||
* The listener will be added to the list of default advertised listeners. | ||
* <p> | ||
* Default advertised listeners: | ||
* <ul> | ||
* <li>{@code container.getConfig().getHostName():9092}</li> | ||
* <li>{@code container.getHost():container.getMappedPort(9093)}</li> | ||
* </ul> | ||
* @param listener a listener with format {@code host:port} | ||
* @return this {@link ConfluentKafkaContainer} instance | ||
*/ | ||
public ConfluentKafkaContainer withListener(String listener) { | ||
this.listeners.add(listener); | ||
this.advertisedListeners.add(() -> listener); | ||
return this; | ||
} | ||
|
||
/** | ||
* Add a listener in the format {@code host:port} and a {@link Supplier} for the advertised listener. | ||
* Host from listener will be included as a network alias. | ||
* <p> | ||
* Use it to register additional connections to the Kafka broker from outside the container network | ||
* <p> | ||
* The listener will be added to the list of default listeners. | ||
* <p> | ||
* Default listeners: | ||
* <ul> | ||
* <li>0.0.0.0:9092</li> | ||
* <li>0.0.0.0:9093</li> | ||
* <li>0.0.0.0:9094</li> | ||
* </ul> | ||
* <p> | ||
* The {@link Supplier} will be added to the list of default advertised listeners. | ||
* <p> | ||
* Default advertised listeners: | ||
* <ul> | ||
* <li>{@code container.getConfig().getHostName():9092}</li> | ||
* <li>{@code container.getHost():container.getMappedPort(9093)}</li> | ||
* </ul> | ||
* @param listener a supplier that will provide a listener | ||
* @param advertisedListener a supplier that will provide a listener | ||
* @return this {@link ConfluentKafkaContainer} instance | ||
*/ | ||
public ConfluentKafkaContainer withListener(String listener, Supplier<String> advertisedListener) { | ||
this.listeners.add(listener); | ||
this.advertisedListeners.add(advertisedListener); | ||
return this; | ||
} | ||
|
||
public String getBootstrapServers() { | ||
return String.format("%s:%s", getHost(), getMappedPort(KafkaHelper.KAFKA_PORT)); | ||
} | ||
} |
104 changes: 104 additions & 0 deletions
104
modules/kafka/src/main/java/org/testcontainers/kafka/KafkaHelper.java
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,104 @@ | ||
package org.testcontainers.kafka; | ||
|
||
import org.testcontainers.containers.GenericContainer; | ||
import org.testcontainers.containers.wait.strategy.Wait; | ||
import org.testcontainers.containers.wait.strategy.WaitStrategy; | ||
|
||
import java.util.ArrayList; | ||
import java.util.Arrays; | ||
import java.util.HashMap; | ||
import java.util.List; | ||
import java.util.Map; | ||
import java.util.Set; | ||
import java.util.function.Supplier; | ||
import java.util.stream.Collectors; | ||
|
||
class KafkaHelper { | ||
|
||
private static final String DEFAULT_INTERNAL_TOPIC_RF = "1"; | ||
|
||
private static final String DEFAULT_CLUSTER_ID = "4L6g3nShT-eMCtK--X86sw"; | ||
|
||
private static final String PROTOCOL_PREFIX = "TC"; | ||
|
||
static final int KAFKA_PORT = 9092; | ||
|
||
static final String STARTER_SCRIPT = "/tmp/testcontainers_start.sh"; | ||
|
||
static final String[] COMMAND = { | ||
"sh", | ||
"-c", | ||
"while [ ! -f " + STARTER_SCRIPT + " ]; do sleep 0.1; done; " + STARTER_SCRIPT, | ||
}; | ||
|
||
static final WaitStrategy WAIT_STRATEGY = Wait.forLogMessage(".*Transitioning from RECOVERY to RUNNING.*", 1); | ||
|
||
static Map<String, String> envVars() { | ||
Map<String, String> envVars = new HashMap<>(); | ||
envVars.put("CLUSTER_ID", DEFAULT_CLUSTER_ID); | ||
|
||
envVars.put( | ||
"KAFKA_LISTENERS", | ||
"PLAINTEXT://0.0.0.0:" + KAFKA_PORT + ",BROKER://0.0.0.0:9093,CONTROLLER://0.0.0.0:9094" | ||
); | ||
envVars.put( | ||
"KAFKA_LISTENER_SECURITY_PROTOCOL_MAP", | ||
"BROKER:PLAINTEXT,PLAINTEXT:PLAINTEXT,CONTROLLER:PLAINTEXT" | ||
); | ||
envVars.put("KAFKA_INTER_BROKER_LISTENER_NAME", "BROKER"); | ||
envVars.put("KAFKA_PROCESS_ROLES", "broker,controller"); | ||
envVars.put("KAFKA_CONTROLLER_LISTENER_NAMES", "CONTROLLER"); | ||
|
||
envVars.put("KAFKA_NODE_ID", "1"); | ||
envVars.put("KAFKA_OFFSETS_TOPIC_REPLICATION_FACTOR", DEFAULT_INTERNAL_TOPIC_RF); | ||
envVars.put("KAFKA_OFFSETS_TOPIC_NUM_PARTITIONS", DEFAULT_INTERNAL_TOPIC_RF); | ||
envVars.put("KAFKA_TRANSACTION_STATE_LOG_REPLICATION_FACTOR", DEFAULT_INTERNAL_TOPIC_RF); | ||
envVars.put("KAFKA_TRANSACTION_STATE_LOG_MIN_ISR", DEFAULT_INTERNAL_TOPIC_RF); | ||
envVars.put("KAFKA_LOG_FLUSH_INTERVAL_MESSAGES", Long.MAX_VALUE + ""); | ||
envVars.put("KAFKA_GROUP_INITIAL_REBALANCE_DELAY_MS", "0"); | ||
return envVars; | ||
} | ||
|
||
static void resolveListeners(GenericContainer<?> kafkaContainer, Set<String> listenersSuppliers) { | ||
Set<String> listeners = Arrays | ||
.stream(kafkaContainer.getEnvMap().get("KAFKA_LISTENERS").split(",")) | ||
.collect(Collectors.toSet()); | ||
Set<String> listenerSecurityProtocolMap = Arrays | ||
.stream(kafkaContainer.getEnvMap().get("KAFKA_LISTENER_SECURITY_PROTOCOL_MAP").split(",")) | ||
.collect(Collectors.toSet()); | ||
|
||
List<String> listenersToTransform = new ArrayList<>(listenersSuppliers); | ||
for (int i = 0; i < listenersToTransform.size(); i++) { | ||
String protocol = String.format("%s-%d", PROTOCOL_PREFIX, i); | ||
String listener = listenersToTransform.get(i); | ||
String listenerHost = listener.split(":")[0]; | ||
String listenerPort = listener.split(":")[1]; | ||
String listenerProtocol = String.format("%s://%s:%s", protocol, listenerHost, listenerPort); | ||
String protocolMap = String.format("%s:PLAINTEXT", protocol); | ||
listeners.add(listenerProtocol); | ||
listenerSecurityProtocolMap.add(protocolMap); | ||
|
||
String host = listener.split(":")[0]; | ||
kafkaContainer.withNetworkAliases(host); | ||
} | ||
|
||
String kafkaListeners = String.join(",", listeners); | ||
String kafkaListenerSecurityProtocolMap = String.join(",", listenerSecurityProtocolMap); | ||
|
||
kafkaContainer.getEnvMap().put("KAFKA_LISTENERS", kafkaListeners); | ||
kafkaContainer.getEnvMap().put("KAFKA_LISTENER_SECURITY_PROTOCOL_MAP", kafkaListenerSecurityProtocolMap); | ||
} | ||
|
||
static List<String> resolveAdvertisedListeners(Set<Supplier<String>> listenerSuppliers) { | ||
List<String> advertisedListeners = new ArrayList<>(); | ||
List<Supplier<String>> listenersToTransform = new ArrayList<>(listenerSuppliers); | ||
for (int i = 0; i < listenersToTransform.size(); i++) { | ||
Supplier<String> listenerSupplier = listenersToTransform.get(i); | ||
String protocol = String.format("%s-%d", PROTOCOL_PREFIX, i); | ||
String listener = listenerSupplier.get(); | ||
String listenerProtocol = String.format("%s://%s", protocol, listener); | ||
advertisedListeners.add(listenerProtocol); | ||
} | ||
return advertisedListeners; | ||
} | ||
} |
16 changes: 16 additions & 0 deletions
16
modules/kafka/src/test/java/org/testcontainers/KCatContainer.java
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,16 @@ | ||
package org.testcontainers; | ||
|
||
import org.testcontainers.containers.GenericContainer; | ||
import org.testcontainers.images.builder.Transferable; | ||
|
||
public class KCatContainer extends GenericContainer<KCatContainer> { | ||
|
||
public KCatContainer() { | ||
super("confluentinc/cp-kcat:7.4.1"); | ||
withCreateContainerCmdModifier(cmd -> { | ||
cmd.withEntrypoint("sh"); | ||
}); | ||
withCopyToContainer(Transferable.of("Message produced by kcat"), "/data/msgs.txt"); | ||
withCommand("-c", "tail -f /dev/null"); | ||
} | ||
} |
Oops, something went wrong.