Add MongoDB Atlas support for TestContainers and Docker Compose

Implement service connection support for MongoDB Atlas using both
TestContainers and Docker Compose. This change enables easier
integration testing and local development with MongoDB Atlas.

- Leverage TestContainers 1.20.2 which introduces MongoDBAtlasLocalContainer
- Add TestContainers support using MongoDBAtlasLocalContainer
- Implement Docker Compose configuration for MongoDB Atlas
- Create connection details factories for both TestContainers and Docker Compose
- Update dependency management for MongoDB Atlas integration
- Add integration tests for both TestContainers and Docker Compose setups
- Update documentation to include MongoDB Atlas support

spring-ai-spring-boot-docker-compose/pom.xml

@@ -123,6 +123,13 @@
 			<optional>true</optional>
 		</dependency>
 
+		<dependency>
+			<groupId>org.springframework.ai</groupId>
+			<artifactId>spring-ai-mongodb-atlas-store</artifactId>
+			<version>${project.parent.version}</version>
+			<optional>true</optional>
+		</dependency>
+
         <!-- test dependencies -->
 
         <dependency>

spring-ai-spring-boot-docker-compose/src/main/java/org/springframework/ai/docker/compose/service/connection/mongo/MongoDbAtlasLocalDockerComposeConnectionDetailsFactory.java

@@ -0,0 +1,83 @@
+/*
+ * Copyright 2023 - 2024 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.springframework.ai.docker.compose.service.connection.mongo;
+
+import com.mongodb.ConnectionString;
+import org.springframework.boot.autoconfigure.mongo.MongoConnectionDetails;
+import org.springframework.boot.docker.compose.core.RunningService;
+import org.springframework.boot.docker.compose.service.connection.DockerComposeConnectionDetailsFactory;
+import org.springframework.boot.docker.compose.service.connection.DockerComposeConnectionSource;
+
+/**
+ * A {@link DockerComposeConnectionDetailsFactory} implementation that creates
+ * {@link MongoConnectionDetails} for a MongoDB Atlas Local instance running in a Docker
+ * container.
+ *
+ * <p>
+ * This factory is designed to work with Docker Compose configurations that include a
+ * MongoDB Atlas Local container. It provides the necessary connection details for Spring
+ * Boot applications to connect to the MongoDB instance.
+ *
+ * <p>
+ * The factory matches containers with the image name "mongodb/mongodb-atlas-local".
+ *
+ * <p>
+ * Usage of this factory requires the presence of the Spring Boot Docker Compose support
+ * and the MongoDB driver on the classpath.
+ *
+ * @author Eddú Meléndez
+ * @see DockerComposeConnectionDetailsFactory
+ * @see MongoConnectionDetails
+ * @see org.springframework.boot.docker.compose.service.connection.DockerComposeConnectionSource
+ * @since 1.0.0
+ */
+class MongoDbAtlasLocalDockerComposeConnectionDetailsFactory
+		extends DockerComposeConnectionDetailsFactory<MongoConnectionDetails> {
+
+	private static final int MONGODB_PORT = 27017;
+
+	protected MongoDbAtlasLocalDockerComposeConnectionDetailsFactory() {
+		super("mongodb/mongodb-atlas-local");
+	}
+
+	@Override
+	protected MongoConnectionDetails getDockerComposeConnectionDetails(DockerComposeConnectionSource source) {
+		return new MongoDbAtlasLocalContainerConnectionDetails(source.getRunningService());
+	}
+
+	/**
+	 * {@link MongoConnectionDetails} backed by a {@code MongoDB Atlas}
+	 * {@link RunningService}.
+	 */
+	static class MongoDbAtlasLocalContainerConnectionDetails extends DockerComposeConnectionDetails
+			implements MongoConnectionDetails {
+
+		private final String connectionString;
+
+		MongoDbAtlasLocalContainerConnectionDetails(RunningService service) {
+			super(service);
+			this.connectionString = String.format("mongodb://%s:%d/?directConnection=true", service.host(),
+					service.ports().get(MONGODB_PORT));
+		}
+
+		@Override
+		public ConnectionString getConnectionString() {
+			return new ConnectionString(this.connectionString);
+		}
+
+	}
+
+}

spring-ai-spring-boot-docker-compose/src/main/resources/META-INF/spring.factories

@@ -1,5 +1,6 @@
 org.springframework.boot.autoconfigure.service.connection.ConnectionDetailsFactory=\
 org.springframework.ai.docker.compose.service.connection.chroma.ChromaDockerComposeConnectionDetailsFactory,\
+org.springframework.ai.docker.compose.service.connection.mongo.MongoDbAtlasLocalDockerComposeConnectionDetailsFactory,\
 org.springframework.ai.docker.compose.service.connection.ollama.OllamaDockerComposeConnectionDetailsFactory,\
 org.springframework.ai.docker.compose.service.connection.opensearch.OpenSearchDockerComposeConnectionDetailsFactory,\
 org.springframework.ai.docker.compose.service.connection.qdrant.QdrantDockerComposeConnectionDetailsFactory,\

spring-ai-spring-boot-docker-compose/src/test/java/org/springframework/ai/docker/compose/service/connection/mongo/MongoDbAtlasLocalDockerComposeConnectionDetailsFactoryTests.java

@@ -0,0 +1,22 @@
+package org.springframework.ai.docker.compose.service.connection.mongo;
+
+import org.junit.jupiter.api.Test;
+import org.springframework.boot.autoconfigure.mongo.MongoConnectionDetails;
+import org.springframework.boot.docker.compose.service.connection.test.AbstractDockerComposeIntegrationTests;
+import org.testcontainers.utility.DockerImageName;
+
+import static org.assertj.core.api.Assertions.assertThat;
+
+class MongoDbAtlasLocalDockerComposeConnectionDetailsFactoryTests extends AbstractDockerComposeIntegrationTests {
+
+	protected MongoDbAtlasLocalDockerComposeConnectionDetailsFactoryTests() {
+		super("mongo-compose.yaml", DockerImageName.parse("mongodb/mongodb-atlas-local"));
+	}
+
+	@Test
+	void runCreatesConnectionDetails() {
+		MongoConnectionDetails connectionDetails = run(MongoConnectionDetails.class);
+		assertThat(connectionDetails.getConnectionString()).isNotNull();
+	}
+
+}

spring-ai-spring-boot-docker-compose/src/test/resources/org/springframework/ai/docker/compose/service/connection/mongo/mongo-compose.yaml

@@ -0,0 +1,5 @@
+services:
+  mongo:
+    image: '{imageName}'
+    ports:
+      - '27017'