O Doctor
O Overleaf Toolkit vem com um prático scriptdoctor para ajudar na depuração. Execute bin/doctor e o script exibirá informações sobre o ambiente do host, sua configuração e as dependências de que o Toolkit precisa. Essa saída também pode nos ajudar a diagnosticar problemas nas suas instalações do Ayakaleaf Pro.
Os usuários do Overleaf Pro podem abrir uma issue no GitHub.É uma boa ideia incluir a saída do script
bin/doctor na sua mensagem.Consultando o Doctor
Execute o script doctor:Run doctor
Exemplo de saída completa
Exemplo de saída completa
Informações do host
A seçãoHost Information contém informações sobre a máquina que executa o Toolkit (por exemplo, a distribuição e a versão do Linux).
Exemplo de saída de Host Information
Exemplo de saída de Host Information
Dependências
A seçãoDependencies lista as ferramentas necessárias para o funcionamento do Toolkit. Se uma ferramenta estiver presente, ela será listada como status: present com informações de versão. Se estiver ausente, será listada como status: MISSING! e um aviso será adicionado ao final da saída do doctor.
Exemplo de saída de dependência (presente)
Exemplo de saída de dependência (presente)
Exemplo de saída de dependência (ausente)
Exemplo de saída de dependência (ausente)
Configuração
A seçãoConfiguration contém informações sobre os arquivos no diretório config/. Para config/overleaf.rc, o doctor exibe alguns valores importantes. Arquivos ausentes serão listados como status: MISSING! e um aviso será adicionado ao final da saída do doctor.
Exemplo de saída de Configuration
Exemplo de saída de Configuration
OVERLEAF_DATA_PATHdefinido como/tmp/overleafpode não ser um local seguro para dados importantes.MONGO_ENABLED: falsesignifica que o Toolkit não provisionará seu próprio MongoDB; certifique-se de queMONGO_URLaponte para um MongoDB gerenciado externamente, se necessário.config/variables.envestá ausente no exemplo.
Avisos
A seçãoWarnings resume os problemas descobertos pelo script doctor. Se não houver problemas, esta seção indicará isso.
Exemplo de saída de Warnings
Exemplo de saída de Warnings
Perguntas e respostas
As mensagens do bin/doctor sobre quay.io, configuração do Docker e locale do Perl precisam ser corrigidas?
As mensagens do bin/doctor sobre quay.io, configuração do Docker e locale do Perl precisam ser corrigidas?
Resposta: Não, as três são apenas informativas. O
bin/doctor apenas exibe um relatório; ele não impede o bin/up.logged in to quay.io: falsee o avisoServer Pro enabled, but not logged in to quay.io repository: essa verificação vem do Toolkit oficial, no qual a imagem do Server Pro fica em um registro privado do quay.io. ComSERVER_PRO=true, o Toolkit baixaghcr.io/ayaka-notes/overleaf-pro, que é pública, portanto nenhum login é necessário. Ignore esse aviso.grep: /root/.docker/config.json: No such file or directory(ou outro diretório home): a verificação do quay.io procuraquay.ionesse arquivo. O Docker só o grava quando tem configurações a salvar, por exemplo apósdocker login, por isso ele não existe em muitos servidores. Ele não é necessário.perl: warning: Setting locale failed: o Toolkit usa operlapenas aqui, nobin/doctor, para exibir a sua versão, e o Perl emite um aviso quandoLANGouLC_ALLindica um locale que não está instalado no host. A versão é exibida mesmo assim. Para silenciá-lo, defina essas variáveis com um locale listado porlocale -a, por exemploC.UTF-8.
Docker daemon is not running, docker not found, Docker Compose not found ou um arquivo ausente em config/ precisam ser corrigidos: o Toolkit não consegue iniciar sem eles.
