Verbindung mit einem Dolt-Server

1. Dolt-Server starten

cd ~/Projects/myproject
dolt sql-server

Dolt lauscht standardmäßig auf Port 3307.

2. Beadbox öffnen

Klicken Sie in der Workspace-Auswahl auf Per Server hinzufügen (oder finden Sie die Erweitert-Karte auf dem Willkommensbildschirm bei Ihrem ersten Start).

3. Verbindungsdetails eingeben

4. Auf "Datenbanken ermitteln" klicken

Beadbox verbindet sich mit dem Server und führt SHOW DATABASES aus, um alle Datenbanken mit dem Muster beads_* zu finden.

5. Datenbanken auswählen

Der Ermittlungsbildschirm listet jede gefundene beads-Datenbank auf dem Server auf. Markieren Sie diejenigen, die Sie als Workspaces hinzufügen möchten. Jede erhält einen lokalen Verzeichnispfad.

6. Auf "Workspaces hinzufügen" klicken

Beadbox erstellt das lokale .beads/-Verzeichnis mit einer metadata.json, die auf Ihren Server verweist, registriert den Workspace und öffnet ihn.

1. Verbindungsmetadaten schreiben

Es erstellt eine .beads/metadata.json im lokalen Projektverzeichnis mit den Server-Verbindungsdetails:

{
  "dolt_mode": "server",
  "dolt_server_host": "127.0.0.1",
  "dolt_server_port": 3307,
  "dolt_database": "beads_myproject",
  "dolt_server_user": "root",
  "database": "dolt"
}

Bei aktiviertem TLS wird ein Schlüssel "dolt_server_tls": true hinzugefügt. Diese Datei weist bd an, sich mit einem Remote-Server zu verbinden, anstatt eine lokale eingebettete Datenbank zu verwenden. Das Passwort fehlt absichtlich in dieser Datei.

2. Workspace registrieren

Das lokale Verzeichnis wird in ~/.beads/registry.json eingetragen, damit Beadbox und bd es bei zukünftigen Starts finden können.

3. Zugangsdaten zur Laufzeit übergeben

Jedes Mal, wenn Beadbox einen bd-Befehl für diesen Workspace aufruft, setzt es BEADS_DOLT_PASSWORD in der Subprozess-Umgebung. Das Passwort existiert nur im Prozessspeicher.

Verbindung abgelehnt

Error: connect ECONNREFUSED 127.0.0.1:3307

• Läuft Dolt? Prüfen Sie mit ps aux | grep dolt oder versuchen Sie dolt sql-server im Projektverzeichnis.
• Richtiger Port? Dolt verwendet standardmäßig 3307, aber Sie haben möglicherweise einen anderen Port konfiguriert.
• Firewall? Stellen Sie bei Remote-Servern sicher, dass der Port für eingehende Verbindungen geöffnet ist.

Zugriff verweigert

Error: Access denied for user 'root'

• Passwort erforderlich? Ihr Dolt-Server hat möglicherweise Authentifizierung aktiviert. Geben Sie das Passwort im Verbindungsformular ein.
• Falscher Benutzer? Überprüfen Sie, ob der Benutzername einem Dolt-Benutzer mit Lesezugriff entspricht.
• Falsches Passwort? Passwörter werden zwischen Sitzungen nicht gespeichert. Geben Sie es nach einem Neustart von Beadbox erneut ein.

TLS-Handshake fehlgeschlagen

Error: TLS handshake failed

• TLS-Kontrollkästchen stimmt nicht überein. Falls der Server TLS erfordert, aktivieren Sie "TLS verwenden". Falls er kein TLS unterstützt, deaktivieren Sie es. Eine falsche Einstellung in beide Richtungen verursacht einen Handshake-Fehler.
• Selbstsignierte Zertifikate. Falls Ihr Dolt-Server ein selbstsigniertes Zertifikat verwendet, müssen Sie die CA möglicherweise in Ihren System-Vertrauensspeicher aufnehmen. Das bd CLI verwendet den System-Root-CA-Pool und lehnt nicht vertrauenswürdige Zertifikate ab.

Keine Datenbanken gefunden

No beads databases found on 127.0.0.1:3307.
Databases must follow the beads_* naming pattern.

• Namenskonvention. Beadbox erkennt nur Datenbanken, deren Namen mit beads_ beginnen. Falls Ihre Datenbank anders benannt ist, benennen Sie sie um oder erstellen Sie eine neue mit bd init im Dolt-Modus.
• Datenbank vorhanden, aber nicht sichtbar? Das Benutzerkonto hat möglicherweise keine Berechtigung, alle Datenbanken zu sehen.
• Frischer Server? Falls Sie Dolt gerade erst ohne beads-Initialisierung gestartet haben, gibt es noch keine beads-Datenbanken. Führen Sie bd init in einem Projektverzeichnis mit konfiguriertem Dolt-Modus aus und versuchen Sie die Erkennung erneut.