Миграция с существующей установки

Миграция существующего развёртывания 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. Если форк значительно отклоняется от основной кодовой базы Overleaf или вносит изменения без сохранения совместимости с ней, слияние последующих выпусков Overleaf может стать крайне затруднительным. Вы по-прежнему можете попробовать описанный выше способ миграции, но совместимость не гарантируется, и мы можем быть не в состоянии оказать помощь или техническую поддержку при миграции с неподдерживаемых форков.