Doctor
Overleaf Toolkit постачається зі зручним скриптомdoctor, що допомагає в налагодженні. Запустіть bin/doctor, і скрипт виведе інформацію про ваше хост-середовище, вашу конфігурацію та залежності, потрібні Toolkit. Цей вивід також може допомогти нам діагностувати проблеми з вашими інсталяціями Ayakaleaf Pro.
Користувачі Overleaf Pro можуть створити issue на GitHub.Варто додати до свого повідомлення вивід скрипта
bin/doctor.Консультація з Doctor
Запустіть скрипт doctor:Run doctor
Приклад повного виводу
Приклад повного виводу
Інформація про хост
РозділHost Information містить відомості про машину, на якій працює Toolkit (наприклад, дистрибутив і випуск Linux).
Приклад виводу Host Information
Приклад виводу Host Information
Залежності
РозділDependencies містить перелік інструментів, необхідних для роботи Toolkit. Якщо інструмент наявний, його буде позначено як status: present з інформацією про версію. Якщо він відсутній, його буде позначено як status: MISSING!, а внизу виводу doctor з’явиться попередження.
Приклад виводу Dependency (наявний)
Приклад виводу Dependency (наявний)
Приклад виводу Dependency (відсутній)
Приклад виводу Dependency (відсутній)
Конфігурація
РозділConfiguration містить відомості про файли в каталозі config/. Для config/overleaf.rc doctor виводить деякі ключові значення. Відсутні файли буде позначено як status: MISSING!, а внизу виводу doctor з’явиться попередження.
Приклад виводу Configuration
Приклад виводу Configuration
OVERLEAF_DATA_PATH, встановлений у/tmp/overleaf, може бути небезпечним розташуванням для важливих даних.MONGO_ENABLED: falseозначає, що Toolkit не розгортатиме власну MongoDB; за потреби переконайтеся, щоMONGO_URLвказує на зовнішньо керовану MongoDB.- У прикладі відсутній
config/variables.env.
Попередження
РозділWarnings підсумовує проблеми, виявлені скриптом doctor. Якщо проблем немає, цей розділ про це повідомить.
Приклад виводу Warnings
Приклад виводу Warnings
Запитання й відповіді
Чи потрібно виправляти повідомлення від bin/doctor щодо quay.io, конфігурації Docker і локалі Perl?
Чи потрібно виправляти повідомлення від bin/doctor щодо quay.io, конфігурації Docker і локалі Perl?
Відповідь: Ні, усі три мають лише інформаційний характер.
bin/doctor лише виводить звіт і не зупиняє bin/up.logged in to quay.io: falseі попередженняServer Pro enabled, but not logged in to quay.io repository: ця перевірка походить з офіційного Toolkit, де образ Server Pro розміщено в приватному реєстрі quay.io. ІзSERVER_PRO=trueToolkit завантажуєghcr.io/ayaka-notes/overleaf-pro, який є публічним, тож вхід не потрібен. Ігноруйте це попередження.grep: /root/.docker/config.json: No such file or directory(або інший домашній каталог): перевірка quay.io шукаєquay.ioу цьому файлі. Docker створює його лише тоді, коли має налаштування для збереження, наприклад післяdocker login, тому на багатьох серверах його немає. Він не потрібен.perl: warning: Setting locale failed: Toolkit використовуєperlлише тут, уbin/doctor, щоб вивести його версію, а Perl попереджає, колиLANGабоLC_ALLвказують на локаль, не встановлену на хості. Версія все одно виводиться. Щоб приховати попередження, установіть для цих змінних локаль зі спискуlocale -a, наприкладC.UTF-8.
Docker daemon is not running, docker not found, Docker Compose not found або про відсутній файл у config/ справді потребують виправлення: без цього Toolkit не зможе запуститися.
