Správa lokálního serveru
K ovládání lokálního kontejneru Twenty použijte yarn twenty docker:*:
| Příkaz | K čemu slouží |
|---|
yarn twenty docker:start | Spustí server (v případě potřeby stáhne image) |
yarn twenty docker:start 2.2.0 | Spustit konkrétní verzi serveru |
yarn twenty docker:start --port 3030 | Spustí na vlastním portu |
yarn twenty docker:stop | Zastaví server (zachová data) |
yarn twenty docker:status | Zobrazí URL, verzi a přihlašovací údaje |
yarn twenty docker:logs | Streamuje protokoly serveru |
yarn twenty docker:reset | Vymaže data a začne znovu |
yarn twenty docker:upgrade | Stáhne nejnovější image twenty-app-dev |
yarn twenty docker:upgrade 2.2.0 | Aktualizuje na konkrétní verzi |
twenty-app-dev-data pro PostgreSQL, twenty-app-dev-storage pro soubory). Pomocí reset vymažte vše.
Fixace verze serveru
Když není předána žádná verze, docker:start určí verzi z rozsahu engines.twenty vaší aplikace v package.json — stejného rozsahu, vůči kterému server ověřuje, když je vaše aplikace nainstalována. Spustí nejnovější publikovaný image twenty-app-dev, který splňuje tento rozsah, a pokud pole chybí nebo žádná publikovaná verze neodpovídá, použije latest:
{
"engines": {
"twenty": ">=2.2.0"
}
}
yarn twenty docker:start 2.3.0. Pokud už kontejner existuje v jiné verzi, docker:start jej na místě aktualizuje (znovu vytvoří kontejner při zachování vašich datových svazků).
Aktualizace obrazu serveru
yarn twenty docker:upgrade stáhne nejnovější image, porovná digesty a znovu vytvoří kontejner pouze v případě, že se skutečně něco změnilo. Svazky zůstanou zachovány — nahradí se pouze kontejner. Pokud byl stažen nový image a kontejner běžel, upgrade automaticky spustí nový kontejner; poté spusťte yarn twenty docker:start, abyste počkali, než bude ve stavu ‘healthy’.
yarn twenty docker:upgrade # Latest
yarn twenty docker:upgrade 2.2.0 # Specific version
yarn twenty docker:status (zobrazí APP_VERSION zabudovanou v kontejneru).
Spuštění paralelní testovací instance
Předejte --test libovolnému příkazu docker:* pro správu druhé, plně izolované instance — užitečné pro integrační testy nebo experimentování bez zásahu do vašich hlavních vývojových dat:
| Příkaz | K čemu slouží |
|---|
yarn twenty docker:start --test | Spustí testovací instanci (výchozí port je 2021) |
yarn twenty docker:stop --test | Zastaví ji |
yarn twenty docker:status --test | Zobrazí její stav |
yarn twenty docker:logs --test | Streamuje její protokoly |
yarn twenty docker:reset --test | Vymaže její data |
yarn twenty docker:upgrade --test | Aktualizuje její image |
twenty-app-dev-test), svazky (twenty-app-dev-test-data, twenty-app-dev-test-storage) a konfiguraci — běží souběžně s vaší hlavní instancí bez konfliktů. Zkombinujte --test s --port pro změnu výchozího portu 2021.
Ruční nastavení (bez generátoru kostry)
Pokud přidáváte SDK do existujícího projektu, generátor kostry přeskočte:
yarn add twenty-sdk twenty-client-sdk
package.json:
{
"scripts": {
"twenty": "twenty"
}
}
yarn twenty dev, yarn twenty docker:start a další.
Neinstalujte twenty-sdk globálně — nainstalujte jej v každém projektu zvlášť, aby každá aplikace používala svou vlastní verzi.
