Vai al contenuto principale

Avvia Twenty in locale

Installa e avvia Docker, quindi esegui:
local start esegue l’interfaccia web, l’API, il worker e i database. Funziona al di fuori di una cartella dell’app, attende che l’ambiente sia pronto e stampa il relativo URL. L’accesso è un passaggio separato. Per installare successivamente la tua app, esegui twenty app apply --create --remote local dalla relativa directory. Per una nuova istanza, specifica esplicitamente una versione oppure lascia che la CLI selezioni la versione pubblicata più recente corrispondente a engines.twenty della tua app. Al di fuori di un’app con questa impostazione, usa latest. Le istanze esistenti mantengono la propria versione e i dati. Per un’istanza esistente, la compatibilità con engines.twenty viene verificata utilizzando APP_VERSION dell’immagine, anche quando il relativo tag è latest. Una versione mancante, non valida o incompatibile genera un avviso e l’avvio continua.
Le nuove istanze restano in ascolto solo su loopback, sulla porta 2020. Usa --port \<port> durante la creazione di un’istanza per scegliere un’altra porta. Usa un contesto socket Docker locale; i motori Docker remoti non sono supportati da questi comandi.

Aggiorna o reimposta

L’aggiornamento scarica l’immagine richiesta prima di sostituire l’istanza. Mantiene le porte, il database e i volumi di file, nonché le sostituzioni dell’ambiente. Le nuove impostazioni predefinite della CLI si applicano alle istanze create di recente; gli aggiornamenti mantengono i valori dell’ambiente esistenti. Senza una versione, segue la stessa selezione della versione di un nuovo avvio. I layout di archiviazione personalizzati vengono rifiutati. I downgrade vengono rifiutati prima di sostituire il contenitore, incluso quando si usa un tag come latest. Entrambe le immagini devono dichiarare un valore valido di APP_VERSION affinché la CLI possa confrontare le loro versioni effettive. Passa 2.53 per avviare o aggiornare usando il tag dell’immagine mobile v2.53, oppure 2.53.1 per selezionare una versione patch specifica. Se la creazione del sostituto non riesce o viene annullata, la CLI ripristina il contenitore e le impostazioni precedenti. Una volta avviata la nuova versione, gli aggiornamenti non riusciti mantengono i volumi di dati ma non annullano le migrazioni del database. stop conserva tutti i dati. Per eliminare definitivamente l’istanza e i relativi dati, esegui:
Reset richiede una conferma. Gli script devono passare --yes. I remoti salvati e le credenziali non vengono rimossi.

Test di integrazione

Usa l’istanza di test separata, porta predefinita 2021:
Imposta TWENTY_API_KEY su una chiave per quell’istanza. I test di integrazione installano e disinstallano un’app, quindi tienili separati dal tuo spazio di lavoro di sviluppo. Passa --test a logs, stop, upgrade o reset quando gestisci questa istanza. Il workflow CI generato effettua il provisioning di un’istanza isolata tramite twentyhq/twenty/.github/actions/spawn-twenty-app-dev-test@main e installa separatamente la CLI standalone.

Altre configurazioni locali

Per un checkout del codice sorgente di Twenty, funziona anche l’ambiente di sviluppo esistente:
Usa l’URL e la porta effettivi del tuo server. Per gli spazi di lavoro con sottodomini, usa il nome host dello spazio di lavoro. Per la distribuzione in produzione, segui la guida all’hosting autonomo.

Dipendenze del progetto

twenty app init dichiara twenty-sdk, twenty-client-sdk e twenty-ui in devDependencies, ma non li installa. Con la CLI twenty installata globalmente, esegui yarn install dalla directory dell’app generata prima di eseguire twenty app typecheck, twenty app build o twenty app apply.