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 будет добавлено предупреждение.
Пример вывода зависимости (установлена)
Пример вывода зависимости (установлена)
Пример вывода зависимости (отсутствует)
Пример вывода зависимости (отсутствует)
Конфигурация
Раздел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
Вопросы и ответы
Нужно ли исправлять сообщения о quay.io, конфигурации Docker и локали Perl от bin/doctor?
Нужно ли исправлять сообщения о quay.io, конфигурации Docker и локали Perl от bin/doctor?
Ответ: Нет, все три носят информационный характер.
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 не сможет запуститься.
