Важливо створювати узгоджену резервну копію перед кожною міграцією на нову основну версію, щоб за потреби мати змогу відкотитися.
Міграція з Overleaf Community
Випадок 01: з Overleaf Toolkit
Якщо ви використовуєте офіційний Overleaf Toolkit для Overleaf Community, просто додайте до каталогуoverleaf-toolkit/config файл docker-compose.override.yml з таким або подібним вмістом:
docker-compose.override.yml
bin/up у тому самому каталозі Toolkit, що й раніше, а не в новому клоні, і залиште OVERLEAF_DATA_PATH, MONGO_DATA_PATH і REDIS_DATA_PATH у config/overleaf.rc спрямованими на старі дані.
Ось і все! Усе готово. Далі можна перевірити, що ваш екземпляр Ayakaleaf працює правильно і вебінтерфейс доступний. Коли все запрацює, продовжте з кроками конфігурації нижче, щоб увімкнути розширені функції, як-от:
Випадок 02: з файлу Docker Compose
Якщо ви використовуєте окремийdocker-compose.yml, спершу перенесіть його на Overleaf Toolkit. Toolkit спрощує локальну інсталяцію, оновлення та обслуговування.
Скористайтеся docker-compose.yml-to-toolkit-migration.md, щоб перетворити наявне розгортання. Під час цієї міграції збережіть поточну конфігурацію та шляхи до томів даних.
Коли розгортання через Toolkit запрацює, виконайте кроки з #case-01-from-overleaf-toolkit, щоб перемкнути його образ на Ayakaleaf Pro. Запустіть екземпляр командою bin/up, а потім переконайтеся, що вебінтерфейс доступний.
Міграція з Overleaf Server Pro
Якщо ви зараз використовуєте комерційно ліцензований екземпляр Overleaf Server Pro і хочете перейти на Ayakaleaf Pro, зауважте, що міграція може потребувати додаткової роботи, оскільки деякі формати даних (templates) можуть бути не повністю сумісними. Проте ми з радістю вам допоможемо. Будь ласка, створіть issue або напишіть нам на ayaka@outlook.in, і ми безкоштовно допоможемо вам перейти на Ayakaleaf Pro.
Міграція з Overleaf CEP
Ми часто отримуємо від користувачів запитання, чи можна перейти з Overleaf CEP на Ayakaleaf Pro. У більшості випадків Overleaf CEP і Ayakaleaf Pro пропонують загалом еквівалентну функціональність і залишаються сумісними за даними станом на версію 6.2.0. Два проєкти можуть випускати функції в різний час; наприклад, ми можемо перенести (cherry-pick) функцію з Overleaf CEP, і навпаки. Хоча наші реалізації однієї й тієї самої функції можуть дещо відрізнятися, загалом вагомих причин для міграції немає. Якщо ви все ж хочете перейти на Ayakaleaf Pro або спробувати його, див.: #case-01-from-overleaf-toolkit. Процес міграції такий самий.Міграція з Overleaf SaaS
На жаль, міграція з платформи Overleaf SaaS на самостійно розміщений екземпляр Ayakaleaf Pro може бути значно складнішою. Наразі єдиний загальнодоступний спосіб — завантажити кожен проєкт як ZIP-архів, а потім вивантажити його у ваш самостійно розміщений екземпляр Ayakaleaf Pro. Так переносяться лише поточні файли проєкту, тобто ви втратите:- Усю історію проєкту та попередні ревізії
- Усі коментарі та відстежувані зміни
- Усі метадані Git та історію комітів
- Усі посилання та налаштування синхронізації з GitHub
- Усі зв’язки між файлами BibTeX і сторонніми платформами керування бібліографією

