Einführung
Dieses Spickzettel bietet einen kurzen Überblick über gängige Mutagen-Befehle, -Flags und -Workflows, damit Sie die Dateisynchronisation in Ihrer Entwicklungsumgebung effizient verwalten können.
Grundlegende Befehle
Installation
Befehl (macOS mit Homebrew):
brew install mutagen-io/mutagen/mutagen
Beschreibung:
Installiert Mutagen auf macOS über Homebrew. Für andere Plattformen lesen Sie bitte die entsprechenden Installationsanweisungen in unseren Tutorials.
Installation und Version prüfen
Bash-Befehl zur Überprüfung der Version:
mutagen version
Beschreibung:
Zeigt die aktuell installierte Mutagen-Version an, um zu überprüfen, ob die Installation erfolgreich war.
Verwaltung von Sync-Sitzungen
Eine Sync-Sitzung erstellen
Befehl Beispiel:
mutagen sync create --name my-sync-session --ignore "node_modules/**" /path/to/local docker://container-name/path/in/container
Schlüssel-Optionen:
--name
: Weist der Synchronisationssitzung einen eindeutigen Bezeichner zu.--ignore
: Schließt Dateien oder Verzeichnisse aus (nützlich, um unnötige Dateien zu ignorieren).- Ordnerpfade: Geben Sie den lokalen Quell- und Zielcontainerpfad an (verwenden Sie das Präfix
docker://
für Container-Endpunkte).
Aktive Sync-Sitzungen auflisten
Bash-Befehl:
mutagen sync list
Beschreibung:
Listet alle aktiven Synchronisationssitzungen und deren Status auf. Verwenden Sie dies, um Ihre laufenden Sitzungen zu überwachen.
Anhalten einer Sync-Sitzung
Bash-Befehl:
mutagen sync pause my-sync-session
Beschreibung:
Setzt die Synchronisation für die angegebene Sitzung vorübergehend aus, was bei Wartungsarbeiten nützlich ist.
Fortsetzen einer Sync-Sitzung
Bash-Befehl:
mutagen sync resume my-sync-session
Beschreibung:
Startet eine zuvor pausierte Sync-Sitzung neu.
Beenden einer Sync-Sitzung
Bash-Befehl:
mutagen sync terminate my-sync-session
Beschreibung:
Beendet und entfernt die angegebene Synchronisierungssitzung, so dass Sie bei Bedarf eine neue Sitzung starten können.
Erweiterte Optionen und Konfiguration
Übersicht der Sync-Modi
two-way-resolved
Modus (Standard): Synchronisiert Änderungen in beide Richtungen, ideal für kollaborative Arbeitsabläufe.one-way-safe
Modus: Überträgt Änderungen nur von der Quelle zum Ziel und schützt so die Quelldaten.one-way-replica
Modus: Spiegelt die Quelle exakt am Zielort, nützlich für Backups und die Bereitstellung.
Zusätzliche Flags
Festlegen des Sync-Modus:
--mode two-way-resolved
Mehrere Ignorieren-Muster:
mutagen sync create --name my-sync --ignore "node_modules/**" --ignore "*.log" /local/path docker://container/path
Daemon-Verwaltung:
mutagen daemon start
Stellen Sie sicher, dass der Mutagen-Daemon läuft, um die Synchronisierungsaufgaben zu verwalten.
Tipps zur Fehlerbehebung
Fehler bei doppelter Sitzung:
Wenn bereits eine Sitzung mit demselben Namen existiert, prüfen Sie mit:mutagen sync list
und beendet die doppelte Sitzung:
mutagen sync terminate <session-name>
Befehl wird nicht erkannt:
Wenn der Befehlmutagen
nicht gefunden wird, stellen Sie sicher, dass sich das Installationsverzeichnis im PATH Ihres Systems befindet.Log-Prüfungen:
Aktivieren Sie die detaillierte Protokollierung (weitere Informationen finden Sie in unserem Tutorial Installation und Konfiguration von Mutagen), um Probleme zu beheben.
Weiterführende Literatur
Weitere Artikel erkunden
Hier finden Sie weitere Artikel aus derselben Kategorie, die Ihnen helfen, tiefer in das Thema einzutauchen.
Wiederverwendung
Zitat
@online{kassambara2025,
author = {Kassambara, Alboukadel},
title = {Mutagen Spickzettel: Kurzreferenz für die
Dateisynchronisation},
date = {2025-03-09},
url = {https://www.datanovia.com/de/learn/tools/mutagen/cheatsheet.html},
langid = {de}
}