MongoDB draaien in Docker: een complete gids met voorbeelden

Dus je wilt MongoDB zelf hosten of er lokaal mee gaan experimenteren? Er zijn een paar opties om te beginnen als je niet direct in wilt duiken in MongoDB Atlas, waaronder containers met Docker. 

Docker gebruiken is een solide keuze voor het beheren van je MongoDB-instance, omdat het niet meer dan een minuut kost en makkelijk te onderhouden of te verplaatsen is tussen hosts.

In dit artikel bekijken we een paar manieren om MongoDB met Docker te deployen en delen we onderweg enkele tips en trucs. Je kunt ook deze video bekijken voor een snelle samenvatting van het onderwerp.

Vereisten

Om deze tutorial te volgen, moet je de Docker Engine op je computer hebben geïnstalleerd. Dit kan op macOS, Windows of Linux. Je hebt Docker Desktop niet per se nodig, maar afhankelijk van je besturingssysteem kan het je Docker-ervaring wel makkelijker maken. 

Ik gebruik de Docker Engine via Rancher Desktop op macOS, en dat werkt prima.

Wil je je Docker-skills opfrissen, bekijk dan zeker Docker for Beginners: A Practical Guide to Containers om de basis bij te spijkeren.

Een Docker-image voor MongoDB downloaden

Voordat je MongoDB in een Docker-container kunt draaien, moet je eerst een image downloaden die aan je behoeften voldoet. Voer vanaf de commandline het volgende uit:

docker pull mongodb/mongodb-community-server:latestMogelijk gemaakt door

Met bovenstaande opdracht wordt de officiële MongoDB Community Edition (CE)-image met de tag "latest" gedownload. 

Belangrijk om te weten: mongodb/mongodb-community-server en mongodb/mongodb-enterprise-server zijn officiële Docker-images die door MongoDB worden onderhouden. Alle andere images worden door de community onderhouden en kunnen andere of onverwachte resultaten opleveren.

Met een gedownloade image kunnen we naar de deploy-opties kijken.

MongoDB draaien als geïsoleerde container met het Docker run-commando

De snelste manier om MongoDB met Docker te deployen is simpelweg het docker run-commando te gebruiken met een paar configuratieparameters. Je kunt bijvoorbeeld het volgende vanaf je commandline uitvoeren:

docker run -d -p 27017:27017 -e MONGO_INITDB_ROOT_USERNAME=nraboy -e MONGO_INITDB_ROOT_PASSWORD=password1234 --name mongodb mongodb/mongodb-community-server:latestMogelijk gemaakt door

Bovenstaande opdracht pakt onze image en draait deze als een container met de naam "MongoDB". De container wordt port-gemapd, wat betekent dat de host ermee kan communiceren op poort "27017". In dit voorbeeld zijn ook de root-inloggegevens ingesteld, maar afhankelijk van je deploymentbehoeften kun je Docker Secrets of een andere beschermde manier gebruiken om gevoelige informatie door te geven.

In het voorbeeld hierboven wordt alle data binnen de container opgeslagen. De MongoDB-data, waaronder databases, collecties en zelfs documenten, blijft alleen bestaan zolang die specifieke container bestaat. Dat kan geschikt zijn voor tests, maar vaak wil je betrouwbare persistentie van je MongoDB-data in Docker. Maak hiervoor een Docker-volume met het volgende commando:

docker volume create mongodbMogelijk gemaakt door

Om je container dat volume te laten gebruiken, kun je je deploy-commando als volgt aanpassen:

docker run -d -p 27017:27017 -e MONGO_INITDB_ROOT_USERNAME=nraboy -e MONGO_INITDB_ROOT_PASSWORD=password1234 -v mongodb:/data/db --name mongodb mongodb/mongodb-community-server:latestMogelijk gemaakt door

Merk op dat we dit keer het te gebruiken volume specificeren. Met een volume kun je erop vertrouwen dat je data blijft bestaan, ook na het beëindigen of updaten van je container.

Met MongoDB draaiend in een Docker-container kun je verbinding maken met mongodb://nraboy:password1234@localhost:27017 als connection string vanuit een tool naar keuze.

MongoDB opnemen in je stack of project met Docker Compose

Als je van plan bent MongoDB te gebruiken met een specifiek project dat ook met Docker wordt beheerd, is het waarschijnlijk logisch om MongoDB met een Docker Compose-configuratie te beheren. Deze configuraties worden vaak gebruikt om je projecten te sandboxen, ook wel stacks genoemd.

Maak ergens op je computer een bestand docker-compose.yml met het volgende:

services:
    mongodb:
        image: mongodb/mongodb-community-server:latest
        container_name: mongodb
        restart: unless-stopped
        ports:
            - "27017:27017"
        volumes:
            - mongodb:/data/db
        environment:
            MONGO_INITDB_ROOT_USERNAME: nraboy
            MONGO_INITDB_ROOT_PASSWORD: password1234

volumes:
    mongodb:
        external: trueMogelijk gemaakt door

Bovenstaande configuratie gebruikt informatie die we al hebben gezien in het losse commandline-commando. Net als bij de andere methode is de verwachting hier dat je al een volume mongodb hebt aangemaakt dat door Docker wordt beheerd. Als je dit nog moet doen, voer dan opnieuw het volgende commando uit:

docker volume create mongodbMogelijk gemaakt door

Natuurlijk kun je je Docker-volumes beheren op een manier die voor jou logisch is. Een volume aanmaken is slechts een van de mogelijkheden.

Met je commandline in dezelfde werkmap als je docker-compose.yml-bestand, voer je het volgende commando uit:

docker compose up -dMogelijk gemaakt door

Bovenstaande opdracht start je stack in detached-modus. 

Je kunt controleren of alles werkt door te proberen verbinding te maken met je instance met een tool zoals MongoDB Compass, een van de taaldrivers zoals Node.js, of via de MongoDB Shell. 

Als je het voorbeeld exact volgt, is je connection string mongodb://nraboy:password1234@localhost:27017, maar afhankelijk van hoe je hebt meegedaan kan deze anders zijn.

Om je MongoDB-instance te stoppen, voer je vanaf de commandline het volgende uit met je YAML-configuratie in dezelfde werkmap:

docker compose downMogelijk gemaakt door

Omdat we een extern volume gebruiken, blijft bij de volgende start van je container alles bewaard.

Conclusie

Docker maakt het eenvoudig om met MongoDB te werken in een zelfgehoste of lokale omgeving. Je hoeft je geen zorgen te maken over algemene besturingssysteemconfiguraties of over verschillen tussen computers. Je krijgt elke keer een consistente ervaring. 

Wil je een stap verder gaan, leer dan hoe je een database maakt in MongoDB.