mongodb/mongodb-atlas-local Docker 镜像 - 轩辕镜像

mongodb/mongodb-atlas-local

Create, manage, and automate MongoDB Atlas Local resources from docker

Repository Overview

This is the Docker image for the Atlas Local experience.

Use the MongoDB Atlas Local Docker image to build applications with MongoDB Atlas in your preferred local environment and access features like Atlas Search and Atlas Vector Search throughout the entire software development lifecycle.

Getting Started

1. Pull the Docker image.

To pull the latest Docker image, run docker pull mongodb/mongodb-atlas-local.

If you run docker pull mongodb/mongodb-atlas-local without specifying a version tag, Docker automatically pulls the latest version of the Docker image (mongodb/mongodb-atlas-local:latest).

To pull a specific version of the Docker image, run the following command, replacing tag with the version tag: docker pull mongodb/mongodb-atlas-local:<tag>.

2. Run the database docker run -p 27017:27017 --name atlas-local mongodb/mongodb-atlas-local

3. Wait till the container is healthy.

   • When using docker compose you can use depends on:

   yaml
   depends_on:
     atlas-local
       condition: service_healthy
   

   • Or using bash: while [ "`docker inspect -f {{.State.Health.Status}} atlas-local`" != "healthy" ]; do sleep 2; done

4. Connect to the database mongosh "mongodb://localhost/?directConnection=true"

Authentication

To setup authentication for your local deployment, specify the following environment variables:

• MONGODB_INITDB_ROOT_USERNAME: The username for the root user.
• MONGODB_INITDB_ROOT_PASSWORD: The password for the root user.

You may also set it via filename mappings for an extra layer of security. Specify the following environment variables:

• MONGODB_INITDB_ROOT_USERNAME_FILE: The path to the file containing the username for the root user.
• MONGODB_INITDB_ROOT_PASSWORD_FILE: The path to the file containing the password for the root user.

Seeding

Map a volume to /docker-entrypoint-initdb.d containing .sh or .js files, they will be executed in alphabetical order.

The default db connected will be test unless the environment variable MONGODB_INITDB_DATABASE is set.

You can use $CONNECTION_STRING as the URI for connecting to databases in your init scripts, as it holds the default connection string for the database.

Logs

By default we only redirect mongod logs to stdout and stderr. You can set the extra environment variables to enable more logging:

• MONGOT_LOG_FILE: The path to the file where you want to store the logs of Atlas Search (mongot).
• RUNNER_LOG_FILE: The path to the file where you want to store the logs of runner.

Note: both of these variables can be set to /dev/stdout or /dev/stderr for convenience.

Telemetry

This image collects anonymous telemetry data to help us improve the product and to provide you with a better user experience. The data collected includes:

• Container lifecycle events: startup/shutdown timing, authentication status, seeding results
• Index usage: counts of search and vector indexes created and used
• Database activity: CRUD operation counts, database uptime, total database size
• Client information: anonymized driver versions, operating systems, and application names (limited to MongoDB official tools like Compass and mongosh)

All telemetry is associated with an anonymous deployment UUID. No customer data, database names, or personally identifiable information is collected.

You can opt out of telemetry by setting the DO_NOT_TRACK environment variable to 1. For example:

docker run -e DO_NOT_TRACK=1 -p 27017:27017 --name atlas-local mongodb/mongodb-atlas-local

Documentation

For more information, see Create a Local Atlas Deployment with Docker.