Zum Hauptinhalt springen

MongoDB in 5 Minuten bereitstellen

Diese Anleitung begleitet Sie bei der Erstellung Ihres ersten MongoDB-Clusters über die Hikube-Konsole bis zur ersten Verbindung mit mongosh.


Ziele​

Am Ende dieser Anleitung verfügen Sie über:

  • Einen MongoDB-Cluster (Replica Set), bereitgestellt in Ihrem Hikube-Projekt
  • Einen Benutzer mit Rechten auf einer Anwendungsdatenbank
  • Eine funktionierende Verbindung mit mongosh

Voraussetzungen​

  • Ein Hikube-Konto und ein Projekt mit ausreichenden Quotas (CPU, Arbeitsspeicher, Speicher)
  • Die Shell mongosh auf Ihrem Rechner, falls Sie eine Verbindung aus dem Internet testen möchten

Schritt 1: Cluster erstellen​

  1. Melden Sie sich bei der Hikube-Konsole an und wählen Sie Ihr Projekt aus.
  2. Öffnen Sie im Seitenmenü DB & Messaging → MongoDB. Die Seite MongoDB Clusters wird angezeigt.
  3. Klicken Sie auf Create a cluster. Der Assistent Create a MongoDB cluster öffnet sich.

Schritt 2: Konfigurieren und bestätigen​

Der Assistent umfasst fünf Schritte: General, Configuration, Users, Summary und Finish.

General​

Geben Sie den Cluster Name ein, zum Beispiel demo-mongo (3 bis 16 Zeichen: Kleinbuchstaben, Ziffern und Bindestriche; beginnt mit einem Buchstaben, endet mit einem Buchstaben oder einer Ziffer).

Configuration​

FeldEmpfohlener Wert für diese AnleitungHinweis
MongoDB Version8.0Angebotene Versionen: 6.0, 7.0, 8.0
Presets1.small — 1 CPU / 2GiKein Preset ist vorausgewählt; nach der Erstellung nicht änderbar
Disk size (GB)10Speicherkapazität pro Knoten
Number of replicas3 (Max High Availability)1 für einen einfachen Test; nach der Erstellung nicht änderbar
External accessAktiviertErforderlich, um sich von Ihrem Rechner aus zu verbinden
Sharding (Distributed Topology)DeaktiviertSiehe Sharding konfigurieren

Das Banner oben im Assistenten zeigt die Estimated Cost und die Auswirkung auf die Quotas des Projekts an.

Hinweis

Aktivieren Sie den External access nur, wenn Sie ihn benötigen: Er macht die Datenbank im öffentlichen Internet erreichbar.

Users​

Fügen Sie mindestens einen Benutzer hinzu:

  1. Username: zum Beispiel app-user (Kleinbuchstaben, Ziffern und Bindestriche).
  2. Database: die Anwendungsdatenbank, auf die sich die Rolle des Benutzers bezieht, zum Beispiel myapp (Kleinbuchstaben, Ziffern und Bindestriche). Sie wird angelegt, falls sie noch nicht existiert. Die Systemdatenbanken admin, local und config werden abgelehnt.
  3. Role: Administrator für diese Anleitung, oder Read-only.
  4. Klicken Sie auf Add.

Summary​

Prüfen Sie die Übersicht (Version, Preset, Data volume, Replicas, External exposure, Sharding, Users to create, Estimated cost) und klicken Sie dann auf Create cluster.


Schritt 3: Status prüfen​

Der Schritt Finish bestätigt die Erstellung („Creation complete!“). Klicken Sie auf Finish, um die Seite des Clusters zu öffnen.

StatusBedeutung
CreatingDer Cluster wird bereitgestellt
ReadyDer Cluster ist betriebsbereit
ErrorDie Plattform konnte die Erstellung oder die letzte Änderung des Clusters nicht anwenden

Erwartetes Ergebnis: Nach einigen Minuten wechselt der Status auf Ready. Die Seite zeigt die MongoDB Version, die Replicas, die Allocated Size und das Preset sowie die Karte Network and Connection: die Adressbereiche Internal und External und das Sharding. Bei einem Replica Set mit externem Zugriff listet der Bereich External eine Adresse pro Mitglied auf (member 1, member 2…), jeweils mit einer Kopierschaltfläche.


Schritt 4: Zugangsdaten abrufen und Zugriff auf eine Datenbank gewähren​

Zugangsdaten​

Der Schritt Finish des Assistenten zeigt unter User Credentials das Password jedes Benutzers sowie, wenn der externe Zugriff aktiviert ist, einen Internal Connection String: mongodb://app-user:<password>@<host> bei einem Cluster mit Sharding, mongodb://app-user:<password>@<member>:27017/?directConnection=true&authSource=admin bei einem Replica Set.

Warnung

Kopieren Sie diese Passwörter sofort: Sie werden nicht erneut angezeigt. Bei Verlust generieren Sie im Abschnitt Users ein neues (Actions → Change Password).

