MongoDB in Docker ausführen: Ein kompletter Leitfaden mit Beispielen

Du willst MongoDB selbst hosten oder einfach mal lokal damit rumspielen? Wenn du nicht direkt mit MongoDB Atlas loslegen willst, gibt's ein paar Möglichkeiten, um anzufangen. Eine davon sind Container mit Docker. 

Docker ist eine gute Wahl für die Verwaltung deiner MongoDB-Instanz, weil es nur eine Minute dauert und einfach zu warten und zwischen Host-Computern zu verschieben ist.

In diesem Artikel schauen wir uns ein paar Ansätze für die Bereitstellung von MongoDB mit Docker an und zeigen dir dabei ein paar Tipps und Tricks.

Was du schon wissen solltest

Um diesem Tutorial folgen zu können, musst du die Docker Engine auf deinem Computer installiert haben. Das kann auf macOS, Windows oder Linux sein. Du brauchst Docker Desktop nicht unbedingt installiert, aber es kann dir die Arbeit mit Docker erleichtern, je nachdem, welches Betriebssystem du benutzt. 

Ich benutze die Docker Engine über Rancher Desktop auf macOS, zum Beispiel, und es funktioniert super.

Um deine Docker-Kenntnisse aufzufrischen, solltest du dir „ Docker for Beginners“ ansehen: Ein praktischer Leitfaden zu Container-, um die Grundlagen nachzuholen.

Herunterladen eines MongoDB-Docker-Images

Bevor du MongoDB in einem Docker-Container starten kannst, musst du erst mal ein Image runterladen, das deinen Anforderungen entspricht. Mach das hier in der Befehlszeile:

docker pull mongodb/mongodb-community-server:latest

Mit dem obigen Befehl wird das offizielle MongoDB Community Edition (CE)-Image mit dem Tag „latest“ runtergeladen. 

Wichtig: mongodb/mongodb-community-server und mongodb/mongodb-enterprise-server sind offizielle Docker-Images, die von MongoDB gepflegt werden. Alle anderen Bilder werden von der externen Community gepflegt und können zu anderen oder unerwarteten Ergebnissen führen.

Nachdem das Image runtergeladen ist, können wir uns die Bereitstellungsoptionen anschauen.

MongoDB als isolierten Container mit dem Befehl „Docker Run“ ausführen

Der schnellste Weg, MongoDB mit Docker einzurichten, ist einfach den Befehl „ docker run “ mit ein paar Konfigurationsparametern zu verwenden. Du kannst zum Beispiel Folgendes über die Befehlszeile machen:

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

Der obige Befehl nimmt unser Image und stellt es als Container mit dem Namen „MongoDB” bereit. Der Container wird port-gemappt, was bedeutet, dass der Host über den Port „27017“ mit ihm interagieren kann. Die Root-Authentifizierungsinfos sind in diesem Beispiel auch schon eingestellt, aber je nachdem, was du brauchst, kannst du Docker Secrets oder eine andere sichere Methode nutzen, um sensible Infos weiterzugeben.

Im obigen Beispiel werden alle Daten im Container gespeichert. Die MongoDB-Daten, zu denen Datenbanken, Sammlungen und sogar Dokumente gehören, bleiben nur so lange erhalten, wie der jeweilige Container existiert. Für Tests mag das okay sein, aber meistens willst du, dass deine MongoDB-Daten in Docker zuverlässig gespeichert werden. Um das zu machen, solltest du mit dem folgenden Befehl ein Docker-Volume erstellen:

docker volume create mongodb

Um deinem Container zu sagen, dass er dieses Volume verwenden soll, kannst du deinen Bereitstellungsbefehl so ändern, dass er in etwa wie folgt aussieht:

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:latest

Beachte, dass wir diesmal das zu verwendende Volume angeben. Wenn du ein Volume benutzt, kannst du sicher sein, dass deine Daten auch nach dem Beenden oder Aktualisieren deines Containers noch da sind.

Wenn MongoDB in einem Docker-Container läuft, kannst du dich mit einem Tool deiner Wahl über die Verbindungszeichenfolge „ mongodb://nraboy:password1234@localhost:27017 “ verbinden.

MongoDB mit Docker Compose in deinen Stack oder dein Projekt einbinden

Wenn du vorhast, MongoDB für ein bestimmtes Projekt zu nutzen, das auch mit Docker verwaltet wird, ist es wahrscheinlich sinnvoll, MongoDB mit einer Docker Compose-Konfiguration zu verwalten. Diese Konfigurationen werden oft zum Sandboxing deiner Projekte verwendet und oft als Stacks bezeichnet.

Erstell irgendwo auf deinem Computer eine Datei namens „ docker-compose.yml ” mit folgendem Inhalt:

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: true

Die obige Konfiguration nutzt Infos, die wir schon im Befehl singular gesehen haben. Wie bei der anderen Methode wird auch hier davon ausgegangen, dass du bereits ein Volume namens „ mongodb “ erstellt hast, das von Docker verwaltet werden soll. Wenn du das machen musst, gib einfach den folgenden Befehl ein:

docker volume create mongodb

Natürlich kannst du deine Docker-Volumes so verwalten, wie es für dich am besten passt. Ein Volume zu erstellen ist nur eine von vielen Möglichkeiten.

Wenn deine Befehlszeile auf dasselbe Arbeitsverzeichnis wie deine Datei „ docker-compose.yml “ eingestellt ist, gib den folgenden Befehl ein:

docker compose up -d

Der obige Befehl startet deinen Stack im getrennten Modus. 

Du kannst überprüfen, ob alles funktioniert, indem du versuchst, mit einem Tool wie MongoDB Compass, einem der Sprachtreiber wie Node.js oder über die MongoDB Shell eine Verbindung zu deiner Instanz herzustellen. 

Wenn du dem Beispiel genau folgst, sieht deine Verbindungszeichenfolge so aus: mongodb://nraboy:password1234@localhost:27017. Je nachdem, wie du die Anleitung befolgt hast, kann sie aber auch anders aussehen.

Um deine MongoDB-Instanz zu beenden, gib das Folgende in der Befehlszeile ein, wobei sich deine YAML-Konfiguration im selben Arbeitsverzeichnis befinden sollte:

docker compose down

Da wir ein externes Volume verwenden, bleibt beim nächsten Start deines Containers alles erhalten.

Fazit

Mit Docker ist es echt einfach, MongoDB in einer selbst gehosteten oder lokalen Umgebung zu nutzen. Du musst dir keine Gedanken über die allgemeinen Betriebssystemeinstellungen oder die Unterschiede zwischen verschiedenen Computern machen. Du wirst jedes Mal das gleiche Erlebnis haben. 

Um einen Schritt weiterzukommen, lohnt es sich, zu lernen, wie man eine Datenbank in MongoDB erstellt.