Przed każdą aktualizacją do nowej wersji głównej koniecznie wykonaj spójną kopię zapasową, aby w razie potrzeby móc przywrócić poprzedni stan.
bin/upgrade i postępować zgodnie z instrukcjami wyświetlanymi na ekranie.
Warto zauważyć, że wersja obrazu Docker (w config/version) jest zarządzana niezależnie od aktualizacji kodu Toolkit. Aktualizacja kodu Toolkit nie zmieni automatycznie wersji uruchomionego obrazu Docker. Oznacza to, że w większości przypadków możesz zaktualizować Toolkit bez aktualizowania wdrożenia.
Skrypt bin/upgrade
Po uruchomieniu polecenia bin/upgrade skrypt sprawdzi, czy dostępna jest aktualizacja kodu Toolkit, i zaproponuje aktualizację. Zawsze możesz odmówić — nic się wtedy nie zmieni.
Jeśli zdecydujesz się zaktualizować kod Toolkit, skrypt sprawdzi następnie, czy zmieniła się domyślna wersja obrazu Docker, i zaproponuje aktualizację lokalnego pliku wersji (w config/version) do nowej wartości domyślnej.
Jeśli zdecydujesz się zmienić wersję, skrypt przeprowadzi Cię przez proces zatrzymania usług Docker, wykonania kopii zapasowej i ponownego uruchomienia usług Docker. Stary plik wersji zostanie automatycznie skopiowany do config/__old-version na wypadek, gdybyś musiał wrócić do tej wersji obrazów Docker.
W przypadku środowisk odizolowanych (air-gapped), w których obrazy Docker importuje się ręcznie, ustaw
PULL_BEFORE_UPGRADE=false w pliku config/overleaf.rc.Więcej informacji o wdrażaniu w środowiskach odizolowanych/offline znajdziesz tutaj.