Connessione a un server Dolt

Beadbox può connettersi a un server SQL Dolt in esecuzione, offrendoti accesso multi-scrittura e flussi di lavoro di team sugli stessi database beads che usi dal CLI.

Richiede Beadbox 0.9.12+ Controlla la tua versione in Impostazioni > Informazioni o su /api/version.

Prerequisiti

Prima di iniziare, hai bisogno di tre cose in esecuzione:

Componente	Versione minima	Verifica
CLI beads (`bd`)	0.56.x+	`bd --version`
Server Dolt	In esecuzione e pronto per le connessioni	`dolt sql-server` nel tuo progetto
Beadbox	0.9.12+	Impostazioni > Informazioni

Il tuo server Dolt deve avere almeno un database che segua la convenzione di nomi beads_. Questo è ciò che beads crea quando esegui bd init con la modalità Dolt. Beadbox usa questo prefisso per scoprire i database beads e ignorare quelli non pertinenti.

Avvio rapido (locale, senza autenticazione)

Il percorso più veloce: un server Dolt sul tuo computer senza autenticazione configurata.

1. Avvia il tuo server Dolt

cd ~/Projects/myproject
dolt sql-server

Dolt ascolta sulla porta 3307 per impostazione predefinita.

2. Apri Beadbox

Nel selettore dei workspace, clicca su Aggiungi tramite server (oppure cerca la scheda Avanzate nella schermata di benvenuto se è il tuo primo avvio).

3. Inserisci i dettagli di connessione

Host	`127.0.0.1` (precompilato)
Porta	`3307` (precompilato)
Utente	`root` (precompilato)
Password	lascia vuoto
TLS	non selezionato

4. Clicca su "Scopri database"

Beadbox si connette al server ed esegue SHOW DATABASES per trovare tutti i database corrispondenti al pattern beads_*.

5. Seleziona i database

La schermata di scoperta elenca ogni database beads trovato sul server. Seleziona quelli che vuoi aggiungere come workspace. Ognuno ottiene un percorso di directory locale.

6. Clicca su "Aggiungi Workspace"

Beadbox crea la directory locale .beads/ con un metadata.json che punta al tuo server, registra il workspace e lo apre.

Sei connesso. Le modifiche effettuate tramite bd nel CLI o da altri membri del team che scrivono sullo stesso server Dolt appariranno in Beadbox entro pochi secondi (la modalità server interroga le modifiche a intervalli di 1 secondo).

Connessione con autenticazione

Se il tuo server Dolt richiede nome utente e password:

Segui gli stessi passaggi dell'Avvio rapido, ma compila i campi Utente e Password con le credenziali del tuo server Dolt.
Se è richiesto TLS (comune per i server remoti), seleziona la casella Usa TLS.
Clicca su Scopri database e procedi con la scoperta.

Come vengono gestite le password

Le password sono conservate solo in memoria. Beadbox non scrive mai la tua password su disco.
Quando Beadbox si riavvia, la password viene persa. Per evitare di reinserirla ad ogni avvio, imposta BEADS_DOLT_PASSWORD nel tuo profilo di shell (vedi Salvare la password).
Internamente, Beadbox passa la password al CLI bd tramite la variabile d'ambiente BEADS_DOLT_PASSWORD ad ogni invocazione di sottoprocesso.

Dolt ospitato e server remoti

Per server Dolt in esecuzione su una macchina remota, una VM cloud o Hosted Dolt:

Host: Inserisci il nome host o l'IP del tuo server.
Porta: Usa la porta specificata dal tuo provider. Hosted Dolt usa tipicamente la 3306.
Utente/Password: Inserisci le credenziali fornite dal tuo provider.
TLS: Seleziona "Usa TLS" (richiesto per Hosted Dolt e consigliato per qualsiasi connessione remota).
Clicca su Scopri database e procedi normalmente.

Salvare la password

Beadbox conserva le password solo in memoria, quindi vengono perse al riavvio. Per qualsiasi server che richiede autenticazione (locale o remoto), puoi evitare di reinserire la password impostandola nel tuo profilo di shell:

export BEADS_DOLT_PASSWORD="your-password-here"

Beadbox la rileva automaticamente per tutti i workspace in modalità server. Il campo password dell'interfaccia ha la precedenza se entrambi sono configurati.

Come funziona

Quando aggiungi un workspace server, Beadbox fa tre cose:

1. Scrive i metadati di connessione

Crea un .beads/metadata.json nella directory locale del progetto con i dettagli di connessione al server:

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

Quando TLS è abilitato, viene aggiunta una chiave "dolt_server_tls": true. Questo file indica a bd di connettersi a un server remoto invece di usare un database locale integrato. La password è intenzionalmente assente da questo file.

2. Registra il workspace

La directory locale viene aggiunta a ~/.beads/registry.json così che Beadbox e bd possano trovarla ai futuri avvii.

3. Passa le credenziali a runtime

Ogni volta che Beadbox invoca un comando bd per questo workspace, imposta BEADS_DOLT_PASSWORD nell'ambiente del sottoprocesso. La password risiede solo nella memoria del processo.

Risoluzione dei problemi

Connessione rifiutata

Error: connect ECONNREFUSED 127.0.0.1:3307

Dolt è in esecuzione? Verifica con ps aux | grep dolt o prova dolt sql-server nella directory del progetto.
Porta corretta? Dolt usa la porta 3307 per impostazione predefinita, ma potresti aver configurato una porta diversa.
Firewall? Sui server remoti, assicurati che la porta sia aperta per le connessioni in entrata.

Accesso negato

Error: Access denied for user 'root'

Password richiesta? Il tuo server Dolt potrebbe avere l'autenticazione abilitata. Inserisci la password nel modulo di connessione.
Utente sbagliato? Verifica che il nome utente corrisponda a un utente Dolt con accesso in lettura.
Password sbagliata? Le password non vengono salvate tra le sessioni. Reinseriscila dopo aver riavviato Beadbox.

Errore nell'handshake TLS

Error: TLS handshake failed

Casella TLS non corretta. Se il server richiede TLS, seleziona "Usa TLS." Se non supporta TLS, deselezionalo. Avere questa impostazione sbagliata in entrambe le direzioni causa un errore di handshake.
Certificati autofirmati. Se il tuo server Dolt usa un certificato autofirmato, potresti dover aggiungere la CA all'archivio di fiducia del tuo sistema. Il CLI bd usa il pool di CA root del sistema e rifiuterà i certificati non attendibili.

Nessun database trovato

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

Convenzione di nomi. Beadbox scopre solo database i cui nomi iniziano con beads_. Se il tuo database ha un nome diverso, rinominalo o creane uno nuovo con bd init usando la modalità Dolt.
Il database esiste ma non è visibile? L'account utente potrebbe non avere il permesso di vedere tutti i database.
Server appena creato? Se hai appena avviato Dolt senza inizializzare beads, non ci sono ancora database beads. Esegui bd init in una directory di progetto con la modalità Dolt configurata, poi riprova la scoperta.