Zum Hauptinhalt springen

MongoDB Atlas CLI: Datenbanken über die Kommandozeile verwalten

Die MongoDB Atlas CLI ist eine schnellere Alternative zur Weboberfläche. Du führst Verwaltungsaufgaben direkt im Terminal aus und kannst sie automatisieren.
· 12 Min. lesen

Entdecke KI

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 [email protected].

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 local und config.
  • 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 [email protected]

Im obigen Befehl gilt:

  • customAnalyticsRole ist der Name der neuen Rolle. Wähle einen aussagekräftigen Namen, der den Zweck widerspiegelt.
  • Das Flag --privilege legt fest, welche Aktionen auf welchen Ressourcen die Rolle ausführen darf.
  • Das Format ist [email protected], wobei @ Aktion und Ressource trennt.
  • FIND ist eine von MongoDB anerkannte Berechtigungsaktion.
  • myDatabase.users ist die Ressource, auf die sich die Berechtigung bezieht—hier die Collection users in der Datenbank myDatabase.

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 [email protected] --privilege [email protected] --projectId <projectId>

Der Befehl erweitert die bestehende customAnalyticsRole um zusätzliche Berechtigungen. [email protected] erlaubt das Lesen aus der Collection analytics, und [email protected] 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:[email protected]/

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.

Damilola Oladele

Autor

Damilola Oladele

Themen

MongoDB

Ähnlich

Tutorial

Python Datenstrukturen Tutorial

Tutorial

Ein Leitfaden zu Python-Hashmaps

Mehr anzeigen →