Add support for ActiveMQ and Artemis (#7400)

The following implementations have been added:
* `ActiveMQContainer` supports [ActiveMQ](https://hub.docker.com/r/apache/activemq-classic)
* `ArtemisContainer` supports [Artemis](https://hub.docker.com/r/apache/activemq-artemis)

Author: eddumelendez

.github/ISSUE_TEMPLATE/bug_report.yaml

@@ -14,6 +14,7 @@ body:
       description: Which Testcontainers module are you using?
       options:
         - Core
+        - ActiveMQ
         - Azure
         - Cassandra
         - Clickhouse

.github/ISSUE_TEMPLATE/enhancement.yaml

@@ -14,6 +14,7 @@ body:
       description: For which Testcontainers module does the enhancement proposal apply?
       options:
         - Core
+        - ActiveMQ
         - Azure
         - Cassandra
         - Clickhouse

.github/ISSUE_TEMPLATE/feature.yaml

@@ -14,6 +14,7 @@ body:
       description: Is this feature related to any of the existing modules?
       options:
         - Core
+        - ActiveMQ
         - Azure
         - Cassandra
         - Clickhouse

.github/dependabot.yml

@@ -31,6 +31,11 @@ updates:
     open-pull-requests-limit: 10
 
 # Explicit entry for each module
+  - package-ecosystem: "gradle"
+    directory: "/modules/activemq"
+    schedule:
+      interval: "monthly"
+    open-pull-requests-limit: 10
   - package-ecosystem: "gradle"
     directory: "/modules/azure"
     schedule:

.github/labeler.yml

@@ -15,6 +15,10 @@
       - gradle/wrapper/*
       - gradlew
       - gradlew.bat
+"modules/activemq":
+  - changed-files:
+      - any-glob-to-any-file:
+          - modules/activemq/**/*
 "modules/azure":
   - changed-files:
     - any-glob-to-any-file:

.github/settings.yml

@@ -106,6 +106,9 @@ labels:
   - name: help wanted
     color: '#fef2c0'
 
+  - name: modules/activemq
+    color: '#006b75'
+
   - name: modules/azure
     color: '#006b75'
 

docs/modules/activemq.md

@@ -0,0 +1,57 @@
+# ActiveMQ
+
+Testcontainers module for [ActiveMQ](https://hub.docker.com/r/apache/activemq-classic) and
+[Artemis](https://hub.docker.com/r/apache/activemq-artemis).
+
+## ActiveMQContainer's usage examples
+
+You can start an ActiveMQ Classic container instance from any Java application by using:
+
+<!--codeinclude-->
+[Default ActiveMQ container](../../modules/activemq/src/test/java/org/testcontainers/activemq/ActiveMQContainerTest.java) inside_block:container
+<!--/codeinclude-->
+
+With custom credentials:
+
+<!--codeinclude-->
+[Setting custom credentials](../../modules/activemq/src/test/java/org/testcontainers/activemq/ActiveMQContainerTest.java) inside_block:settingCredentials
+<!--/codeinclude-->
+
+## ArtemisContainer's usage examples
+
+You can start an ActiveMQ Artemis container instance from any Java application by using:
+
+<!--codeinclude-->
+[Default Artemis container](../../modules/activemq/src/test/java/org/testcontainers/activemq/ArtemisContainerTest.java) inside_block:container
+<!--/codeinclude-->
+
+With custom credentials:
+
+<!--codeinclude-->
+[Setting custom credentials](../../modules/activemq/src/test/java/org/testcontainers/activemq/ArtemisContainerTest.java) inside_block:settingCredentials
+<!--/codeinclude-->
+
+With anonymous login:
+
+<!--codeinclude-->
+[Allow anonymous login](../../modules/activemq/src/test/java/org/testcontainers/activemq/ArtemisContainerTest.java) inside_block:enableAnonymousLogin
+<!--/codeinclude-->
+
+## Adding this module to your project dependencies
+
+Add the following dependency to your `pom.xml`/`build.gradle` file:
+
+=== "Gradle"
+    ```groovy
+    testImplementation "org.testcontainers:activemq:{{latest_version}}"
+    ```
+
+=== "Maven"
+    ```xml
+    <dependency>
+        <groupId>org.testcontainers</groupId>
+        <artifactId>activemq</artifactId>
+        <version>{{latest_version}}</version>
+        <scope>test</scope>
+    </dependency>
+    ```

mkdocs.yml

@@ -73,6 +73,7 @@ nav:
                 - modules/databases/tidb.md
                 - modules/databases/trino.md
                 - modules/databases/yugabytedb.md
+          - modules/activemq.md
           - modules/azure.md
           - modules/consul.md
           - modules/docker_compose.md

modules/activemq/build.gradle

@@ -0,0 +1,22 @@
+description = "Testcontainers :: ActiveMQ"
+
+dependencies {
+    api project(':testcontainers')
+
+    testImplementation 'org.assertj:assertj-core:3.24.2'
+    testImplementation "org.apache.activemq:activemq-client-jakarta:5.18.2"
+    testImplementation "org.apache.activemq:artemis-jakarta-client:2.29.0"
+}
+
+test {
+    javaLauncher = javaToolchains.launcherFor {
+        languageVersion = JavaLanguageVersion.of(11)
+    }
+}
+
+compileTestJava {
+    javaCompiler = javaToolchains.compilerFor {
+        languageVersion = JavaLanguageVersion.of(11)
+    }
+    options.release.set(11)
+}

modules/activemq/src/main/java/org/testcontainers/activemq/ActiveMQContainer.java

@@ -0,0 +1,85 @@
+package org.testcontainers.activemq;
+
+import org.testcontainers.containers.GenericContainer;
+import org.testcontainers.containers.wait.strategy.Wait;
+import org.testcontainers.utility.DockerImageName;
+
+import java.time.Duration;
+
+/**
+ * Testcontainers implementation for Apache ActiveMQ.
+ * <p>
+ * Exposed ports:
+ * <ul>
+ *     <li>Console: 8161</li>
+ *     <li>TCP: 61616</li>
+ *     <li>AMQP: 5672</li>
+ *     <li>STOMP: 61613</li>
+ *     <li>MQTT: 1883</li>
+ *     <li>WS: 61614</li>
+ * </ul>
+ */
+public class ActiveMQContainer extends GenericContainer<ActiveMQContainer> {
+
+    private static final DockerImageName DEFAULT_IMAGE = DockerImageName.parse("apache/activemq-classic");
+
+    private static final int WEB_CONSOLE_PORT = 8161;
+
+    private static final int TCP_PORT = 61616;
+
+    private static final int AMQP_PORT = 5672;
+
+    private static final int STOMP_PORT = 61613;
+
+    private static final int MQTT_PORT = 1883;
+
+    private static final int WS_PORT = 61614;
+
+    private String username;
+
+    private String password;
+
+    public ActiveMQContainer(String image) {
+        this(DockerImageName.parse(image));
+    }
+
+    public ActiveMQContainer(DockerImageName dockerImageName) {
+        super(dockerImageName);
+        dockerImageName.assertCompatibleWith(DEFAULT_IMAGE);
+
+        withExposedPorts(WEB_CONSOLE_PORT, TCP_PORT, AMQP_PORT, STOMP_PORT, MQTT_PORT, WS_PORT);
+        waitingFor(Wait.forLogMessage(".*Apache ActiveMQ.*started.*", 1).withStartupTimeout(Duration.ofMinutes(1)));
+    }
+
+    @Override
+    protected void configure() {
+        if (this.username != null) {
+            addEnv("ACTIVEMQ_CONNECTION_USER", this.username);
+        }
+        if (this.password != null) {
+            addEnv("ACTIVEMQ_CONNECTION_PASSWORD", this.password);
+        }
+    }
+
+    public ActiveMQContainer withUser(String username) {
+        this.username = username;
+        return this;
+    }
+
+    public ActiveMQContainer withPassword(String password) {
+        this.password = password;
+        return this;
+    }
+
+    public String getBrokerUrl() {
+        return String.format("tcp://%s:%s", getHost(), getMappedPort(TCP_PORT));
+    }
+
+    public String getUser() {
+        return this.username;
+    }
+
+    public String getPassword() {
+        return this.password;
+    }
+}