Kurs
MongoDB Atlas ist ein cloudbasiertes Datenbankangebot, mit dem du MongoDB-Datenbanken bereitstellst, verwaltest und skalierst. Du kannst Atlas über die webbasierte Atlas UI nutzen oder über die Atlas CLI, ein Kommandozeilentool, mit dem du dieselben Aufgaben per Befehl ausführst.
Die MongoDB Atlas CLI ist eine schnellere Alternative zur Atlas UI. Du kannst Verwaltungsaufgaben für Datenbanken direkt im Terminal ausführen und automatisieren.
In diesem Artikel zeige ich dir Schritt für Schritt, wie du mit der Atlas CLI deine Datenbanken verwaltest.
Voraussetzungen
Bevor du loslegst, stelle sicher, dass du Folgendes hast:
- Ein MongoDB Atlas Konto.
- Grundkenntnisse in der Kommandozeile.
- Installationsvoraussetzungen der Atlas CLI für dein Betriebssystem.
Aufbau der CLI-Befehle
Die MongoDB Atlas CLI folgt einer einheitlichen Befehlsstruktur:
atlas [command] [subcommand] [flags]
Wenn du einen Befehl ohne Subcommands oder Flags ausführst, zeigt die CLI eine Hilfe mit folgenden Punkten an:
- Nutzung: Wie der Befehl verwendet wird.
- Aliasse: Alternative Namen für den Befehl.
- Verfügbare Befehle: Subcommands, die du ausführen kannst.
- Flags: Befehls-spezifische Optionen.
- Globale Flags: Optionen, die für alle CLI-Befehle gelten.
Wenn du zum Beispiel Folgendes ausführst:
atlas clusters
Erhältst du eine Ausgabe ähnlich dieser:
Manage clusters for your project. The clusters command provides access to your cluster configurations. You can create, edit, and delete clusters.
Usage:
atlas clusters [command]
Aliases:
clusters, cluster
Available Commands:
list Return all clusters for your project.
describe Return the details for the specified cluster for your project.
advancedSettings Manage advanced configuration settings for your cluster.
...
Flags:
-h, --help help for clusters
Global Flags:
-P, --profile string Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings.
Use "atlas clusters [command] --help" for more information about a command.
Befehlsnamen, Argumente und Flag-Namen sind in der Atlas CLI case-sensitiv. Verwende exakt die Groß- und Kleinschreibung aus den Beispielen—zum Beispiel --orgId statt --orgID.
Eine MongoDB-Bereitstellung erstellen
Eine Bereitstellung ist eine laufende MongoDB-Instanz, die deine Daten speichert und bereitstellt. Jede Bereitstellung umfasst Datenbankserver, Storage, Netzwerk und automatisierte Backups. MongoDB Atlas übernimmt das Infrastrukturmanagement, sodass du dich auf die Nutzung der Datenbank statt auf das Verwalten von Servern konzentrierst.
Um eine MongoDB-Bereitstellung zu erstellen, installiere oder aktualisiere die Atlas CLI und führe dann den Befehl aus:
atlas setup
Der Befehl atlas setup führt dich interaktiv durch die Einrichtung. Du triffst Konfigurationsentscheidungen, und die CLI erstellt ein Projekt, provisioniert einen Cluster und richtet grundlegende Sicherheitseinstellungen ein.
Mit einer bestehenden Bereitstellung authentifizieren
Wenn du bereits eine MongoDB Atlas Bereitstellung hast und sie mit der CLI verwalten möchtest, musst du dich authentifizieren. Melde dich an mit:
atlas auth login
Dieser Befehl lässt dich den Authentifizierungstyp wählen und stellt dir anschließend einen einmaligen Bestätigungscode bereit. Kopiere den Code und füge ihn im Browser ein, wenn du dazu aufgefordert wirst. Zum Beispiel:
atlas auth login
? Select authentication type: UserAccount
To verify your account, copy your one-time verification code:
QPWF-6GT4
Paste the code in the browser when prompted to activate your Atlas CLI. Your code will expire after 3 minutes.
To continue, go to https://account.mongodb.com/account/connect
Press Enter to open the browser and complete authentication...
Successfully logged in as your-email@example.com.
Nach der Anmeldung wählst du eine Standardorganisation und ein Ausgabeformat. Die CLI speichert deine Sitzung, sie läuft jedoch regelmäßig ab. Wenn die Meldung "Session expired" erscheint, führe atlas auth login erneut aus.
Profile für mehrere Umgebungen verwalten
Profile ermöglichen es dir, mehrere MongoDB Atlas Umgebungen mit derselben CLI-Installation zu verwalten. Jedes Profil speichert Verbindungseinstellungen für eine andere Umgebung, zum Beispiel Entwicklung, Staging oder Produktion.
Mit Profilen kannst du schnell zwischen Umgebungen wechseln, ohne dich neu anzumelden oder Konfigurationsdateien zu ändern. Das ist praktisch, wenn du getrennte MongoDB Atlas Projekte oder Organisationen für unterschiedliche Phasen deines Entwicklungsworkflows pflegst.
Üblich ist, für jede Umgebung ein eigenes Atlas Projekt zu erstellen und sie per Profil zu verwalten—zum Beispiel:
- Entwicklungsprofil: Verweist auf dein Dev-Projekt mit einem kleinen M0-Cluster zum Testen.
- Staging-Profil: Verweist auf dein Staging-Projekt, das die Produktivkonfiguration spiegelt.
- Produktionsprofil: Verweist auf dein Produktionsprojekt mit produktionsreifen Clustern.
Profile für verschiedene Umgebungen erstellen
Wenn du atlas auth login zum ersten Mal ausführst, erstellt die CLI ein Standardprofil. Weitere Profile für andere Umgebungen erstellst du mit dem Flag --profile:
atlas auth login --profile dev
Dadurch wird ein Profil namens "dev" erstellt und du wirst durch die Authentifizierung geführt. Wiederhole das für jede Umgebung:
atlas auth login --profile staging
atlas auth login --profile production
Jedes Profil speichert eigene Zugangsdaten sowie Standardprojekt- und Organisationseinstellungen.
Verfügbare Profile auflisten
Um alle eingerichteten Profile anzuzeigen, führe aus:
atlas config list
Damit siehst du alle von dir erstellten Profilnamen.
Profildetails anzeigen
Um die Konfiguration eines bestimmten Profils zu sehen, führe aus:
atlas config describe <profileName>
Zum Beispiel:
atlas config describe dev
Dadurch werden die Einstellungen des Profils angezeigt, einschließlich Standardorganisation und Projekt-IDs.
Zwischen Profilen wechseln
Um für einen Befehl ein bestimmtes Profil zu verwenden, ergänze das Flag --profile:
atlas clusters list --profile production
Damit listest du Cluster mit den Zugangsdaten und Einstellungen des Produktionsprofils.
Du kannst auch ein Standardprofil setzen, damit du es nicht bei jedem Befehl angeben musst:
atlas config set --profile staging
Nach dem Setzen eines Defaults verwenden alle Befehle dieses Profil, es sei denn, du überschreibst es mit dem Flag --profile.
Profileinstellungen aktualisieren
Um die Konfiguration eines Profils zu ändern, führe aus:
atlas config set <setting> <value> --profile <profileName>
Zum Beispiel, um ein Standardprojekt für das Dev-Profil zu setzen:
atlas config set project_id 5f8e8d9a1b2c3d4e5f6g7h8i --profile dev
Profile umbenennen
Um ein Profil umzubenennen, führe aus:
atlas config rename <oldName> <newName>
Zum Beispiel:
atlas config rename dev development
Projekte verwalten
Projekte in MongoDB Atlas organisieren deine Cluster, Nutzenden und Einstellungen. Du kannst dir ein Projekt als Container vorstellen, der zusammengehörige Datenbankressourcen bündelt.
Jedes Projekt kann mehrere Cluster enthalten und hat eigene Nutzende und Zugriffssteuerungen. Diese Trennung ist hilfreich, wenn unterschiedliche Anwendungen, Umgebungen oder Teams isolierte Datenbankressourcen benötigen.
Projekte erstellen
Um ein neues Projekt zu erstellen, führe aus:
atlas projects create <projectName> [options]
Verwende einen aussagekräftigen Namen, der den Zweck widerspiegelt, etwa "ecommerce-transactions" oder "mobile-app-staging".
[options] umfasst Flags, die steuern, wie und wo das Projekt erstellt wird. Du kannst zum Beispiel die Organisation angeben, in der das Projekt angelegt werden soll:
atlas projects create mobile-app-staging --orgId <organizationId>
Mit dem Flag --orgId legst du fest, in welcher Organisation das Projekt erstellt wird. Es ist erforderlich, sofern du keine Standardorganisation gesetzt hast. Mit atlas organizations list erhältst du eine Liste deiner Organisationen und deren Id.
Ersetze in allen Beispielen Platzhalter wie <projectId>, <clusterName> und <username> durch deine tatsächlichen Projekt-, Cluster- oder Nutzernamen bzw. Kennungen.
Projekte aktualisieren
Um Projekteinstellungen zu aktualisieren, verwende:
atlas projects update <projectId> [options]
Zum Beispiel kannst du mit dem Flag --name den Projektnamen ändern:
atlas projects update <projectId> --name newProjectName
Projekte auflisten
Um alle Projekte in deiner Organisation aufzulisten, verwende:
atlas projects list [options]
Dabei kannst du mit dem Flag --orgId steuern, aus welcher Organisation Projekte angezeigt werden:
atlas projects list --orgId <organizationId>
Außerdem kannst du das Ausgabeformat steuern, etwa die Anzeige als JSON:
atlas projects list --output json
Projekte löschen
Ein Projekt kannst du mit einem Atlas CLI Befehl löschen.
atlas projects delete <projectId> --orgId <organizationId>
Ein Projekt mit aktiven Clustern lässt sich nicht löschen. Lösche daher vorab alle enthaltenen Cluster.
Cluster verwalten
Cluster sind Gruppen von MongoDB-Servern, die deine Daten speichern. Atlas kümmert sich um Infrastruktur, Replikation und Backups deiner Cluster.
Cluster erstellen
Um einen neuen Cluster zu erstellen, führe aus:
atlas clusters create <clusterName> [options]
[options] umfasst Flags für die Clusterkonfiguration. Du kannst zum Beispiel Cloud-Provider, Region und MongoDB-Preisstufe angeben:
atlas clusters create myCluster --provider AWS --region US_EAST_1 --tier M0
Das Flag --provider legt den Cloud-Provider fest, etwa AWS, GCP oder Azure. --region gibt die Region an, in der der Cluster bereitgestellt wird. --tier definiert die Clustergröße.
Wenn du kein Standardprojekt gesetzt hast, füge das Flag --projectId hinzu:
atlas clusters create myCluster --projectId <projectId> --provider AWS --region US_EAST_1 --tier M0
Cluster beschreiben
Um Details zu einem bestimmten Cluster anzuzeigen, führe aus:
atlas clusters describe <clusterName> --projectId <projectId>
Dieser Befehl zeigt Konfiguration, Größe, Region und Verbindungsstrings des Clusters an.
Cluster auflisten
Um alle Cluster in deinem Projekt aufzulisten, führe aus:
atlas clusters list --projectId <projectId>
Das Flag --projectId ist erforderlich, sofern du nicht zuvor ein Standardprojekt gesetzt hast mit:
atlas config set project_id <projectId>
Cluster pausieren
Du kannst einen Cluster vorübergehend pausieren, ohne ihn zu löschen. Dadurch werden die Vorgänge gestoppt, Daten und Konfiguration bleiben jedoch erhalten:
atlas clusters pause <clusterName> --projectId <projectId>
Cluster löschen
Um einen Cluster dauerhaft zu löschen, führe aus:
atlas clusters delete <clusterName> --projectId <projectId>
Nachdem du deinen Cluster erstellt hast, musst du die Netzwerksicherheit konfigurieren, bevor du dich verbinden kannst.
IP-Zugriffsliste verwalten
Eine IP-Zugriffsliste steuert, welche IP-Adressen eine Verbindung zu deinen MongoDB Atlas Clustern herstellen dürfen. Jedes Projekt kann bis zu 200 Einträge in der IP-Zugriffsliste haben. Du kannst einzelne IP-Adressen, CIDR-Notationen oder AWS Security Group IDs hinzufügen. Ein CIDR-Block definiert einen Adressbereich anhand einer Basis-IP und eines Präfixes—zum Beispiel 192.168.0.0/24. Eine AWS Security Group ID erlaubt den Zugriff für alle Ressourcen innerhalb der angegebenen AWS Security Group.
Zum Verwalten der IP-Zugriffslisten benötigst du die Rolle Project Owner im Projekt.
IP-Adressen zur Zugriffsliste hinzufügen
Um deine aktuelle IP-Adresse zur Zugriffsliste hinzuzufügen, führe aus:
atlas accessLists create --currentIp --projectId <projectId>
Das Flag --currentIp fügt automatisch die IP der Maschine hinzu, auf der du den Befehl ausführst. Das ist praktisch, wenn du schnell von deinem Entwicklungsrechner aus zugreifen möchtest.
Um eine bestimmte IP-Adresse hinzuzufügen, führe aus:
atlas accessLists create <ipAddress> --type ipAddress --projectId <projectId>
<ipAddress> ist die zu erlaubende IP-Adresse. Zum Beispiel:
atlas accessLists create 192.0.2.15 --type ipAddress --comment "Office network" --projectId <projectId>
Mit dem Flag --comment fügst du eine Beschreibung hinzu, um den Eintrag später leichter zuzuordnen.
Um einen IP-Adressbereich per CIDR-Notation hinzuzufügen, führe aus:
atlas accessLists create <cidrBlock> --type cidrBlock --projectId <projectId>
Zum Beispiel:
atlas accessLists create 73.231.201.0/24 --type cidrBlock --comment "Development servers" --projectId <projectId>
Temporäre Zugriffseinträge anlegen
Um eine IP-Adresse mit automatischem Ablauf hinzuzufügen, nutze das Flag --deleteAfter. Du kannst ein Ablaufdatum bis zu sieben Tage in der Zukunft setzen:
atlas accessLists create <ipAddress> --type ipAddress --deleteAfter <isoDateTime> --projectId <projectId>
Das Flag --deleteAfter akzeptiert ein Datum im ISO-8601-Format. Zum Beispiel:
atlas accessLists create 192.0.2.20 --type ipAddress --deleteAfter 2025-12-31T23:59:59Z --comment "Temporary contractor access" --projectId <projectId>
MongoDB Atlas entfernt den Eintrag automatisch nach dem angegebenen Datum und der Uhrzeit.
Einträge der IP-Zugriffsliste anzeigen
Um alle Einträge der IP-Zugriffsliste deines Projekts anzuzeigen, führe aus:
atlas accessLists list --projectId <projectId>
Um Details zu einem bestimmten Eintrag anzuzeigen, führe aus:
atlas accessLists describe <entry> --projectId <projectId>
<entry> ist die IP-Adresse, der CIDR-Block oder die AWS Security Group ID, die du anzeigen möchtest.
Einträge aus der IP-Zugriffsliste löschen
Um einen Eintrag aus der Zugriffsliste zu entfernen, führe aus:
atlas accessLists delete <entry> --projectId <projectId>
Nutzende und Rollen verwalten
Eine Rolle gewährt Berechtigungen für Gruppen von Aktionen auf bestimmten Ressourcen. Ein User ist eine Entität, der eine oder mehrere Rollen zugewiesen werden, die steuern, worauf sie in der Datenbank zugreifen kann.
Um Datenbanknutzende und -rollen zu konfigurieren, benötigst du in MongoDB Atlas die Rolle Organization Owner, Project Owner oder Project Database Access Admin.
Nutzende verwalten
Um eine:n Datenbankuser:in zu erstellen, führe aus:
atlas dbusers create [builtInRole] [options]
[builtInRole] ist eine oder mehrere vordefinierte Rollen, die der Person zugewiesen werden. [options] enthält Flags für Anmeldedaten und Konfiguration. Zum Beispiel:
atlas dbusers create --username myUser --password myPassword --role readWriteAnyDatabase --projectId <projectId>
Das Flag --username legt den Benutzernamen fest. --password legt das Passwort fest. --role bestimmt die zuzuweisende Rolle. In diesem Fall ist der Benutzername myUser, das Passwort myPassword.
Um alle Datenbankuser in deinem Projekt aufzulisten, führe aus:
atlas dbusers list --projectId <projectId>
Um Details zu einem bestimmten Datenbankuser anzuzeigen, führe aus:
atlas dbusers describe <username> --projectId <projectId>
Du kannst den Datenbankuser auch aktualisieren. Um zum Beispiel das Passwort zu ändern, führe aus:
atlas dbusers update myUser --password newPassword --projectId <projectId>
Um die Rollen eines Users zu aktualisieren, führe aus:
atlas dbusers update myUser --role readWriteAnyDatabase --role dbAdmin --projectId <projectId>
Um einen bestimmten Datenbankuser zu löschen, führe aus:
atlas dbusers delete <username> --projectId <projectId>
Rollen verwalten
Es gibt zwei Kategorien von Rollen, die du einem User zuweisen kannst:
- Vordefinierte Rollen
- Benutzerdefinierte Rollen
Vordefinierte Rollen
Vordefinierte Rollen stellt MongoDB Atlas bereit. Sie enthalten gängige Berechtigungssätze für typische Datenbankeinsätze, zum Beispiel:
- read: Gewährt Nur-Lese-Zugriff auf eine bestimmte Datenbank.
- readWrite: Ermöglicht Lesen und Ändern von Daten in einer bestimmten Datenbank.
- readAnyDatabase: Gewährt Nur-Lese-Zugriff auf alle Datenbanken außer
localundconfig. - readWriteAnyDatabase: Gewährt Lese- und Schreibzugriff auf alle Datenbanken.
- dbAdmin: Bietet administrative Berechtigungen für eine bestimmte Datenbank, z. B. Indexe erstellen oder Statistiken einsehen.
- dbAdminAnyDatabase: Gewährt administrative Berechtigungen für alle Datenbanken.
- clusterAdmin: Ermöglicht die Verwaltung des gesamten Clusters, einschließlich Replikation und Sharding.
- userAdminAnyDatabase: Ermöglicht das Erstellen und Ändern von Nutzenden und Rollen in allen Datenbanken.
Vordefinierte Rollen kannst du nicht bearbeiten oder löschen. Du kannst sie nur zuweisen. Um vordefinierte Rollen beim Erstellen von Usern zu vergeben, gib die Rolle mit dem Flag --role an:
atlas dbusers create --username app-reader --password myPassword --role readAnyDatabase --projectId <projectId>
Um die Rolle eines bestehenden Users zuzuweisen oder zu ändern, führe aus:
atlas dbusers update app-reader --role readWriteAnyDatabase --projectId <projectId>
Weitere vordefinierte Rollen findest du unter [Built-In Roles and Privileges](https://www.mongodb.com/docs/atlas/mongodb-users-roles-and-privileges/?utm_campaign=devrel&utm_source=third-party-content&utm_medium=cta&utm_content=atlas-cli-datacamp&utm_term=megan.grant).
Benutzerdefinierte Rollen
Wenn vordefinierte Rollen nicht passen, kannst du in MongoDB Atlas benutzerdefinierte Rollen erstellen. Eine benutzerdefinierte Rolle definiert genau die Berechtigungsaktionen, die zu den Anforderungen deiner Anwendung oder deines Teams passen.
Lege bei der Erstellung fest, auf welche Collections die Nutzenden zugreifen dürfen und welche Aktionen auf Ressourcen erlaubt sind—zum Beispiel Lesen, Einfügen, Aktualisieren oder Löschen von Daten.
In MongoDB-Berechtigungsdefinitionen musst du in der CLI den Privilege-Action-Namen in Großbuchstaben verwenden, z. B. FIND statt find. Siehe Privilege Actions für weitere definierte Aktionen, die ein User auf einer Ressource ausführen kann.
Benutzerdefinierte Rollen kannst du mit der Atlas CLI verwalten.
Um eine benutzerdefinierte Rolle zu erstellen, führe aus:
atlas customDbRoles create <roleName> [options]
<roleName> ist der Name der neuen Rolle. [options] enthält Flags für die Berechtigungen—zum Beispiel:
atlas customDbRoles create customAnalyticsRole --privilege FIND@myDatabase.users
Im obigen Befehl gilt:
customAnalyticsRoleist der Name der neuen Rolle. Wähle einen aussagekräftigen Namen, der den Zweck widerspiegelt.- Das Flag
--privilegelegt fest, welche Aktionen auf welchen Ressourcen die Rolle ausführen darf. - Das Format ist
action@database.collection, wobei@Aktion und Ressource trennt. FINDist eine von MongoDB anerkannte Berechtigungsaktion.myDatabase.usersist die Ressource, auf die sich die Berechtigung bezieht—hier die Collectionusersin der DatenbankmyDatabase.
Um Details zu benutzerdefinierten Rollen anzuzeigen, führe aus:
atlas customDbRoles list --projectId <projectId>
Der Befehl zeigt alle benutzerdefinierten Rollen und deren Berechtigungen.
Um eine benutzerdefinierte Rolle zu aktualisieren, führe aus:
atlas customDbRoles update <roleName> [options]
[options] enthält, was aktualisiert werden soll. Um zum Beispiel einer bestehenden Rolle neue Berechtigungen hinzuzufügen, führe aus:
atlas customDbRoles update customAnalyticsRole --privilege FIND@myDatabase.analytics --privilege INSERT@myDatabase.logs --projectId <projectId>
Der Befehl erweitert die bestehende customAnalyticsRole um zusätzliche Berechtigungen. FIND@myDatabase.analytics erlaubt das Lesen aus der Collection analytics, und INSERT@myDatabase.logs erlaubt das Hinzufügen von Dokumenten zur Collection logs in der Datenbank myDatabase.
Mit dem Flag --projectId gibst du an, zu welchem MongoDB Atlas Projekt die Rolle gehört.
Um eine benutzerdefinierte Rolle zu löschen, führe aus:
atlas customDbRoles delete <roleName> --projectId <projectId>
Das Zuweisen einer benutzerdefinierten Rolle zu einem User funktioniert wie bei vordefinierten Rollen. Nutze das Flag --role mit atlas dbusers create oder atlas dbusers update:
atlas dbusers create --username analytics-user --password myPassword --role customAnalyticsRole --projectId <projectId>
Nachdem du Datenbanknutzende erstellt und Rollen zugewiesen hast, kannst du dich mit deinem Cluster verbinden.
Verbindungsstrings abrufen
Ein Verbindungsstring enthält die Informationen, die deine Anwendungen zum Verbinden mit deinem Atlas-Cluster benötigen. Er umfasst Hostname, Authentifizierungsdatenbank und Verbindungsoptionen.
Bevor du einen Verbindungsstring nutzt, stelle sicher, dass du die IP-Zugriffsliste konfiguriert und mindestens einen Datenbankuser angelegt hast.
Verbindungsstring für einen Cluster abrufen
Um den Verbindungsstring eines Clusters zu erhalten, führe aus:
atlas clusters connectionStrings describe <clusterName> --projectId <projectId>
Dieser Befehl gibt den SRV-Verbindungsstring für deinen Cluster zurück.
Formate von Verbindungsstrings
MongoDB Atlas stellt zwei Typen von Verbindungsstrings bereit:
Standard-Verbindungsstring (mongodb://): Listet alle Clusterknoten explizit auf. Verwende dieses Format, wenn du einzelne Serveradressen angeben musst.
SRV-Verbindungsstring (mongodb+srv://): Nutzt DNS, um Clusterinformationen automatisch abzurufen. Dieses Format wird empfohlen, da es sich automatisch aktualisiert, wenn sich die Clusterkonfiguration ändert.
Verbindungsstring verwenden
Ersetze <username> und <password> im Verbindungsstring durch die Zugangsdaten deines Datenbankusers:
mongodb+srv://<username>:<password>@cluster0.example.mongodb.net/
Wenn dein Benutzername zum Beispiel appUser und dein Passwort securePass123 ist:
mongodb+srv://appUser:securePass123@cluster0.example.mongodb.net/
Diesen Verbindungsstring kannst du dann mit MongoDB Treibern, der MongoDB Shell oder anderen MongoDB-Tools nutzen, um dich mit deinem Cluster zu verbinden.
Backups verwalten
Backups sind Kopien deiner Datenbankdaten, mit denen du deinen Cluster wiederherstellen kannst, wenn Daten verloren gehen oder beschädigt werden. Atlas erstellt automatisch regelmäßige Backups.
Automatische Continuous Backups sind nur für dedizierte M10+-Cluster verfügbar. M0 Free-Tier-Cluster haben keine Backup-Funktion. M2/M5 Shared-Cluster verfügen über grundlegende Cloud-Backups, jedoch nicht über Continuous Backup. Weitere Informationen findest du unter [Snapshots for Flex Clusters](https://www.mongodb.com/docs/atlas/backup-restore-cluster/?utm_campaign=devrel&utm_source=third-party-content&utm_medium=cta&utm_content=atlas-cli-datacamp&utm_term=megan.grant#snapshots-for-flex-clusters).
Zum Verwalten von Backups benötigst du in Atlas die Rolle Organization Owner oder Project Owner.
Manuelle Backups erstellen
Um sofort ein Backup zu erstellen, führe aus:
atlas backups snapshots create <clusterName> --desc "Backup description" --projectId <projectId>
Im obigen Befehl ist --desc ein erforderliches Flag zur Beschreibung des Snapshots.
Verfügbare Backups auflisten
Um alle Backups eines Clusters aufzulisten, führe aus:
atlas backups snapshots list <clusterName> --projectId <projectId>
Backup-Konfigurationen anzeigen
Um die Backup-Einstellungen eines Clusters anzuzeigen, führe aus:
atlas backups schedule describe <clusterName> --projectId <projectId>
Aus Backups wiederherstellen
Um Daten aus einem Backup wiederherzustellen, führe aus:
atlas backups restores start <clusterName> --snapshotId <snapshotId> --targetClusterName <targetClusterName> --projectId <projectId>
Mit dem Flag --snapshotId gibst du an, welches Backup wiederhergestellt werden soll. Mit --targetClusterName legst du den Namen des Clusters fest, in den wiederhergestellt wird—zum Beispiel:
atlas backups restores start myCluster --snapshotId 5f8e8d9a1b2c3d4e5f6g7h8i --targetClusterName myCluster-restored --projectId <projectId>
Backups löschen
Um ein Backup zu löschen, führe aus:
atlas backups snapshots delete <snapshotId> --projectId <projectId>
Fazit
In diesem Artikel hast du den Aufbau der CLI-Befehle kennengelernt, Bereitstellungen erstellt, Projekte und Cluster verwaltet, Nutzende und Rollen konfiguriert sowie Backups gemanagt. Du kannst diese Schritte in Skripten kombinieren und so Abläufe automatisieren—das erleichtert die Verwaltung mehrerer Umgebungen und die Integration des Datenbankmanagements in deinen Entwicklungsworkflow.
FAQs
Muss ich mich bei jeder Nutzung der MongoDB Atlas CLI erneut authentifizieren?
Nein. Die CLI speichert deine Sitzung, nachdem du atlas auth login ausgeführt hast. Aus Sicherheitsgründen laufen Sitzungen jedoch regelmäßig ab. Du musst dich nur erneut authentifizieren, wenn die Meldung "Session expired" erscheint.
Kann ich die Atlas CLI mit Free-Tier-(M0)-Clustern verwenden?
Ja, du kannst Free-Tier-Cluster mit der MongoDB Atlas CLI für die meisten Aufgaben verwalten, etwa das Erstellen von Usern, das Vergeben von Rollen und die Clusterkonfiguration. Backup-Operationen stehen jedoch für Free- oder Shared-Tier-Cluster nicht zur Verfügung.
Worin unterscheiden sich MongoDB Atlas User-Rollen und Datenbankrollen?
Atlas-User-Rollen (wie Organization Owner, Project Owner und Project Cluster Manager) steuern, wer die MongoDB Atlas Plattform selbst über UI, CLI oder API verwalten darf. Datenbankrollen (wie read, readWrite und benutzerdefinierte Rollen) steuern, was Datenbanknutzende tun dürfen, wenn sie sich mit MongoDB-Datenbanken verbinden. Du benötigst passende Atlas-User-Rollen, um Datenbankrollen zu erstellen und sie Datenbanknutzenden zuzuweisen.
Kann ich mehrere MongoDB Atlas Projekte mit derselben CLI-Installation verwalten?
Ja, du kannst mehrere Projekte mit einer einzigen CLI-Installation verwalten. Du kannst entweder beim Anmelden ein Standardprojekt festlegen oder das zu verwendende Projekt per --projectId Flag in deinen Befehlen angeben. Für die Arbeit mit mehreren Organisationen verwende das Flag --orgId. Du kannst alle Projekte mit atlas projects list und alle Organisationen mit atlas organizations list auflisten.
Wie finde ich meine Organization ID und Project ID?
Führe atlas organizations list aus, um alle Organisationen und deren IDs zu sehen. Führe atlas projects list aus, um alle Projekte und deren IDs zu sehen.
