Lokalen Server verwalten
Verwenden Sie yarn twenty docker:*, um den lokalen Twenty-Container zu steuern:
| Befehl | Was es tut |
|---|
yarn twenty docker:start | Server starten (lädt das Image bei Bedarf herunter) |
yarn twenty docker:start --port 3030 | Auf einem benutzerdefinierten Port starten |
yarn twenty docker:stop | Server stoppen (Daten bleiben erhalten) |
yarn twenty docker:status | URL, Version und Anmeldedaten anzeigen |
yarn twenty docker:logs | Serverprotokolle streamen |
yarn twenty docker:reset | Alle Daten löschen und neu starten |
yarn twenty docker:upgrade | Das neueste twenty-app-dev-Image herunterladen |
yarn twenty docker:upgrade 2.2.0 | Auf eine bestimmte Version aktualisieren |
twenty-app-dev-data für PostgreSQL, twenty-app-dev-storage für Dateien). Verwenden Sie reset, um alles zu löschen.
Aktualisieren des Server-Images
yarn twenty docker:upgrade lädt das neueste Image herunter, vergleicht die Digests und erstellt den Container nur neu, wenn sich tatsächlich etwas geändert hat. Die Volumes bleiben erhalten — nur der Container wird ersetzt. Wenn ein neues Image heruntergeladen wurde und der Container lief, startet das Upgrade automatisch einen neuen Container; führen Sie anschließend yarn twenty docker:start aus, um zu warten, bis er betriebsbereit ist.
yarn twenty docker:upgrade # Latest
yarn twenty docker:upgrade 2.2.0 # Specific version
yarn twenty docker:status (dies zeigt die im Container enthaltene APP_VERSION an).
Eine parallele Testinstanz ausführen
Übergeben Sie --test an jeden docker:*-Befehl, um eine zweite, vollständig isolierte Instanz zu verwalten — nützlich für Integrationstests oder Experimente, ohne Ihre Hauptentwicklungsdaten anzutasten:
| Befehl | Was es tut |
|---|
yarn twenty docker:start --test | Die Testinstanz starten (standardmäßig Port 2021) |
yarn twenty docker:stop --test | Anhalten |
yarn twenty docker:status --test | Status anzeigen |
yarn twenty docker:logs --test | Protokolle streamen |
yarn twenty docker:reset --test | Daten löschen |
yarn twenty docker:upgrade --test | Image aktualisieren |
twenty-app-dev-test), eigene Volumes (twenty-app-dev-test-data, twenty-app-dev-test-storage) und eine eigene Konfiguration — sie läuft parallel zu Ihrer Hauptinstanz ohne Konflikte. Kombinieren Sie --test mit --port, um den Port 2021 zu überschreiben.
Überspringen Sie das Scaffolding-Tool, wenn Sie das SDK zu einem bestehenden Projekt hinzufügen:
yarn add twenty-sdk twenty-client-sdk
package.json das Skript hinzu:
{
"scripts": {
"twenty": "twenty"
}
}
yarn twenty dev, yarn twenty docker:start und den Rest ausführen.
Installieren Sie twenty-sdk nicht global — fixieren Sie es pro Projekt, damit jede App ihre eigene Version verwendet.
