Міграція з наявної інсталяції

Міграція наявного розгортання Overleaf Toolkit на Ayakaleaf Pro.

Важливо створювати узгоджену резервну копію перед кожною міграцією на нову основну версію, щоб за потреби мати змогу відкотитися.

​

Міграція з Overleaf Community

​

Випадок 01: з Overleaf Toolkit

Якщо ви використовуєте офіційний Overleaf Toolkit для Overleaf Community, просто додайте до каталогу overleaf-toolkit/config файл docker-compose.override.yml з таким або подібним вмістом:

docker-compose.override.yml

---
services:
    sharelatex:
        image: ghcr.io/ayaka-notes/overleaf-pro:X.x.x # change to specific version

Щоб запустити екземпляр, виконайте:

bin/up

Ось і все! Усе готово. Далі можна перевірити, що ваш екземпляр Ayakaleaf працює правильно і вебінтерфейс доступний. Коли все запрацює, продовжте з кроками конфігурації нижче, щоб увімкнути розширені функції, як-от:

• sandboxed-compiles.md
• authentication
• github-synchronisation.md
• zotero-integration.md

​

Випадок 02: з файлу Docker Compose

Якщо ви використовуєте окремий docker-compose.yml, спершу перенесіть його на Overleaf Toolkit. Toolkit спрощує локальну інсталяцію, оновлення та обслуговування.

Скористайтеся docker-compose.yml-to-toolkit-migration.md, щоб перетворити наявне розгортання. Під час цієї міграції збережіть поточну конфігурацію та шляхи до томів даних.

Коли розгортання через Toolkit запрацює, виконайте кроки з #from-overleaf-toolkit, щоб перемкнути його образ на Ayakaleaf Pro. Запустіть екземпляр командою bin/up, а потім переконайтеся, що вебінтерфейс доступний.

---

​

Міграція з Overleaf Server Pro

Якщо ви зараз використовуєте комерційно ліцензований екземпляр Overleaf Server Pro і хочете перейти на Ayakaleaf Pro, зауважте, що міграція може потребувати додаткової роботи, оскільки деякі формати даних (templates) можуть бути не повністю сумісними. Проте ми з радістю вам допоможемо. Будь ласка, створіть issue або напишіть нам на [e-mail], і ми безкоштовно допоможемо вам перейти на 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 і сторонніми платформами керування бібліографією

---

​

Міграція зі стороннього форку Overleaf

Ayakaleaf Pro може не підтримувати функції, специфічні для певного стороннього форку Overleaf. Щойно форк суттєво відходить від кодової бази upstream Overleaf або вносить зміни без збереження сумісності з upstream, злиття наступних випусків Overleaf може стати надзвичайно складним. Ви все ще можете спробувати описаний вище метод міграції, але сумісність не гарантується, і ми можемо не мати змоги надати допомогу чи технічну підтримку для міграції з непідтримуваних форків.