a2ikm/sharded-mongo repository overview

⁠a2ikm/sharded-mongo

https://hub.docker.com/r/a2ikm/sharded-mongo⁠

⁠What is this?

a2ikm/sharded-mongo is a container which runs a smallest sharded MongoDB cluster. It is composed of one shard server, one config server, and one mongos process.

WARNING: this project focuses on simple CI usages and is insecure. Don't use it for production.

⁠How to use

$ docker run --rm --publish 27017:27017 a2ikm/sharded-mongo

The mongos process listens the 27017 port for client connections.

It loads *.sh files or *.js files mounted at /docker-entrypoint-initdb.d.

⁠Supported MongoDB versions

We support the following versions:

• 4.0
• 4.2
• 4.4
• 5.0
• 6.0
• 7.0
• 8.0

They are from Docker official image⁠.

⁠Development

Its Dockerfile and entrypoint script are managed on GitHub: https://github.com/a2ikm/docker-sharded-mongo⁠

⁠Issue management

If you have an issue, please file it to https://github.com/a2ikm/docker-sharded-mongo/issues⁠.

⁠Release management

1. Create a pull request to the main branch
2. Pass the CI, and merge it
3. Then, new images are built and pushed to Docker Hub

⁠How to test on your local machine

# with latest version
$ make test

# with all versions
$ make test-all

⁠How to add new version

1. Add src/N.N directory with Dockerfile etc.
2. Add .github/workflows/ci-N-N.yaml
3. Update make test-all definition in Makefile