MongoDB Toolbox

A collection of MongoDB scripts for automating common tasks in a Docker-centric way.

Important

Maintained by Panubo — Cloud Native & SRE Consultants in Sydney. Work with us →

Documentation

Documentation for each subcommand:

• load
• save

General Usage

Using Docker links to mongodb container:

docker run --rm -i -t --link myserver:mongodb docker.io/panubo/mongodb-toolbox:0.0.7-1

This will display the usage information.

docker run --rm -i -t --link myserver:mongodb docker.io/panubo/mongodb-toolbox:0.0.7-1 <subcommand>

To run the subcommand.

Configuration

Use --link <mongodb container name>:mongodb to automatically specify the required variables.

Or alternatively specify the variables:

Name	Description
DATABASE_HOST	IP / hostname of MongoDB server.
DATABASE_PORT	TCP Port of MongoDB service.
DATABASE_USER	Administrative user
DATABASE_PASS	Password of administrative user.

Some subcommands require additional environment parameters or positional arguments. See the documentation for the subcommand for more information.

Testing

The Makefile initiates a test designed to be run in a CI/CD. It starts up a Docker-in-Docker container and runs the tests within a temporary container which is set up and torn down upon every invocation to ensure a clean environment.

make test

If you are developing locally and wish to run the tests outside the Docker-in-Docker container in order to gain a better visibility into the process, you can run the following command from the repository root:

./test/runner.sh

Status

Works, however some features are incomplete.

Important

About Panubo

This project is maintained by Panubo, a technology consultancy based in Sydney, Australia. We build reliable, scalable systems and help teams master the cloud-native ecosystem.

We are available for hire to help with:

• SRE & Operations: Improving system reliability and incident response.
• Platform Engineering: Building internal developer platforms that scale.
• Kubernetes: Cluster design, security auditing, and migrations.
• DevOps: Streamlining CI/CD pipelines and developer experience.
• See our other services

Need a hand with your infrastructure? Let’s have a chat or email us at team@panubo.com.