Migracja do S3
Od wersji v6.0.0 Ayakaleaf Pro nie korzysta już ze starszego magazynu
user_files, więc migracji wymagają tylko pliki szablonów i historia.Chętnie poznamy Twoje doświadczenia! Jeśli chcesz podzielić się z nami informacją, ile plików przeniosłeś, jaki był ich łączny rozmiar i jak długo trwała migracja, napisz na
ayaka@outlook.in .Wymagania
- Magazyn obiektów zgodny z S3, z którym można się komunikować — opcje opisano w #s3-setup
- Wolne miejsce na dysku do migracji istniejących danych, mniej więcej równe obecnemu rozmiarowi danych na dysku
- Okno serwisowe na przeprowadzenie właściwej migracji
- Pełna kopia zapasowa, w tym konfiguracji, umożliwiająca przywrócenie z niej systemu
Oszacuj miejsce na dysku potrzebne do migracji
Do obliczenia bieżącego zużycia dysku możemy użyćdu:
Katalogi historii mają już właściwą strukturę. Możesz przesłać je bezpośrednio z zamontowanego folderu źródłowego (bind mount), co nie wymaga dodatkowego miejsca na dysku.
Kroki migracji
Krok 0: zatrzymaj instancję
Musimy mieć pewność, że wszystkie pliki użytkowników i szablonów zostaną przeniesione. Najlepiej zatrzymać instancję, aby nie pominąć nowo przesłanych plików. Procedurę zatrzymania opisano w naszym przewodniku dotyczącym wykonywania spójnej kopii zapasowej.Krok 1: przekształć strukturę katalogów
Aby przesłać pliki szablonów do S3, musimy przekształcić ich strukturę katalogów. Filestore przechowuje pliki szablonów w jednym płaskim katalogu, na przykład<template-id>_v_1_pdf, a S3 używa <template-id>/v/1/pdf.
W poniższych przykładach do przechowywania plików w nowej strukturze katalogów używany jest katalog /srv/overleaf-s3-migration. Zastąp /srv/overleaf-bind-mount katalogiem hosta zamontowanym w /var/lib/overleaf. Polecenia kopiowania uruchom na hoście z uprawnieniami do odczytu i zapisu tych katalogów; kontener pozostaje zatrzymany.
Do przekształcenia struktury możemy użyć tar:
Krok 2: prześlij pliki
W zależności od preferencji do przesłania plików do magazynu obiektów zgodnego z S3 możesz użyć klienta S3 minio mc lub aws cli. aws cli- Zastąp
overleaf-template-files,overleaf-project-blobsioverleaf-chunksnazwami swoich bucketów S3. - Zastąp także
/srv/overleaf-bind-mountlokalną ścieżką bind mountu/var/lib/overleaf. Domyślnie jest to~/overleaf_datawe wdrożeniu opartym na docker-compose.yml i<toolkit-checkout>/data/overleafprzy korzystaniu z Toolkit.
Krok 3: uruchom instancję skierowaną na S3
Dodaj do konfiguracji wszystkie zmienne związane z S3, zgodnie z sekcją Przegląd zmiennych w przewodniku konfiguracji S3. Zachowaj bind mount katalogu danych: może on zawierać także klucze szyfrowania Zotero lub Mendeley, które nie są migrowane do S3.Pozostaw na miejscu bind mount dysku roboczego dla plików tymczasowych, zobacz Running Overleaf with an NFS filesystem w sekcji Rozwiązywanie problemów.
- czy można wyświetlać podgląd plików binarnych w edytorze
- czy można skompilować PDF z obrazami
- czy można przesyłać nowe pliki
Wycofanie zmian
Migrację można bezpiecznie wycofać, wykonując kroki w odwrotnej kolejności:- Zatrzymaj instancję
- Skopiuj pliki z powrotem, zamieniając kolejność źródła i celu
- Zapisz nowe pliki z powrotem w katalogu lokalnym, używając odwrotnego
transform - Uruchom ponownie instancję ze starą konfiguracją
Pierwsza transformacja usuwa folder najwyższego poziomu. Druga transformacja zmienia strukturę katalogów na płaską. Wzorce wildcards zapewniają, że wypakowywane są tylko pliki, a nie ich foldery nadrzędne (projektów).

