Gestire il server locale
Usayarn twenty docker:* per controllare il container Twenty locale:
I dati persistono tra i riavvii in due volumi Docker (
twenty-app-dev-data per PostgreSQL, twenty-app-dev-storage per i file). Usa reset per cancellare tutto.
Blocco della versione del server
Quando non viene passata alcuna versione,docker:start risolve la versione dall’intervallo engines.twenty della tua app in package.json, lo stesso intervallo rispetto al quale il server effettua la convalida quando la tua app viene installata. Avvia l’immagine twenty-app-dev più recente pubblicata che soddisfa l’intervallo, ricorrendo a latest quando il campo è assente o nessuna versione pubblicata corrisponde:
yarn twenty docker:start 2.3.0. Se un container esiste già con una versione diversa, docker:start lo aggiorna sul posto (ricreando il container ma preservando i volumi dei tuoi dati).
Aggiornamento dell’immagine del server
yarn twenty docker:upgrade scarica l’ultima immagine, confronta i digest e ricrea il container solo se è cambiato qualcosa. I volumi vengono preservati — viene sostituito solo il container. Se è stata scaricata una nuova immagine e il container era in esecuzione, l’upgrade avvia automaticamente un nuovo container; esegui poi yarn twenty docker:start per attendere che diventi operativo.
yarn twenty docker:status (mostra APP_VERSION incorporata nel container).
Esecuzione di un’istanza di test parallela
Passa--test a qualsiasi comando docker:* per gestire una seconda istanza completamente isolata — utile per test di integrazione o per sperimentare senza toccare i tuoi dati di sviluppo principali:
L’istanza di test ha il proprio container (
twenty-app-dev-test), i propri volumi (twenty-app-dev-test-data, twenty-app-dev-test-storage) e la propria configurazione — viene eseguita insieme alla tua istanza principale senza conflitti. Combina --test con --port per sovrascrivere 2021.
Configurazione manuale (senza lo scaffolder)
Salta lo strumento di scaffolding se stai aggiungendo l’SDK a un progetto esistente:package.json:
yarn twenty dev, yarn twenty docker:start e il resto.
Non installare
twenty-sdk globalmente — bloccalo per progetto in modo che ogni app usi la propria versione.