Zugriff auf die Anwendungsdatenbank​

Der Benutzer verfügt über die gewählte Rolle auf der im Schritt Users angegebenen Datenbank: Im Abschnitt Users der Cluster-Seite zeigt die Spalte Databases myapp (Administrator) an. Um ihm Zugriff auf weitere Datenbanken zu geben, öffnen Sie das Menü Actions des Benutzers und wählen Sie Manage Access (siehe Benutzer und Datenbanken verwalten).


Schritt 5: Verbindung und Tests​

Von Ihrem Rechner aus verbinden Sie sich bei einem Replica Set direkt mit einem Mitglied: Kopieren Sie eine der Adressen aus dem Bereich External oder den External connection string der Karte Network and Connection.

mongosh "mongodb://<member>:27017/myapp?directConnection=true&authSource=admin" --username app-user

Bei einem Cluster mit Sharding verwenden Sie die Adresse aus dem Bereich External: mongosh "mongodb://<host>:27017/myapp?authSource=admin" --username app-user.

Von einer VM oder einem Kubernetes-Cluster des Projekts aus verwenden Sie den Host aus dem Bereich Internal, ohne externen Zugriff. Bei einem Replica Set fügen Sie replicaSet=rs0 hinzu, wie die Konsole in Erinnerung ruft: Der Treiber findet das Primary dann selbst.

mongosh "mongodb://<internal-host>:27017/myapp?replicaSet=rs0&authSource=admin" --username app-user

Die Verbindung ist nicht verschlüsselt (kein TLS): Fügen Sie --tls nicht hinzu.

Geben Sie das Passwort ein und prüfen Sie anschließend die Verbindung:

db.runCommand({ ping: 1 })
db.test.insertOne({ message: "Bonjour Hikube" })
db.test.find()

Erwartetes Ergebnis:

{ ok: 1 }
[ { _id: ObjectId('...'), message: 'Bonjour Hikube' } ]
Hinweis

Das erreichte Mitglied kann ein Secondary sein, das keine Schreibvorgänge annimmt: insertOne antwortet dann mit not primary. Prüfen Sie dies mit db.hello().isWritablePrimary und verbinden Sie sich zum Schreiben mit einem anderen Mitglied der Liste. Ein Secondary bedient Lesevorgänge mit readPreference=secondaryPreferred.


Schritt 6: Schnelle Fehlerbehebung​

Der Bereich External zeigt „Disabled“ oder „Waiting for allocation…“ an​

„Disabled“: Der External access ist ausgeschaltet. Aktivieren Sie ihn über Edit, wenn Sie sich aus dem Internet verbinden müssen; aus dem Projekt verwenden Sie den Host aus dem Bereich Internal. „Waiting for allocation…“: Die öffentliche Adresse ist noch nicht zugewiesen, warten Sie einige Augenblicke.

Bei einem Replica Set mit externem Zugriff erhält jedes Mitglied eine eigene öffentliche Adresse: Der Bereich External listet sie auf, sobald sie zugewiesen sind. Verbinden Sie sich mit einer davon mit directConnection=true, ohne den Parameter replicaSet: Die Mitglieder melden sich unter clusterinternen Namen, die von außen nicht aufgelöst werden.

Der interne Host wird von einer VM aus nicht aufgelöst​

Kopieren Sie den vollständigen Namen aus dem Bereich Internal, ohne ihn zu kürzen. Unter Debian 13 wird der Name ohne Konfiguration nicht aufgelöst: siehe Einen verwalteten Dienst des Projekts erreichen.

Authentication failed​

Prüfen Sie den Benutzernamen, das Passwort und die Authentifizierungsdatenbank (authSource=admin oder --authenticationDatabase admin). Wenn das Passwort verloren gegangen ist, führen Sie im Abschnitt Users eine Rotation durch.

not authorized on myapp​

Der Benutzer hat keinen Zugriff auf die Datenbank myapp. Fügen Sie ihn über Manage Access hinzu.

Der Cluster wechselt in den Status Error​

Die Plattform konnte die Erstellung oder die letzte Änderung des Clusters nicht anwenden. Wenden Sie sich an den Support und geben Sie den Namen des Projekts und des Clusters an.


Schritt 7: Bereinigung​

  1. Öffnen Sie die Seite des Clusters (DB & Messaging → MongoDB → Name des Clusters).
  2. Klicken Sie auf Delete cluster.
  3. Geben Sie den genauen Namen des Clusters in das Feld Resource name to confirm ein und klicken Sie dann auf Permanently delete.
Warnung

Diese Aktion löscht den MongoDB-Cluster und alle zugehörigen Daten. Sie ist unwiderruflich.


Zusammenfassung​

Sie haben über die Konsole Folgendes erstellt:

  • Einen replizierten MongoDB-Cluster in Ihrem Projekt
  • Einen Benutzer und seine Rechte auf einer Anwendungsdatenbank
  • Einen externen Zugriff und eine mongosh-Verbindung