MongoDB is an outstanding NoSQL database that offers plenty of features to satisfy the most demanding needs, but I’ve found installing MongoDB to be a bit inconsistent across Linux distributions. MongoDB might install just fine on, say, Ubuntu 20.04, but there’s no guarantee it will start properly. That’s an issue I’ve experienced on several occasions.
SEE: Hiring Kit: Database engineer (TechRepublic Premium)
What do you do when you don’t have time to install and troubleshoot an installation of MongoDB? You could always go the container route. After all, deploying with a container is a much more predictable route. On top of that, it’s considerably easier and you can spin it up on any machine that supports Docker.
That’s a win-win, so if you need to get a MongoDB instance up and running for development purposes, read on.
What you’ll need to deploy MongoDB as a container
The only things you’ll need for this deployment are a machine that supports Docker and a user with sudo permission. I’m going to demonstrate on Ubuntu Server 22.04. Let’s get to it.
How to install Docker Community Edition
In case you don’t already have Docker installed, here is the step to do so on Ubuntu Server. The first thing to do is add the official Docker GPG key with:
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
Next, add the official Docker repository:
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
Install a few dependencies with:
sudo apt-get install apt-transport-https ca-certificates curl gnupg lsb-release -y
Update apt with the command:
sudo apt-get update
Finally, install Docker with:
sudo apt-get install docker-ce docker-ce-cli containerd.io -y
To finish things up, make sure your user is a member of the docker group with the command:
sudo usermod -aG docker $USER
Log out and log back in so the changes take effect.
How to deploy MongoDB with Docker
Pull the latest Docker image from MongoDB with the command
docker pull mongo:latest
Before we run the deployment command, we need to create a volume for the database so we can retain data should something go awry with the container.
Create the volume with
docker volume create mongodata
Now that our volume is ready, we can deploy it with the command
docker run -d -v mongodata:/data/db --name mymongo --net=host mongo:latest --bind_ip 127.0.0.1 --port 27000
With a container running, you will then need to know how to access it. That’s actually quite simple. The command to access your running MongoDB container would be
docker exec -it mymongo bash
Access the mongoDB console with the command
You should find yourself on the MongoDB console, where you can start developing your databases. You can exit the console with the exit command, and then exit the container also with the exit command. You can then return to the MongoDB console with the previous commands whenever it’s time to work with the database again.
For more tutorials from Jack Wallen, subscribe to TechRepublic’s YouTube channel How To Make Tech Work — and remember to like this video.