メインコンテンツへスキップ
Ayakaleaf Pro の新しいリリースでは、サポートされる MongoDB のバージョンに変更がある場合、そのリリースノートに記載されます。

MongoDB を更新すべきか?

MongoDB のバージョンの更新を検討すべきなのは、Ayakaleaf Pro のインスタンスをアップグレードする予定がある場合のみです。 現在の(または移行先の)バージョンで推奨されているものより新しいバージョンの MongoDB を実行している場合は、何も変更する必要はありません。
MongoDB のバージョンを決してダウングレードしないでください。
現在のバージョンの MongoDB に関係していると思われる特定の問題が発生した場合は、気軽に issue を作成してください。

MongoDB のバージョンを確認する

mongo シェルを開くと、すぐに現在のバージョンが表示されます。 Overleaf Toolkit ユーザーの場合:
Docker Compose ユーザーの場合:

更新手順

Ayakaleaf Pro インスタンスのアップグレード時に MongoDB のバージョンを更新する手順は次のとおりです:
  1. アップグレード先の Ayakaleaf Pro のバージョンを決定します。
  2. その Ayakaleaf Pro リリースで推奨されている MongoDB のバージョンを確認します。
  3. 手順に従って、MongoDB を目的のバージョンにアップグレードします。
  4. Ayakaleaf Pro のイメージのバージョンをアップグレードし、インスタンスを再起動します。
常に利用可能な最新バージョンにアップグレードすることをお勧めします。
Ayakaleaf Pro をアップグレードする際は、次のメジャーバージョンの最新リリースにアップグレードする前に、現在導入しているメジャーバージョンの最新リリースにアップグレードすることをお勧めします。導入環境が最新版から 2 つ以上メジャーバージョンが遅れている場合は、複数段階のアップグレードを行う必要があります。たとえば、6.2.0 を実行している場合は、まず 6.2.2 にアップグレードし、その後 6.3.2 にアップグレードします。デプロイのアップグレードを参照してください。バージョンを飛ばすこと(6.2.0 -> 6.3.2)は決してしないでください。Toolkit を使用していて、最新版から 2 つ以上メジャーバージョンが遅れている場合は、手動で複数段階のアップグレードを行う必要があるため、bin/upgrade スクリプトを使用しないでください。
必要に応じてロールバックできるように、メジャーバージョンのアップグレードの前に毎回整合性のとれたバックアップを取得しておくことが重要です。

バージョンのサポート情報

以前のバージョンを使用する場合に備えて、この表では以前のリリースで推奨される MongoDB のバージョンを示しています。ただし、MongoDB のバージョンを決してダウングレードしないでください。 この表は Overleaf のリリースを示しています。Ayakaleaf Pro のイメージは 6.0.0 から始まります。6.0.0 には MongoDB 6.0 以降が、6.0.1 以降には機能互換性バージョン 7.0 の MongoDB 8.0 以降が必要です。それより古い MongoDB では、コンテナは起動時に停止します。
Overleaf のバージョンMongoDB のバージョン最小の機能互換性バージョンNode.js ドライバーがサポートする最大バージョン
2.0.x3.4--
2.1.x 〜 2.4.x3.6--
>=2.5.04.0--
>=3.1.04.2--
>=3.2.04.4--
>=4.2.05.0--
>=5.1.06.0--
>=5.3.16.05.08.0
>=5.5.06.06.08.0
>=6.0.08.07.08.0
上記の最小の機能互換性バージョンは、表示されている Overleaf のバージョンでの使用が推奨される、対応する MongoDB のバージョンに基づいています。より新しいバージョンを使用する予定の場合は、MongoDB 独自の最小要件があります。
MongoDB で使用できる MongoDB Node.js ドライバーのサポート対象バージョンを示す互換性表は、こちらで確認できます。 MongoDB の各バージョンのサポート終了状況は、こちらで確認できます。

MongoDB のアップグレード

MongoDB では段階的なアップグレードが必要です。つまり、たとえば 4.0 から 5.0 に直接アップグレードすることはできません。まず 4.2 から 4.4 に、その後 5.0 に更新する必要があります。
MongoDB では、安定版に偶数のバージョン番号が使用されます。

Docker 外で MongoDB を実行している場合の更新手順

MongoDB をアップグレードする際の、mongodb.com の更新手順へのリンクは次のとおりです。
5.0 以降の手順は、スタンドアロンではなくレプリカセットのインストールを対象としています。Ayakaleaf Pro はトランザクションを使用するため、MongoDB をレプリカセットとして実行する必要があります。
MongoDB 3.2 〜 4.2 のドキュメントは、現在 https://www.mongodb.com/docs/legacy/ から参照できます
基本的な手順 ほとんどの場合、更新では、実際に mongo のバージョンを更新する前に互換性フラグを設定する必要があります。手順は次のとおりです:
  1. MongoDB のリリースノートに記載されているとおりに互換性フラグを設定します(以下の例を参照)。
  2. 次に、mongo イメージを更新します:
    1. Toolkit ユーザー MONGO_VERSION を更新します。例:MONGO_VERSION=6.0
    2. Docker Compose ユーザー mongo イメージタグのバージョンを更新します。
      例:services -> mongo -> image: mongo:6.0
