Skip to content

Latest commit

 

History

History
116 lines (83 loc) · 5.54 KB

10_MongoDb_Atlas.md

File metadata and controls

116 lines (83 loc) · 5.54 KB

MongoDB Atlas: MongoDB in der Cloud

Bis jetzt läuft unsere MongoDB Datenbank lokal in einem Docker Container. Für die Entwicklung und zum Testen ist das auch die einfachste Möglichkeit. Wenn die Applikation in Produktion geht, brauchen wir natürlich einen Datenbankserver, der im Netzwerk erreichbar ist.

MongoDB bietet auch einen Cloudservice an: MongoDB Atlas. Das Service läuft auf AWS, Azure oder der Google Cloud. Es gibt auch einen free plan (M0). Dieser Plan hat natürlich Einschränkungen.

  • You can deploy at most one M0 free cluster per Atlas project.
  • M0 free clusters allow up to 100 operations per second.
  • M0 free clusters and M2/M5 shared clusters can have a maximum of 100 databases and 500 collections total.
  • M0 free clusters and M2/M5 shared clusters limit the total data transferred into or out of the cluster in a rolling seven-day period. The rate limits vary by cluster tier as follows:
    • M0: 10 GB in and 10 GB out per period
  • M0 free clusters and M2/M5 shared clusters don't support server-side JavaScript. For example, $where and map-reduce are unsupported.

Quelle: https://www.mongodb.com/docs/atlas/reference/free-shared-limitations/#operational-limitations

Registrieren bei account.mongodb.com und Anlegen eines Clusters

Registriere dich bei https://account.mongodb.com/ und lege einen User an. Danach kannst du ein Projekt und einen Cluster wie in diesem Video erstellen, dich mit Studio 3T verbinden und die ExamsDb anlegen.

📺 Video: Erstellen eines Clusters in MongoDB Atlas und Einspielen der ExamsDb

Im Video wird der Cluster wie folgt angelegt:

  • New Projekt: Ein Projekt mit dem Namen examsProjekt anlegen.
  • Menü Database: Mit Build a Database einen neuen Cluster anlegen.
    • Typ der Instanz: Shared, Plan M0 (free tier).
    • Provider: Azure, Region Ireland (northeurope). Es kann auch ein anderer Anbieter gewählt werden.
    • Cluster Name: examsCluster
    • Username: Es wird noch kein User angelegt, das wird später erledigt wo eine Rollenzuweisung auch möglich ist.
    • IP Address List: Der IP Range 0.0.0.0/0 in der IP Address List den Zugriff erlauben.
  • Menü Database Access (Security): Einen User mit dem Namen root und einem generiertem Passwort anlegen. Das Passwort für den Connection String kopieren. Die Rolle Atlas admin zuweisen.
  • Menü Database (Deployment): Mit Connect den Connection String kopieren und das root Passwort einsetzen.

Nachträgliche Konfigurieren des Clusters

Logge dich auf https://account.mongodb.com/account/login mit dem User, den du bei der Registrierung angegeben hat, ein. Du kannst hier das Kennwort für den User neu setzen oder die IP Adressen, von denen zugegriffen werden darf, ändern. Die letzte Einstellung ist dann wichtig, wenn du eine dynamische IP hast oder eine Applikation, die auf einem Server läuft, auf die Datenbank zugreifen soll.

Der Cluster kann im Menü Databases konfiguriert werden. Ein Klick auf den Namen öffnet weitere Konfigurationsmöglichkeiten:

Löschen des Clusters

Falls etwas schief gegangen ist, kannst du auf der Konfigurationsseite den Menüpunkt Projects auswählen und das ganze Projekt löschen. Vorher muss der Cluster mit Terminate beendet und gelöscht werden.

Anlegen der Musterdatenbank in MongoDB Atlas

Nun wollen wir unsere examsDb in der Cloud anlegen. Das ist sehr einfach. Kopiere das Generatorprogramm von 13_NoSQL/ExamsDb (.NET) oder 13_NoSQL/examsdb-java (Java) in ein neues Verzeichnis. Ändere den Verbindungsstring der Methode ExamDatabase.FromConnectionString in der Datei Program.cs oder Main.java auf die gerade erstellten URI. Wenn du das Programm ausführst, wird die Datenbank im erstellten Cluster angelegt. Natürlich dauert das etwas länger als die lokale Lösung mit dem Container.

Anhang

Alternative: mehr Kontrolle durch manuelles Anlegen mit der Atlas CLI

Lade danach von der Atlas CLI Downloadseite das Programm atlas für dein Betriebssystem. Unter Windows verwende die ZIP Datei, öffne das Archiv und ziehe die Datei atlas.exe im Verzeichnis bin in einen Ordner auf der Festplatte.

Zuerst wird mit atlas project ein neues Projekt angelegt. In unserem Beispiel heißt es examsProject

atlas projects create examsProject

Generiere nun mit einem Passwort Generator wie z. B. https://www.random.org/passwords/ ein starkes Passwort für den root User (ca. 20 Stellen). Kopiere danach die folgenden Befehle in einen Editor und ändere 2 Sachen:

  • Statt (Passwort) füge das erzeugte Passwort ein.
  • Statt (Project ID) füge die ID des Projektes ein. Sie wird nach dem Ausführen des Befehls atlas projects angezeigt.
atlas dbusers create atlasAdmin --username root --password (Passwort) --projectId (Project ID)

atlas accessLists create 0.0.0.0/0 --projectId (Project ID)

atlas clusters create examsCluster --type REPLICASET --members 3 --tier M0 --provider AZURE --region EUROPE_NORTH --projectId (angezeigte projectid einfügen)

Zur Befehlsreferenz

Ein sharded Cluster kann mit dem folgenden Befehl angelegt werden. Er wird aber erst ab dem Plan M30 unterstützt:

atlas clusters create examsCluster --type SHARDED --shards 5 --tier M0 --provider AZURE --region EUROPE_NORTH --projectId (angezeigte projectid einfügen)