Doctor
Overleaf Toolkit에는 디버깅에 유용한doctor 스크립트가 포함되어 있습니다. bin/doctor를 실행하면 호스트 환경, 구성, Toolkit에 필요한 의존성에 대한 정보가 출력됩니다. 이 출력은 Ayakaleaf Pro 설치의 문제를 진단하는 데에도 도움이 됩니다.
Overleaf Pro 사용자는 GitHub에 이슈를 등록할 수 있습니다.메시지에
bin/doctor 스크립트의 출력을 함께 첨부하는 것이 좋습니다.Doctor로 진단하기
doctor 스크립트를 실행합니다.Run doctor
전체 출력 예시
전체 출력 예시
호스트 정보
Host Information 섹션에는 Toolkit을 실행하는 머신에 대한 정보(예: Linux 배포판 및 릴리스)가 포함됩니다.
호스트 정보 출력 예시
호스트 정보 출력 예시
의존성
Dependencies 섹션에는 Toolkit이 작동하는 데 필요한 도구가 나열됩니다. 도구가 있으면 버전 정보와 함께 status: present로 표시됩니다. 없으면 status: MISSING!으로 표시되며 doctor 출력 하단에 경고가 추가됩니다.
의존성 출력 예시 (있음)
의존성 출력 예시 (있음)
의존성 출력 예시 (없음)
의존성 출력 예시 (없음)
구성
Configuration 섹션에는 config/ 디렉터리의 파일에 대한 정보가 포함됩니다. config/overleaf.rc의 경우 doctor는 몇 가지 주요 값을 출력합니다. 누락된 파일은 status: MISSING!으로 표시되며 doctor 출력 하단에 경고가 추가됩니다.
구성 출력 예시
구성 출력 예시
OVERLEAF_DATA_PATH가/tmp/overleaf로 설정되어 있는데, 이는 중요한 데이터를 저장하기에 안전한 위치가 아닐 수 있습니다.MONGO_ENABLED: false는 Toolkit이 자체 MongoDB를 프로비저닝하지 않는다는 의미입니다. 필요한 경우MONGO_URL이 외부에서 관리되는 MongoDB를 가리키는지 확인하세요.- 예시에서는
config/variables.env가 누락되어 있습니다.
경고
Warnings 섹션에는 doctor 스크립트가 발견한 문제가 요약됩니다. 문제가 없으면 이 섹션에 그 사실이 표시됩니다.
경고 출력 예시
경고 출력 예시
Q&A
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: 이 검사는 Server Pro 이미지가 비공개 quay.io 레지스트리에 있는 공식 Toolkit에서 비롯된 것입니다.SERVER_PRO=true이면 Toolkit은 공개 이미지인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은bin/doctor에서 버전을 출력할 때만perl을 사용하며,LANG또는LC_ALL이 호스트에 설치되지 않은 로캘을 지정하면 Perl이 경고를 표시합니다. 버전은 여전히 출력됩니다. 경고를 없애려면 이 변수들을locale -a에 나열된 로캘(예:C.UTF-8)로 설정하세요.
Docker daemon is not running, docker not found, Docker Compose not found 또는 config/의 파일 누락과 같은 경고는 반드시 수정해야 합니다. 이것들이 없으면 Toolkit을 시작할 수 없습니다.
