Перейти до основного вмісту
Кожен новий випуск Ayakaleaf Pro зазначає будь-які зміни підтримуваної версії MongoDB у своїх примітках до випуску.

Чи потрібно оновлювати MongoDB?

Оновлення версії MongoDB варто розглядати лише тоді, коли ви плануєте оновити свій екземпляр Ayakaleaf Pro. Якщо ваша версія MongoDB новіша за рекомендовану для поточної (або цільової) версії, жодних змін вносити не потрібно.
Ніколи не знижуйте версію MongoDB.
Якщо у вас виникла конкретна проблема, яка, на вашу думку, може бути пов’язана з поточною версією MongoDB, ви можете створити issue.

Перевірка версії MongoDB

Відкриття оболонки mongo має одразу вивести поточну версію. Користувачі Overleaf Toolkit:
Користувачі Docker Compose:

Процес оновлення

Оновлення версії MongoDB під час оновлення вашого екземпляра Ayakaleaf Pro відбувається так:
  1. Визначте версію Ayakaleaf Pro, до якої плануєте оновитися.
  2. Знайдіть версію MongoDB, рекомендовану для цього конкретного випуску Ayakaleaf Pro.
  3. Виконайте інструкції з оновлення MongoDB до цільової версії.
  4. Оновіть версію образу Ayakaleaf Pro і перезапустіть екземпляр.
Ми рекомендуємо завжди оновлюватися до останньої доступної версії.
Під час оновлення Ayakaleaf Pro ми рекомендуємо оновитися до останнього випуску розгорнутої мажорної версії, перш ніж оновлюватися до останнього випуску наступної мажорної версії. Якщо ваше розгортання відстає від останньої версії більш ніж на одну мажорну версію, вам доведеться виконати багатоетапне оновлення.Наприклад, якщо у вас 6.2.0, спершу оновіться до 6.2.2, а потім до 6.3.2, див. Оновлення розгортання.Ніколи не пропускайте версії (6.2.0 -> 6.3.2). Якщо ви використовуєте Toolkit і відстаєте від останньої версії більш ніж на одну мажорну версію, не використовуйте скрипт bin/upgrade, оскільки вам потрібно буде виконати ручне багатоетапне оновлення.
Важливо створювати узгоджену резервну копію перед кожним оновленням мажорної версії, щоб за потреби мати змогу відкотитися.

Інформація про підтримку версій

Якщо ви вирішите перейти на попередню версію, у цій таблиці наведено рекомендовану версію MongoDB для попередніх випусків, однак ніколи не знижуйте версію MongoDB. У таблиці наведено випуски Overleaf. Образи Ayakaleaf Pro починаються з версії 6.0.0: для 6.0.0 потрібна MongoDB 6.0 або новіша, а для 6.0.1 і новіших — MongoDB 8.0 або новіша з версією сумісності функцій (feature compatibility version) 7.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
Наведена вище мінімальна версія сумісності функцій ґрунтується на відповідній версії MongoDB, рекомендованій для використання з наведеною версією Overleaf. Якщо ви плануєте використовувати вищу версію, MongoDB матиме власні мінімальні вимоги.
Таблицю сумісності з підтримуваними версіями драйвера MongoDB Node.js для використання з MongoDB можна переглянути тут. Статус завершення підтримки (end-of-life) для кожної версії MongoDB можна переглянути тут.

Оновлення MongoDB

MongoDB вимагає покрокового оновлення. Це означає, що не можна перейти, скажімо, з 4.0 одразу на 5.0. Спочатку потрібно оновитися з 4.2 до 4.4, а потім до 5.0.
MongoDB використовує парні номери для своїх стабільних версій.

Інструкції з оновлення, якщо MongoDB працює поза Docker

Нижче наведено посилання на інструкції з оновлення MongoDB на mongodb.com.
Інструкції для 5.0 і вище стосуються встановлення у вигляді набору реплік (replica set), а не автономного (standalone). Оскільки 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: Потім зупиняємо екземпляри Ayakaleaf Pro і MongoDB командою bin/stop, встановлюємо MONGO_VERSION=6.0 у config/overleaf.rc, а потім перезапускаємо сервіс mongo за допомогою bin/up mongo), щоб перевірити, що оновлення пройшло без проблем. Насамкінець оновлюємо версію образу Ayakaleaf Pro до цільової версії та повторно створюємо всі сервіси командою bin/up -d. Користувачі Docker Compose: Потім зупиняємо екземпляри Ayakaleaf Pro і MongoDB командою docker compose stop, змінюємо файл docker-compose.yml, щоб використовувати image: mongo:6.0, а потім перезапускаємо сервіс mongo командою docker compose up mongo, щоб перевірити, що оновлення пройшло без проблем. Насамкінець оновлюємо версію образу Ayakaleaf Pro до цільової версії та повторно створюємо всі сервіси командою docker compose up. Почніть із того, що переконайтеся, що використовується MongoDB 6.0, за допомогою наведених вище команд mongod --version. Згідно з інструкціями з оновлення, єдина вимога — щоб featureCompatibilityVersion мав значення 6.0. Для цього відкриваємо оболонку MongoDB і виконуємо команду db.adminCommand({ setFeatureCompatibilityVersion: "6.0" }) . Користувачі Overleaf Toolkit:
Потім зупиняємо екземпляри Ayakaleaf Pro і MongoDB командою bin/stop, встановлюємо MONGO_VERSION=7.0 у config/overleaf.rc, а потім перезапускаємо сервіс mongo за допомогою bin/up mongo), щоб перевірити, що оновлення пройшло без проблем. Насамкінець оновлюємо версію образу Ayakaleaf Pro до цільової версії та повторно створюємо всі сервіси командою bin/up -d. Почніть із того, що переконайтеся, що використовується MongoDB 7.0, за допомогою наведених вище команд mongod --version. Згідно з інструкціями з оновлення, єдина вимога — щоб featureCompatibilityVersion мав значення 7.0. Для цього відкриваємо оболонку MongoDB і виконуємо команду db.adminCommand({ setFeatureCompatibilityVersion: "7.0", confirm: true }). Зверніть увагу, що тепер для цього потрібен додатковий параметр confirm: true.
Потім зупиняємо екземпляри Ayakaleaf Pro і MongoDB командою bin/stop, встановлюємо MONGO_VERSION=8.0 у config/overleaf.rc, а потім перезапускаємо сервіс mongo за допомогою bin/up 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. Щоб запустити Ayakaleaf Pro на наявній MongoDB 4.4, оновлюйте MongoDB по одній основній версії за раз (4.4 → 5.0 → 6.0 → 7.0 → 8.0), як описано в розділі Оновлення MongoDB, створюючи резервну копію перед кожним кроком.
Останнє оновлення 8 листопада 2026 р.