Connexion à un Serveur Dolt

1. Démarrez votre serveur Dolt

cd ~/Projects/myproject
dolt sql-server

Dolt écoute sur le port 3307 par défaut.

2. Ouvrez Beadbox

Dans le sélecteur de workspace, cliquez sur Ajouter par serveur (ou trouvez la carte Avancé sur l'écran d'accueil s'il s'agit de votre premier lancement).

3. Entrez les détails de connexion

4. Cliquez sur "Découvrir les Bases de Données"

Beadbox se connecte au serveur et exécute SHOW DATABASES pour trouver toutes les bases de données correspondant au patron beads_*.

5. Sélectionnez les bases de données

L'écran de découverte liste toutes les bases de données beads trouvées sur le serveur. Cochez celles que vous souhaitez ajouter comme workspaces. Chacune reçoit un chemin de répertoire local.

6. Cliquez sur "Ajouter les Workspaces"

Beadbox crée le répertoire local .beads/ avec un metadata.json pointant vers votre serveur, enregistre le workspace et l'ouvre.

1. Écrit les métadonnées de connexion

Il crée un .beads/metadata.json dans le répertoire local du projet avec les détails de connexion au serveur :

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

Quand TLS est activé, une clé "dolt_server_tls": true est ajoutée. Ce fichier indique à bd de se connecter à un serveur distant au lieu d'utiliser une base de données locale embarquée. Le mot de passe est intentionnellement absent de ce fichier.

2. Enregistre le workspace

Le répertoire local est ajouté au ~/.beads/registry.json pour que Beadbox et bd puissent le retrouver aux prochains lancements.

3. Transmet les identifiants à l'exécution

Chaque fois que Beadbox invoque une commande bd pour ce workspace, il définit BEADS_DOLT_PASSWORD dans l'environnement du sous-processus. Le mot de passe n'existe qu'en mémoire du processus.

Connexion refusée

Error: connect ECONNREFUSED 127.0.0.1:3307

• Dolt est-il en marche ? Vérifiez avec ps aux | grep dolt ou essayez dolt sql-server dans le répertoire du projet.
• Bon port ? Dolt utilise le port 3307 par défaut, mais vous avez peut-être configuré un port différent.
• Pare-feu ? Sur les serveurs distants, assurez-vous que le port est ouvert pour les connexions entrantes.

Accès refusé

Error: Access denied for user 'root'

• Mot de passe requis ? Votre serveur Dolt a peut-être l'authentification activée. Entrez le mot de passe dans le formulaire de connexion.
• Mauvais utilisateur ? Vérifiez que le nom d'utilisateur correspond à un utilisateur Dolt avec un accès en lecture.
• Mauvais mot de passe ? Les mots de passe ne sont pas sauvegardés entre les sessions. Ressaisissez-le après avoir redémarré Beadbox.

Échec du handshake TLS

Error: TLS handshake failed

• Incohérence de la case TLS. Si le serveur requiert TLS, cochez "Utiliser TLS". S'il ne supporte pas TLS, décochez-la. Une erreur dans un sens ou dans l'autre provoque un échec du handshake.
• Certificats auto-signés. Si votre serveur Dolt utilise un certificat auto-signé, vous devrez peut-être ajouter l'autorité de certification au magasin de confiance de votre système. Le CLI bd utilise le pool d'autorités racines du système et rejettera les certificats non approuvés.

Aucune base de données trouvée

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

• Convention de nommage. Beadbox ne découvre que les bases de données dont le nom commence par beads_. Si votre base porte un autre nom, renommez-la ou créez-en une nouvelle avec bd init en mode Dolt.
• La base existe mais n'est pas visible ? Le compte utilisateur n'a peut-être pas la permission de voir toutes les bases de données.
• Serveur tout neuf ? Si vous venez de démarrer Dolt sans initialiser beads, il n'y a pas encore de bases de données beads. Exécutez bd init dans un répertoire de projet avec le mode Dolt configuré, puis relancez la découverte.