Salt la conținutul principal

Porniți Twenty local

Instalați și porniți Docker, apoi rulați:
local start pornește interfața web, API-ul, workerul și bazele de date. Funcționează în afara unui director de aplicație, așteaptă ca mediul să fie gata și îi afișează URL-ul. Autentificarea este un pas separat. Pentru a instala ulterior aplicația, rulați twenty app apply --create --remote local din directorul acesteia. Pentru o instanță nouă, specificați explicit o versiune sau lăsați CLI-ul să selecteze cea mai mare versiune publicată care corespunde cu engines.twenty al aplicației. În afara unei aplicații cu această setare, utilizează latest. Instanțele existente își păstrează versiunea și datele. Pentru o instanță existentă, compatibilitatea cu engines.twenty este verificată folosind APP_VERSION al imaginii, inclusiv atunci când eticheta acesteia este latest. O versiune lipsă, nevalidă sau incompatibilă generează un avertisment, iar pornirea continuă.
Instanțele noi ascultă numai pe loopback, pe portul 2020. Utilizați --port \<port> când creați o instanță pentru a alege alt port. Utilizați un context local pentru socket Docker; motoarele Docker la distanță nu sunt acceptate de aceste comenzi.

Faceți upgrade sau resetați

Upgrade-ul extrage imaginea solicitată înainte de a înlocui instanța. Acesta păstrează porturile, baza de date și volumele de fișiere, precum și suprascrierile de mediu. Noi valori implicite ale CLI se aplică noilor instanțe; upgrade-urile păstrează valorile de mediu existente. Fără o versiune, urmează aceeași selecție de versiune ca un nou început. Depozitul personalizat este respins. Downgrade sunt respinse înainte de a înlocui containerul, inclusiv când se folosește o etichetă precum latest. Ambele imagini trebuie să declare un valid APP_VERSION astfel încât CLI să poată compara versiunile lor reale. Treceți 2.53 să începeți sau să faceți upgrade folosind eticheta de imagine v2.53 plutitoare, sau 2.53.1 pentru a selecta o versiune specifică a patch-ului. În cazul în care crearea înlocuirii eșuează sau este anulată, CLI restaurează containerul anterior și setările. Odată ce noua versiune începe, a eșuat actualizarea reține volumele de date dar nu redirecționează migrațiile bazei de date înapoi. stop păstrează toate datele. Pentru a șterge definitiv instanța și datele acesteia, executați:
Resetarea cere confirmare. Scripturile trebuie să treacă de --yes. Credențialele de la telecomenzi salvate și nu sunt șterse.

Teste de integrare

Utilizați instanța de test separată, cu portul implicit 2021:
Setați TWENTY_API_KEY la o cheie pentru acea instanță. Testele de integrare instalează și dezinstalează o aplicație, așa că păstrați-le separate de spațiul dvs. de lucru pentru dezvoltare. Treceți --test la jurnale, opriți, upgradați sau resetați când gestionați această instanță. Fluxul de lucru CI generat configurează o instanță izolată prin twentyhq/twenty/.github/actions/spawn-twenty-app-dev-test@main și instalează separat CLI-ul independent.

Alte configurări locale

Pentru un checkout al codului-sursă Twenty, funcționează și mediul de dezvoltare existent:
Utilizați URL-ul și portul efective ale serverului dvs. Pentru spațiile de lucru cu subdomenii, utilizați numele de gazdă al spațiului de lucru. Pentru implementarea în producție, urmați ghidul de auto-găzduire.

Dependențele proiectului

twenty app init declară twenty-sdk, twenty-client-sdk și twenty-ui în devDependencies, dar nu le instalează. Cu CLI-ul twenty instalat global, rulați yarn install din directorul aplicației generate înainte de a rula twenty app typecheck, twenty app build sau twenty app apply.