デプロイメントのアップグレード

ロールバックが必要になった場合に備えて、各メジャーバージョンのアップグレードごとに 一貫したバックアップ 前に を取得することが重要です。

その Overleaf Toolkit↗ はgitリポジトリなので、新しいToolkitの機能を簡単に取得できます。単に以下のコマンドを実行し、画面上の指示に従ってください。 bin/upgrade コマンドを実行し、画面の指示に従ってください。

Dockerイメージのバージョン（ config/version）はToolkitコードの更新とは別に管理されている点に注意してください。Toolkitコードを更新すると、 使用してはいけません 実行中のDockerイメージのバージョンが自動的に変更されます。これは、ほとんどの場合、デプロイをアップグレードせずにToolkitのバージョンをアップグレードできることを意味します。

その bin/upgrade スクリプト

コマンドを実行すると、スクリプトはToolkitコードに利用可能な更新があるかどうかをチェックし、Toolkitを更新するかどうかを提案します。アップグレードを拒否することも常に可能で、その場合は何も変更されません。 bin/upgrade コマンドを実行すると、スクリプトはToolkitコードに利用可能な更新があるかどうかをチェックし、Toolkitを更新するかどうかを提案します。アップグレードを拒否することも常に可能で、その場合は何も変更されません。

Toolkitのコードを更新することを選択した場合、スクリプトは次に デフォルト Dockerイメージのバージョンが変更されているかどうかを確認し、ローカルのバージョンファイル（ config/version）を新しいデフォルトに合わせてアップグレードすることを提案します。

バージョンを切り替えることを選択した場合、スクリプトはDockerサービスの停止、バックアップの取得、Dockerサービスの再起動という手順を案内します。古いバージョンファイルは自動的に config/__old-versionにコピーされます。万が一Dockerイメージのそのバージョンにロールバックする必要がある場合に備えてです。

Server CE/Pro のアップグレードを行う際には、デプロイされているメジャーバージョンの最新リリースにまずアップグレードすることを推奨します 前に その後で最新のリリースにアップグレードします 次の メジャーバージョンへ。デプロイが最新から複数のメジャーバージョン遅れている場合は、多段階のアップグレードを実行する必要があります。

例えば、3.5.10 を実行している場合は、3.5.13 にアップグレード -> フルプロジェクト履歴移行を実行 -> 4.2.9 -> 5.5.4 の順に行う必要があります。

あなたは 決して メジャーバージョンをスキップしないでください（3.5.10 -> 5.5.4）。Toolkit を使用していて最新から複数のメジャーバージョン遅れている場合、手動での多段階アップグレードを行う必要があるため、 使用してはいけません スクリプトを bin/upgrade 。

Dockerイメージを手動でインポートするエアギャップ環境の場合は、次の設定を行ってください： PULL_BEFORE_UPGRADE=false をあなたの config/overleaf.rc ファイル。

エアギャップ／オフライン環境でのデプロイについての詳細は、 こちら を確認してください。

アップグレード経路

その bin/upgrade コマンドは、その時点で利用可能なServer Pro/CEの最も新しいバージョンを常に選択します。アップグレードの間隔が長い場合、メジャーバージョンをスキップして予想していなかったバージョンにアップグレードされる可能性があります。

アップグレードを行う際は、次のメジャーバージョンの最新リリースにアップグレードする前に、現在のメジャーバージョンの最新リリースにアップグレードすることを推奨します。例えば、現在3.3.2を実行していて利用可能な最新バージョンが5.3.1である場合、正しいアップグレード経路は次のようになります：

• 3.3.2 -> 3.5.13

• 3.5.13 -> 4.2.9

• 4.2.9 -> 5.5.1

アップグレード時の問題を避けるため、特定のバージョンで追加の手順が必要になる場合があるため、アップグレードを行う前に必ず当社の リリースノート を参照することを推奨します。例えば、Toolkitへの手動変更、データベースのアップグレード、マイグレーションスクリプトの実行などが必要になることがあります。

まだ行っていない場合は、当社の メーリングリスト に登録して、新しいバージョンや更新がリリースされた際に通知を受け取ることをお勧めします。これにより、当社のリリーススケジュールに合わせた定期的なメンテナンス時間を予定できるようになります。