メインコンテンツへスキップ
必要に応じてロールバックできるよう、メジャーバージョンをアップグレードする前には必ず 整合性のあるバックアップ を取得することが重要です。
ayakaleaf toolkit↗ は git リポジトリなので、Toolkit の新機能を簡単に取得できます。bin/upgrade コマンドを実行し、画面の指示に従うだけです。 なお、Docker イメージのバージョン(config/version)は、Toolkit のコードの更新とは別に管理されています。Toolkit のコードを更新しても、実行中の Docker イメージのバージョンが自動的に変更されることはありません。つまり、ほとんどの場合、デプロイをアップグレードせずに Toolkit のバージョンだけをアップグレードできます。

bin/upgrade スクリプト

bin/upgrade コマンドを実行すると、スクリプトは Toolkit のコードに利用可能な更新があるかどうかを確認し、Toolkit の更新を提案します。このアップグレードはいつでも拒否でき、その場合は何も変更されません。 Toolkit のコードを更新することを選んだ場合、スクリプトは次に デフォルト の Docker イメージのバージョンが変更されているかどうかを確認し、ローカルのバージョンファイル(config/version)を新しいデフォルトに合わせてアップグレードするよう提案します。 バージョンを切り替えることを選んだ場合、スクリプトは Docker サービスの停止、バックアップの取得、Docker サービスの再起動という一連の手順を案内します。古いバージョンファイルは、その Docker イメージのバージョンにロールバックする必要が生じた場合に備えて、自動的に config/__old-version にコピーされます。
Docker イメージを手動でインポートするエアギャップ環境では、config/overleaf.rc ファイルで PULL_BEFORE_UPGRADE=false を設定してください。エアギャップ/オフライン環境でのデプロイの詳細については、こちら を確認してください。

アップグレードパス

v6.0.0 より前の Overleaf Community を実行している場合は、Overleaf の公式ドキュメント を参照してアップグレードを完了してください。 Ayakaleaf Pro 内では、まず現在のバージョン系列の最新パッチリリースにアップグレードしてから、次の系列にアップグレードしてください(例: 6.2.0 → 6.2.2 → 6.3.2)。経由するすべてのバージョンのリリースノートを読んでください。一部のバージョンでは追加の手順が必要です。サポートされるのは最新リリースのみです。 実行中のイメージを確認するには、docker inspect --format '{{.Config.Image}}' sharelatex を使用します。

Q&A

回答: 既存のユーザーに、COMPILE_TIMEOUT で設定されたコンパイルタイムアウトなど、インスタンスのデフォルトの機能を付与します。値を引き上げるだけで引き下げることはないため、より長いコンパイルタイムアウトを持つユーザーはそのまま維持されます。これはアップグレードの一部ではなく、自動的に実行されることもありません。COMPILE_TIMEOUT などのデフォルト値を引き上げた後にのみ必要です。デフォルトでは、変更対象となるユーザーを一覧表示するだけのドライランとして実行されます。変更を保存するには --dry-run=false を追加してください。
最終更新日 2026年11月2日