diff --git a/packages/twenty-docs/l/de/developers/extend/apps/getting-started/local-server.mdx b/packages/twenty-docs/l/de/developers/extend/apps/getting-started/local-server.mdx index c560c758ad..e5ac5c4577 100644 --- a/packages/twenty-docs/l/de/developers/extend/apps/getting-started/local-server.mdx +++ b/packages/twenty-docs/l/de/developers/extend/apps/getting-started/local-server.mdx @@ -11,6 +11,7 @@ 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 2.2.0` | Eine bestimmte Serverversion starten | | `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 | @@ -21,6 +22,20 @@ Verwenden Sie `yarn twenty docker:*`, um den lokalen Twenty-Container zu steuern Daten bleiben über Neustarts hinweg in zwei Docker-Volumes bestehen (`twenty-app-dev-data` für PostgreSQL, `twenty-app-dev-storage` für Dateien). Verwenden Sie `reset`, um alles zu löschen. +## Serverversion fixieren + +Wenn keine Version übergeben wird, ermittelt `docker:start` die Version aus dem `engines.twenty`-Bereich deiner App in der `package.json` – derselbe Bereich, gegen den der Server beim Installieren deiner App validiert. Es startet das neueste veröffentlichte `twenty-app-dev`-Image, das den Bereich erfüllt, und greift auf `latest` zurück, wenn das Feld fehlt oder keine veröffentlichte Version übereinstimmt: + +```json filename="package.json" +{ + "engines": { + "twenty": ">=2.2.0" + } +} +``` + +Gib eine Version explizit an, um den Bereich für einen einzelnen Lauf zu überschreiben: `yarn twenty docker:start 2.3.0`. Wenn bereits ein Container mit einer anderen Version existiert, aktualisiert `docker:start` ihn direkt (der Container wird neu erstellt, während deine Daten-Volumes erhalten bleiben). + ## 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. diff --git a/packages/twenty-docs/l/pt/developers/extend/apps/getting-started/local-server.mdx b/packages/twenty-docs/l/pt/developers/extend/apps/getting-started/local-server.mdx index e73ba997fe..89f3163ff2 100644 --- a/packages/twenty-docs/l/pt/developers/extend/apps/getting-started/local-server.mdx +++ b/packages/twenty-docs/l/pt/developers/extend/apps/getting-started/local-server.mdx @@ -11,6 +11,7 @@ Use `yarn twenty docker:*` para controlar o contêiner Twenty local: | Comando | O que faz | | -------------------------------------- | ------------------------------------------------ | | `yarn twenty docker:start` | Inicia o servidor (baixa a imagem se necessário) | +| `yarn twenty docker:start 2.2.0` | Iniciar uma versão específica do servidor | | `yarn twenty docker:start --port 3030` | Inicia em uma porta personalizada | | `yarn twenty docker:stop` | Interrompe o servidor (preserva os dados) | | `yarn twenty docker:status` | Mostra a URL, a versão e as credenciais de login | @@ -21,6 +22,20 @@ Use `yarn twenty docker:*` para controlar o contêiner Twenty local: Os dados são persistidos entre reinicializações em dois volumes do Docker (`twenty-app-dev-data` para PostgreSQL, `twenty-app-dev-storage` para arquivos). Use `reset` para apagar tudo. +## Fixando a versão do servidor + +Quando nenhuma versão é passada, `docker:start` resolve a versão a partir do intervalo `engines.twenty` do seu app em `package.json` — o mesmo intervalo que o servidor valida quando o seu app é instalado. Ele inicia a imagem mais recente publicada de `twenty-app-dev` que satisfaz o intervalo, recorrendo a `latest` quando o campo está ausente ou nenhuma versão publicada corresponde: + +```json filename="package.json" +{ + "engines": { + "twenty": ">=2.2.0" + } +} +``` + +Passe uma versão explicitamente para substituir o intervalo em uma única execução: `yarn twenty docker:start 2.3.0`. Se já existir um contêiner em uma versão diferente, `docker:start` faz o upgrade dele no lugar (recriando o contêiner enquanto preserva seus volumes de dados). + ## Atualizando a imagem do servidor `yarn twenty docker:upgrade` baixa a imagem mais recente, compara os digests e só recria o contêiner se algo realmente tiver mudado. Os volumes são preservados — apenas o contêiner é substituído. Se uma nova imagem foi baixada e o contêiner estava em execução, a atualização inicia automaticamente um novo contêiner; execute `yarn twenty docker:start` depois para aguardar até que ele fique saudável. diff --git a/packages/twenty-docs/l/ro/developers/extend/apps/getting-started/local-server.mdx b/packages/twenty-docs/l/ro/developers/extend/apps/getting-started/local-server.mdx index 6b89565be7..2d85b67fdf 100644 --- a/packages/twenty-docs/l/ro/developers/extend/apps/getting-started/local-server.mdx +++ b/packages/twenty-docs/l/ro/developers/extend/apps/getting-started/local-server.mdx @@ -11,6 +11,7 @@ Folosiți `yarn twenty docker:*` pentru a controla containerul Twenty local: | Comandă | Ce face | | -------------------------------------- | ------------------------------------------------------------ | | `yarn twenty docker:start` | Pornește serverul (descarcă imaginea dacă este necesar) | +| `yarn twenty docker:start 2.2.0` | Pornește o anumită versiune a serverului | | `yarn twenty docker:start --port 3030` | Pornește pe un port personalizat | | `yarn twenty docker:stop` | Oprește serverul (păstrează datele) | | `yarn twenty docker:status` | Afișează URL-ul, versiunea și credențialele de autentificare | @@ -21,6 +22,20 @@ Folosiți `yarn twenty docker:*` pentru a controla containerul Twenty local: Datele persistă între reporniri în două volume Docker (`twenty-app-dev-data` pentru PostgreSQL, `twenty-app-dev-storage` pentru fișiere). Folosiți `reset` pentru a șterge totul. +## Fixarea versiunii serverului + +Când nu este transmisă nicio versiune, `docker:start` rezolvă versiunea din intervalul `engines.twenty` al aplicației tale din `package.json` — același interval față de care serverul validează când aplicația ta este instalată. Pornește cea mai nouă imagine publicată `twenty-app-dev` care satisface intervalul, revenind la `latest` atunci când câmpul lipsește sau nicio versiune publicată nu se potrivește: + +```json filename="package.json" +{ + "engines": { + "twenty": ">=2.2.0" + } +} +``` + +Transmite explicit o versiune pentru a suprascrie intervalul pentru o singură rulare: `yarn twenty docker:start 2.3.0`. Dacă un container există deja pe o versiune diferită, `docker:start` îl actualizează pe loc (recreând containerul, dar păstrând volumele tale de date). + ## Actualizarea imaginii serverului `yarn twenty docker:upgrade` descarcă cea mai recentă imagine, compară digest-urile și recreează containerul doar dacă s-a schimbat ceva. Volumele de date sunt păstrate — doar containerul este înlocuit. Dacă a fost descărcată o imagine nouă și containerul rula, actualizarea pornește automat un container nou; rulați apoi `yarn twenty docker:start` pentru a aștepta până când devine funcțional. diff --git a/packages/twenty-docs/l/ru/developers/extend/apps/getting-started/local-server.mdx b/packages/twenty-docs/l/ru/developers/extend/apps/getting-started/local-server.mdx index 3eeea6dda4..4097ba88a6 100644 --- a/packages/twenty-docs/l/ru/developers/extend/apps/getting-started/local-server.mdx +++ b/packages/twenty-docs/l/ru/developers/extend/apps/getting-started/local-server.mdx @@ -11,6 +11,7 @@ icon: server | Команда | Что делает | | -------------------------------------- | ---------------------------------------------------- | | `yarn twenty docker:start` | Запустить сервер (при необходимости скачивает образ) | +| `yarn twenty docker:start 2.2.0` | Запустить конкретную версию сервера | | `yarn twenty docker:start --port 3030` | Запустить на пользовательском порту | | `yarn twenty docker:stop` | Остановить сервер (данные сохраняются) | | `yarn twenty docker:status` | Показать URL, версию и учётные данные для входа | @@ -21,6 +22,20 @@ icon: server Данные сохраняются между перезапусками в двух томах Docker (`twenty-app-dev-data` для PostgreSQL, `twenty-app-dev-storage` для файлов). Используйте `reset`, чтобы стереть всё. +## Фиксация версии сервера + +Когда версия не передана, `docker:start` определяет версию из диапазона `engines.twenty` вашего приложения в `package.json` — того же диапазона, по которому сервер выполняет проверку при установке вашего приложения. Он запускает самый новый опубликованный образ `twenty-app-dev`, который удовлетворяет диапазону, и использует `latest`, если поле отсутствует или ни одна опубликованная версия не совпадает: + +```json filename="package.json" +{ + "engines": { + "twenty": ">=2.2.0" + } +} +``` + +Передайте версию явно, чтобы переопределить диапазон для одного запуска: `yarn twenty docker:start 2.3.0`. Если контейнер уже существует с другой версией, `docker:start` обновляет его на месте (пересоздаёт контейнер с сохранением томов данных). + ## Обновление образа сервера `yarn twenty docker:upgrade` скачивает последний образ, сравнивает дайджесты и пересоздаёт контейнер только если действительно что-то изменилось. Тома сохраняются — заменяется только контейнер. Если был скачан новый образ и контейнер работал, при обновлении автоматически запускается новый контейнер; затем выполните `yarn twenty docker:start`, чтобы дождаться его готовности. diff --git a/packages/twenty-docs/l/tr/developers/extend/apps/getting-started/local-server.mdx b/packages/twenty-docs/l/tr/developers/extend/apps/getting-started/local-server.mdx index d39f5885f5..5e657a1e65 100644 --- a/packages/twenty-docs/l/tr/developers/extend/apps/getting-started/local-server.mdx +++ b/packages/twenty-docs/l/tr/developers/extend/apps/getting-started/local-server.mdx @@ -11,6 +11,7 @@ Yerel Twenty konteynerini kontrol etmek için `yarn twenty docker:*` kullanın: | Komut | Ne yapar | | -------------------------------------- | --------------------------------------------------------- | | `yarn twenty docker:start` | Sunucuyu başlatır (gerekirse imajı çeker) | +| `yarn twenty docker:start 2.2.0` | Belirli bir sunucu sürümünü başlatın | | `yarn twenty docker:start --port 3030` | Özel bir portta başlatır | | `yarn twenty docker:stop` | Sunucuyu durdurur (verileri korur) | | `yarn twenty docker:status` | URL'yi, sürümü ve oturum açma kimlik bilgilerini gösterir | @@ -21,6 +22,20 @@ Yerel Twenty konteynerini kontrol etmek için `yarn twenty docker:*` kullanın: Veriler, yeniden başlatmalar arasında iki Docker biriminde kalıcıdır (PostgreSQL için `twenty-app-dev-data`, dosyalar için `twenty-app-dev-storage`). Her şeyi silmek için `reset` kullanın. +## Sunucu sürümünü sabitleme + +Herhangi bir sürüm iletilmediğinde, `docker:start` sürümü uygulamanızın `package.json` içindeki `engines.twenty` aralığından çözümler — bu, uygulamanız yüklendiğinde sunucunun doğruladığı aralıkla aynıdır. Bu komut, aralığı karşılayan en yeni yayımlanmış `twenty-app-dev` imajını başlatır; alan yoksa veya hiçbir yayımlanmış sürüm eşleşmiyorsa `latest` değerine geri döner: + +```json filename="package.json" +{ + "engines": { + "twenty": ">=2.2.0" + } +} +``` + +Aralığı tek bir çalıştırma için geçersiz kılmak amacıyla sürümü açıkça iletin: `yarn twenty docker:start 2.3.0`. Bir kapsayıcı zaten farklı bir sürümde mevcutsa, `docker:start` onu yerinde yükseltir (veri birimlerinizi korurken kapsayıcıyı yeniden oluşturarak). + ## Sunucu imajını yükseltme `yarn twenty docker:upgrade`, en güncel imajı çeker, özetleri karşılaştırır ve yalnızca gerçekten bir şey değiştiyse konteyneri yeniden oluşturur. Birimler korunur — yalnızca konteyner değiştirilir. Yeni bir imaj çekildiyse ve konteyner çalışıyorsa, yükseltme otomatik olarak yeni bir konteyner başlatır; sağlıklı hale gelmesini beklemek için ardından `yarn twenty docker:start` çalıştırın. diff --git a/packages/twenty-docs/l/zh/developers/extend/apps/getting-started/local-server.mdx b/packages/twenty-docs/l/zh/developers/extend/apps/getting-started/local-server.mdx index de6e0ccf24..e6bf3db9ee 100644 --- a/packages/twenty-docs/l/zh/developers/extend/apps/getting-started/local-server.mdx +++ b/packages/twenty-docs/l/zh/developers/extend/apps/getting-started/local-server.mdx @@ -11,6 +11,7 @@ icon: server | 命令 | 作用 | | -------------------------------------- | ------------------------- | | `yarn twenty docker:start` | 启动服务器(按需拉取镜像) | +| `yarn twenty docker:start 2.2.0` | 启动指定的服务器版本 | | `yarn twenty docker:start --port 3030` | 在自定义端口启动 | | `yarn twenty docker:stop` | 停止服务器(保留数据) | | `yarn twenty docker:status` | 显示 URL、版本和登录凭据 | @@ -21,6 +22,20 @@ icon: server 数据在重启后会保留,存储于两个 Docker 卷中(`twenty-app-dev-data` 用于 PostgreSQL,`twenty-app-dev-storage` 用于文件)。 使用 `reset` 清空所有内容。 +## 固定服务器版本 + +当未传入版本时,`docker:start` 会根据你的应用在 `package.json` 中的 `engines.twenty` 范围解析版本 —— 这与在安装你的应用时服务器用于校验的范围相同。 它会启动满足该范围的最新已发布 `twenty-app-dev` 镜像,当该字段缺失或没有已发布版本匹配时,则回退到 `latest`: + +```json filename="package.json" +{ + "engines": { + "twenty": ">=2.2.0" + } +} +``` + +显式传入一个版本以在单次运行中覆盖该范围:`yarn twenty docker:start 2.3.0`。 如果已有容器使用的是不同版本,`docker:start` 会就地升级它(在保留你的数据卷的同时重新创建容器)。 + ## 升级服务器镜像 `yarn twenty docker:upgrade` 将拉取最新镜像、比较摘要,并且仅在确有变更时才重新创建容器。 数据卷将被保留——只会替换容器。 如果已拉取新镜像且容器正在运行,升级会自动启动一个新容器;之后运行 `yarn twenty docker:start` 以等待其变为健康状态。