例:MongoDB を 5.0 から 6.0 にアップグレードする まず、MongoDB 6.0 を実行していることを確認しましょう: Overleaf Toolkit ユーザーの場合:
Docker Compose ユーザーの場合:
アップグレード手順によると、唯一の要件は featureCompatibilityVersion を 5.0 に設定することです。これを行うには、MongoDB シェルを開いて指定されたコマンドを実行します: Overleaf Toolkit ユーザーの場合:
Docker Compose ユーザーは、docker compose exec mongo mongosh を実行してシェルを開き、Toolkit ユーザーと同じコマンドを実行できます。
Overleaf Toolkit ユーザーの場合: 次に、bin/stop コマンドを使用して Ayakaleaf Pro と MongoDB のインスタンスを停止し、config/overleaf.rc で MONGO_VERSION=6.0 を設定してから、bin/up mongo を使用して mongo サービスを再起動し、更新が問題なく行われたことを確認します。 最後に、Ayakaleaf Pro のイメージのバージョンを目的のバージョンに更新し、bin/up -d コマンドを使用してすべてのサービスを再作成します。 Docker Compose ユーザーの場合: 次に、docker compose stop コマンドを使用して Ayakaleaf Pro と MongoDB のインスタンスを停止し、docker-compose.yml ファイルを更新して image: mongo:6.0 を使用するようにしてから、docker compose up mongo コマンドを使用して mongo サービスを再起動し、更新が問題なく行われたことを確認します。 最後に、Ayakaleaf Pro のイメージのバージョンを目的のバージョンに更新し、docker compose up コマンドを使用してすべてのサービスを再作成します。 まず、上記の mongod --version コマンドを使用して、MongoDB 6.0 を実行していることを確認します。 アップグレード手順によると、唯一の要件は featureCompatibilityVersion を 6.0 に設定することです。これを行うには、MongoDB シェルを開いて db.adminCommand({ setFeatureCompatibilityVersion: "6.0" }) コマンドを実行します。 Overleaf Toolkit ユーザーの場合:
次に、bin/stop コマンドを使用して Ayakaleaf Pro と MongoDB のインスタンスを停止し、config/overleaf.rc で MONGO_VERSION=7.0 を設定してから、bin/up mongo を使用して mongo サービスを再起動し、更新が問題なく行われたことを確認します。 最後に、Ayakaleaf Pro のイメージのバージョンを目的のバージョンに更新し、bin/up -d コマンドを使用してすべてのサービスを再作成します。 まず、上記の mongod --version コマンドを使用して、MongoDB 7.0 を実行していることを確認します。 アップグレード手順によると、唯一の要件は featureCompatibilityVersion を 7.0 に設定することです。これを行うには、MongoDB シェルを開いて db.adminCommand({ setFeatureCompatibilityVersion: "7.0", confirm: true }) コマンドを実行します。このバージョンでは追加の confirm: true パラメーターが必要になったことに注意してください。
次に、bin/stop コマンドを使用して Ayakaleaf Pro と MongoDB のインスタンスを停止し、config/overleaf.rc で MONGO_VERSION=8.0 を設定してから、bin/up mongo を使用して mongo サービスを再起動し、更新が問題なく行われたことを確認します。 最後に、Ayakaleaf Pro のイメージのバージョンを目的のバージョンに更新し、bin/up -d コマンドを使用してすべてのサービスを再作成します。

Docker Compose ユーザー向けの同等のコマンド

Docker Compose ユーザー向けの同等のコマンドは次のとおりです:
  • docker compose exec mongo mongod --version:mongo のバージョンを表示します
  • docker compose exec mongo mongosh:管理コマンド用の mongo シェルを起動します
  • docker compose stop コマンド:サーバーを停止します
  • docker-compose.yml ファイルを編集して image: mongo:6.0 を使用するようにし、mongo のバージョンをアップグレードします
  • docker compose up mongo:mongo サービスを再起動し、更新が問題なく行われたことを確認します
  • docker-compose.yml ファイルを編集して image: sharelatex:VERSION を使用するようにし、イメージのバージョンをアップグレードします
  • docker compose up:すべてのサービスを再作成します。

カスタムロールの作成

バージョン 5.5.1 では、MongoDB の機能互換性バージョンを確認する起動時チェックが導入されました。MongoDB データベースで認証(基本認証など)を使用している場合、sharelatex コンテナが起動せず、“not authorized on admin to execute command” という権限エラーが表示されることがあります。 これを解決するには、以下の手順に従って MongoDB で新しいロールを作成し、データベースへのアクセスに使用するユーザーアカウントに割り当てるか、ALLOW_MONGO_ADMIN_CHECK_FAILURES=true を設定して、チェックが失敗しても導入環境の起動を妨げないようにします。
この新しいロールは、クラスター全体の MongoDB サーバーパラメーターを読み取る権限のみを付与するもので、監視目的にも再利用できます。

Q&A

回答: ありません。最も古い Ayakaleaf Pro のイメージである 6.0.0 には MongoDB 6.0 が、6.0.1 以降には MongoDB 8.0 が必要です。既存の MongoDB 4.4 上で Ayakaleaf Pro を実行するには、MongoDB のアップグレードの説明に従い、各ステップの前にバックアップを取りながら、MongoDB を 1 メジャーバージョンずつアップグレードしてください(4.4 → 5.0 → 6.0 → 7.0 → 8.0)。
最終更新日 2026年11月8日