Doktor
Overleaf Toolkit obsahuje praktický skriptdoctor, který pomáhá s laděním. Spusťte bin/doctor a skript vypíše informace o vašem hostitelském prostředí, vaší konfiguraci a závislostech, které Toolkit potřebuje. Tento výstup nám také může pomoci diagnostikovat problémy s vašimi instalacemi Ayakaleaf Pro.
Uživatelé Overleaf Pro mohou založit issue na GitHubu.Je dobré do zprávy přiložit výstup skriptu
bin/doctor.Konzultace s Doktorem
Spusťte skript doctor:Run doctor
Příklad úplného výstupu
Příklad úplného výstupu
Informace o hostiteli
SekceHost Information obsahuje informace o stroji, na kterém Toolkit běží (například distribuci a vydání Linuxu).
Příklad výstupu Host Information
Příklad výstupu Host Information
Závislosti
SekceDependencies uvádí nástroje, které Toolkit ke své činnosti potřebuje. Pokud je nástroj k dispozici, bude uveden jako status: present spolu s informací o verzi. Pokud chybí, bude uveden jako status: MISSING! a na konec výstupu doctor se přidá varování.
Příklad výstupu závislosti (k dispozici)
Příklad výstupu závislosti (k dispozici)
Příklad výstupu závislosti (chybí)
Příklad výstupu závislosti (chybí)
Konfigurace
SekceConfiguration obsahuje informace o souborech v adresáři config/. Pro config/overleaf.rc vypíše doctor některé klíčové hodnoty. Chybějící soubory budou uvedeny jako status: MISSING! a na konec výstupu doctor se přidá varování.
Příklad výstupu Configuration
Příklad výstupu Configuration
OVERLEAF_DATA_PATHnastavená na/tmp/overleafnemusí být bezpečným umístěním pro důležitá data.MONGO_ENABLED: falseznamená, že Toolkit nezřídí vlastní MongoDB; v případě potřeby zajistěte, abyMONGO_URLodkazovala na externě spravovanou MongoDB.- V příkladu chybí
config/variables.env.
Varování
SekceWarnings shrnuje problémy zjištěné skriptem doctor. Pokud žádné problémy nejsou, tato sekce to uvede.
Příklad výstupu Warnings
Příklad výstupu Warnings
Otázky a odpovědi
Je potřeba řešit hlášení o quay.io, konfiguraci Dockeru a locale Perlu z bin/doctor?
Je potřeba řešit hlášení o quay.io, konfiguraci Dockeru a locale Perlu z bin/doctor?
Odpověď: Ne, všechna tři jsou pouze informativní.
bin/doctor jen vypisuje zprávu, nezastavuje bin/up.logged in to quay.io: falsea varováníServer Pro enabled, but not logged in to quay.io repository: tato kontrola pochází z oficiálního Toolkitu, kde je image Server Pro v soukromém registru quay.io. SSERVER_PRO=truestahuje Toolkitghcr.io/ayaka-notes/overleaf-pro, který je veřejný, takže přihlášení není potřeba. Toto varování ignorujte.grep: /root/.docker/config.json: No such file or directory(nebo jiný domovský adresář): kontrola quay.io hledá v tomto souboruquay.io. Docker jej zapisuje, jen když má co uložit, například podocker login, takže na mnoha serverech chybí. Není potřeba.perl: warning: Setting locale failed: Toolkit používáperlpouze zde, vbin/doctor, k vypsání jeho verze, a Perl varuje, kdyžLANGneboLC_ALLuvádí locale, které na hostiteli není nainstalované. Verze se přesto vypíše. Chcete-li varování umlčet, nastavte tyto proměnné na locale uvedené vlocale -a, napříkladC.UTF-8.
Docker daemon is not running, docker not found, Docker Compose not found nebo chybějící soubor v config/ je naopak potřeba vyřešit: bez nich Toolkit nemůže nastartovat.
