Doctor
Overleaf Toolkit zawiera przydatny skryptdoctor, który ułatwia debugowanie. Uruchom bin/doctor, a skrypt wyświetli informacje o środowisku hosta, Twojej konfiguracji oraz zależnościach wymaganych przez Toolkit. Te dane wyjściowe mogą również pomóc nam w diagnozowaniu problemów z Twoimi instalacjami Ayakaleaf Pro.
Użytkownicy Overleaf Pro mogą zgłosić problem na GitHub.Warto dołączyć do zgłoszenia wynik działania skryptu
bin/doctor.Konsultacja z Doctorem
Uruchom skrypt doctor:Run doctor
Przykład pełnych danych wyjściowych
Przykład pełnych danych wyjściowych
Informacje o hoście
SekcjaHost Information zawiera informacje o maszynie, na której działa Toolkit (na przykład dystrybucję i wydanie systemu Linux).
Przykładowe dane wyjściowe sekcji Host Information
Przykładowe dane wyjściowe sekcji Host Information
Zależności
SekcjaDependencies zawiera listę narzędzi wymaganych do działania Toolkit. Jeśli narzędzie jest obecne, zostanie oznaczone jako status: present wraz z informacją o wersji. Jeśli go brakuje, zostanie oznaczone jako status: MISSING!, a na końcu danych wyjściowych doctor pojawi się ostrzeżenie.
Przykładowe dane wyjściowe zależności (obecna)
Przykładowe dane wyjściowe zależności (obecna)
Przykładowe dane wyjściowe zależności (brakująca)
Przykładowe dane wyjściowe zależności (brakująca)
Konfiguracja
SekcjaConfiguration zawiera informacje o plikach w katalogu config/. W przypadku config/overleaf.rc doctor wyświetla niektóre kluczowe wartości. Brakujące pliki zostaną oznaczone jako status: MISSING!, a na końcu danych wyjściowych doctor pojawi się ostrzeżenie.
Przykładowe dane wyjściowe sekcji Configuration
Przykładowe dane wyjściowe sekcji Configuration
OVERLEAF_DATA_PATHustawione na/tmp/overleafmoże nie być bezpieczną lokalizacją dla ważnych danych.MONGO_ENABLED: falseoznacza, że Toolkit nie utworzy własnej instancji MongoDB; w razie potrzeby upewnij się, żeMONGO_URLwskazuje na zewnętrznie zarządzaną bazę MongoDB.- W przykładzie brakuje pliku
config/variables.env.
Ostrzeżenia
SekcjaWarnings podsumowuje problemy wykryte przez skrypt doctor. Jeśli nie ma żadnych problemów, sekcja to zasygnalizuje.
Przykładowe dane wyjściowe sekcji Warnings
Przykładowe dane wyjściowe sekcji Warnings
Pytania i odpowiedzi
Czy komunikaty dotyczące quay.io, konfiguracji Dockera i ustawień regionalnych Perla wyświetlane przez bin/doctor wymagają naprawy?
Czy komunikaty dotyczące quay.io, konfiguracji Dockera i ustawień regionalnych Perla wyświetlane przez bin/doctor wymagają naprawy?
Odpowiedź: Nie, wszystkie trzy mają charakter informacyjny.
bin/doctor jedynie wyświetla raport i nie zatrzymuje bin/up.logged in to quay.io: falseoraz ostrzeżenieServer Pro enabled, but not logged in to quay.io repository: to sprawdzenie pochodzi z oficjalnego Toolkit, w którym obraz Server Pro znajduje się w prywatnym rejestrze quay.io. PrzySERVER_PRO=trueToolkit pobiera obrazghcr.io/ayaka-notes/overleaf-pro, który jest publiczny, więc logowanie nie jest potrzebne. Zignoruj to ostrzeżenie.grep: /root/.docker/config.json: No such file or directory(lub inny katalog domowy): sprawdzenie quay.io szukaquay.iow tym pliku. Docker zapisuje go tylko wtedy, gdy ma ustawienia do zapisania, na przykład podocker login, więc na wielu serwerach go brakuje. Nie jest on potrzebny.perl: warning: Setting locale failed: Toolkit używaperltylko tutaj, wbin/doctor, aby wyświetlić jego wersję, a Perl ostrzega, gdyLANGlubLC_ALLwskazuje ustawienia regionalne, które nie są zainstalowane na hoście. Wersja i tak zostaje wyświetlona. Aby wyciszyć ostrzeżenie, ustaw te zmienne na ustawienia regionalne wymienione przezlocale -a, na przykładC.UTF-8.
Docker daemon is not running, docker not found, Docker Compose not found lub brakujący plik w config/ wymagają naprawy: bez tego Toolkit nie może się uruchomić.
