メインコンテンツへスキップ

ローカルサーバーの管理

ローカルの Twenty コンテナを操作するには yarn twenty docker:* を使用します: データは再起動をまたいで、2 つの Docker ボリューム(PostgreSQL 用の twenty-app-dev-data、ファイル用の twenty-app-dev-storage)に永続化されます。 reset を使用して、すべてを消去します。

サーバーのバージョンを固定する

バージョンが指定されていない場合、docker:startpackage.json 内のアプリの engines.twenty の範囲からバージョンを解決します。これは、アプリのインストール時にサーバーが検証に使用する範囲と同じです。 このコマンドは、その範囲を満たす最新の公開済み twenty-app-dev イメージを起動し、フィールドが存在しない場合や公開済みバージョンが一致しない場合は latest にフォールバックします。
単回の実行でその範囲を上書きするには、バージョンを明示的に指定します: yarn twenty docker:start 2.3.0。 すでに別バージョンのコンテナが存在する場合、docker:start はその場でアップグレードします(データボリュームを保持したままコンテナを再作成します)。

サーバーイメージのアップグレード

yarn twenty docker:upgrade は最新のイメージを取得してダイジェストを比較し、実際に変更があった場合にのみコンテナを再作成します。 ボリュームは保持されます — 置き換えられるのはコンテナだけです。 新しいイメージが取得され、コンテナが稼働中だった場合、アップグレードは自動的に新しいコンテナを起動します。その後、yarn twenty docker:start を実行して、正常稼働になるまで待機します。
yarn twenty docker:status で実行中のバージョンを確認できます。コンテナの APP_VERSION が表示されます。

テスト用インスタンスを並行実行する

任意の docker:* コマンドに --test を指定すると、完全に分離された第2のインスタンスを管理できます。統合テストの実行や、メインの開発データに触れることなく試す際に便利です。 テスト用インスタンスは、専用のボリューム(twenty-app-dev-test-datatwenty-app-dev-test-storage)と設定を備えた独自の Docker コンテナ(twenty-app-dev-test)内で実行されるため、メインのインスタンスと競合することなく並行して実行できます。 --test--port を併用して、2021 を上書きできます。

手動セットアップ(スキャフォルダーなし)

既存プロジェクトに SDK を追加する場合はスキャフォルダーを省略します:
package.json にスクリプトを追加します:
これで yarn twenty devyarn twenty docker:start などを実行できます。
twenty-sdk をグローバルインストールしないでください — プロジェクトごとに固定し、各アプリがそれぞれのバージョンを使用するようにします。