El Doctor
El Overleaf Toolkit incluye un práctico scriptdoctor que ayuda a depurar problemas. Ejecuta bin/doctor y el script mostrará información sobre tu entorno anfitrión, tu configuración y las dependencias que necesita el Toolkit. Esta salida también puede ayudarnos a diagnosticar problemas en tus instalaciones de Ayakaleaf Pro.
Los usuarios de Overleaf Pro pueden abrir un issue en GitHub.Es buena idea incluir la salida del script
bin/doctor en tu mensaje.Consultar al Doctor
Ejecuta el script doctor:Run doctor
Ejemplo de salida completa
Ejemplo de salida completa
Información del host
La secciónHost Information contiene información sobre la máquina que ejecuta el Toolkit (por ejemplo, la distribución y la versión de Linux).
Ejemplo de salida de Host Information
Ejemplo de salida de Host Information
Dependencias
La secciónDependencies enumera las herramientas necesarias para que el Toolkit funcione. Si una herramienta está presente, aparecerá como status: present junto con la información de su versión. Si falta, aparecerá como status: MISSING! y se añadirá una advertencia al final de la salida de doctor.
Ejemplo de salida de Dependency (presente)
Ejemplo de salida de Dependency (presente)
Ejemplo de salida de Dependency (ausente)
Ejemplo de salida de Dependency (ausente)
Configuración
La secciónConfiguration contiene información sobre los archivos del directorio config/. Para config/overleaf.rc, el doctor muestra algunos valores clave. Los archivos que falten aparecerán como status: MISSING! y se añadirá una advertencia al final de la salida de doctor.
Ejemplo de salida de Configuration
Ejemplo de salida de Configuration
- Un
OVERLEAF_DATA_PATHestablecido en/tmp/overleafpuede no ser una ubicación segura para datos importantes. MONGO_ENABLED: falsesignifica que el Toolkit no aprovisionará su propio MongoDB; si es necesario, asegúrate de queMONGO_URLapunta a un MongoDB gestionado externamente.- En el ejemplo falta
config/variables.env.
Advertencias
La secciónWarnings resume los problemas detectados por el script doctor. Si no hay problemas, esta sección lo indicará.
Ejemplo de salida de Warnings
Ejemplo de salida de Warnings
Preguntas y respuestas
¿Hay que corregir los mensajes de quay.io, de la configuración de Docker y de la configuración regional de Perl que muestra bin/doctor?
¿Hay que corregir los mensajes de quay.io, de la configuración de Docker y de la configuración regional de Perl que muestra bin/doctor?
Respuesta: No, los tres son informativos.
bin/doctor solo imprime un informe; no detiene bin/up.logged in to quay.io: falsey la advertenciaServer Pro enabled, but not logged in to quay.io repository: esta comprobación procede del Toolkit oficial, en el que la imagen de Server Pro está en un registro privado de quay.io. ConSERVER_PRO=true, el Toolkit descargaghcr.io/ayaka-notes/overleaf-pro, que es pública, por lo que no es necesario iniciar sesión. Ignora esta advertencia.grep: /root/.docker/config.json: No such file or directory(u otro directorio personal): la comprobación de quay.io buscaquay.ioen ese archivo. Docker solo lo escribe cuando tiene ajustes que guardar, por ejemplo después dedocker login, por lo que falta en muchos servidores. No es necesario.perl: warning: Setting locale failed: el Toolkit solo usaperlaquí, enbin/doctor, para imprimir su versión, y Perl muestra una advertencia cuandoLANGoLC_ALLindican una configuración regional que no está instalada en el host. La versión se imprime igualmente. Para silenciarla, establece estas variables en una configuración regional que aparezca enlocale -a, por ejemploC.UTF-8.
Docker daemon is not running, docker not found, Docker Compose not found o la falta de un archivo en config/ sí deben corregirse: el Toolkit no puede iniciarse sin ellos.
