Migracja z istniejącej instalacji

Migracja istniejącego wdrożenia Overleaf Toolkit do Ayakaleaf Pro.

Przed każdą migracją do nowej wersji głównej koniecznie wykonaj spójną kopię zapasową, aby w razie potrzeby móc przywrócić poprzedni stan.

​

Migracja z Overleaf Community

​

Przypadek 01: z Overleaf Toolkit

Jeśli korzystasz z oficjalnego Overleaf Toolkit dla Overleaf Community, wystarczy dodać do katalogu overleaf-toolkit/config plik o nazwie docker-compose.override.yml z poniższą lub podobną zawartością:

docker-compose.override.yml

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

Aby uruchomić instancję, wykonaj:

bin/up

To wszystko! Gotowe. Następnie możesz sprawdzić, czy instancja Ayakaleaf działa poprawnie i czy masz dostęp do interfejsu webowego. Gdy wszystko działa, przejdź do opisanych poniżej kroków konfiguracji, aby włączyć zaawansowane funkcje, takie jak:

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

​

Przypadek 02: z pliku Docker Compose

Jeśli używasz samodzielnego pliku docker-compose.yml, najpierw przeprowadź migrację do Overleaf Toolkit. Toolkit upraszcza lokalną instalację, aktualizacje i utrzymanie.

Postępuj zgodnie z docker-compose.yml-to-toolkit-migration.md, aby przekształcić istniejące wdrożenie. Podczas tej migracji zachowaj obecną konfigurację oraz ścieżki woluminów danych.

Gdy wdrożenie Toolkit będzie już działać, postępuj zgodnie z #from-overleaf-toolkit, aby przełączyć jego obraz na Ayakaleaf Pro. Uruchom instancję poleceniem bin/up, a następnie sprawdź, czy masz dostęp do interfejsu webowego.

---

​

Migracja z Overleaf Server Pro

Jeśli obecnie korzystasz z komercyjnie licencjonowanej instancji Overleaf Server Pro i chcesz przeprowadzić migrację do Ayakaleaf Pro, pamiętaj, że może ona wymagać dodatkowej pracy, ponieważ niektóre formaty danych (templates) mogą nie być w pełni zgodne. Chętnie jednak pomożemy. Zgłoś problem lub skontaktuj się z nami pod adresem [e-mail], a bezpłatnie pomożemy Ci w migracji do Ayakaleaf Pro.

---

​

Migracja z Overleaf CEP

Często otrzymujemy od użytkowników pytania, czy mogą przeprowadzić migrację z Overleaf CEP do Ayakaleaf Pro. W większości przypadków Overleaf CEP i Ayakaleaf Pro oferują zasadniczo równoważną funkcjonalność i pozostają zgodne pod względem danych od wersji 6.2.0. Oba projekty mogą wydawać funkcje w różnym czasie; na przykład możemy przejąć (cherry-pick) funkcję z Overleaf CEP i odwrotnie. Choć nasze implementacje tej samej funkcji mogą się nieznacznie różnić, zazwyczaj nie ma istotnego powodu do migracji.

Jeśli mimo to chcesz przeprowadzić migrację do Ayakaleaf Pro lub go wypróbować, zapoznaj się z: #case-01-from-overleaf-toolkit. Proces migracji jest taki sam.

---

​

Migracja z Overleaf SaaS

Niestety migracja z platformy Overleaf SaaS do samodzielnie hostowanej instancji Ayakaleaf Pro może być znacznie trudniejsza. Obecnie jedyną powszechnie dostępną metodą jest pobranie każdego projektu jako archiwum ZIP, a następnie przesłanie go do własnej instancji Ayakaleaf Pro. W ten sposób przenoszone są tylko bieżące pliki projektu, co oznacza, że utracisz:

• Całą historię projektu i poprzednie rewizje
• Wszystkie komentarze i śledzone zmiany
• Wszystkie metadane Git i historię commitów
• Wszystkie powiązania i ustawienia synchronizacji z GitHubem
• Wszystkie powiązania między plikami BibTeX a zewnętrznymi platformami do zarządzania bibliografią

---

​

Migracja z zewnętrznego forka Overleaf

Ayakaleaf Pro może nie obsługiwać funkcji specyficznych dla danego zewnętrznego forka Overleaf. Gdy fork znacząco odbiega od kodu źródłowego Overleaf w upstreamie lub wprowadza zmiany bez zachowania zgodności z upstreamem, scalanie kolejnych wydań Overleaf może stać się niezwykle trudne. Nadal możesz spróbować opisanej powyżej metody migracji, ale zgodność nie jest gwarantowana i możemy nie być w stanie zapewnić pomocy ani wsparcia technicznego przy migracjach z nieobsługiwanych forków.