Outils de développement recommandés
Ces services optionnels ne sont pas nécessaires pour faire fonctionner Overleaf, mais ils aident beaucoup pour développer, déboguer et examiner les données. Tous font partie de l’environnement de développement : il n’y a rien à ajouter àdocker-compose.yml. Une fois connecté au site, le menu Dev tools de sa barre de navigation renvoie vers ceux que le site sert sur ses propres chemins.
Grafana
Grafana est servi par le site sur/grafana/, via webpack-dev-server, il n’a donc pas besoin de port propre. Son dossier Overleaf Develop contient ces tableaux de bord :

All services : l'état de chaque service, l'hôte et les ressources utilisées par chaque service

Data flow : une modification en route de document-updater vers history-v1 et Mongo en passant par project-history
/metrics des services, mongodb-exporter, redis-exporter, cadvisor et node-exporter ; Alloy envoie les logs de chaque conteneur du projet à Loki, où les filtres Log search, Service et Log level des tableaux de bord les lisent. Leurs données ne vivent que dans les conteneurs, donc les recréer les vide. cAdvisor s’exécute en mode privilégié et lit /, /sys, les données Docker et le socket containerd de l’hôte, en lecture seule ; node-exporter lit / de l’hôte.
Les tableaux de bord sont générés : modifiez develop/grafana/make-dashboards et exécutez-le, au lieu de modifier les fichiers JSON.
Mailpit
AvecMAILPIT_ENABLED=true, web envoie chaque e-mail à Mailpit au lieu d’un vrai serveur de messagerie, et la confirmation d’e-mail est activée (EMAIL_CONFIRMATION_DISABLED=false). Les liens d’activation, invitations de projet, réinitialisations de mot de passe et codes de confirmation peuvent alors être suivis depuis la boîte de réception.

Un e-mail d'activation, une invitation de projet, un code de confirmation et une réinitialisation de mot de passe dans Mailpit
Mongo Express
Mongo Express affiche les collections de la basesharelatex et permet d’afficher, modifier, importer et exporter leurs documents.

Les collections de la base sharelatex dans Mongo Express
RedisInsight
RedisInsight conserve ses connexions dansdevelop/data/redis-insight. La première fois, choisissez Connect existing database et saisissez l’hôte redis et le port 6379.

RedisInsight connecté au service redis
Configurer Hoppscotch
Requêtes API via le proxy
Hoppscotch envoie les requêtes depuis le navigateur, qui ne peut pas joindre les services par leurs noms Docker. Son proxy, Proxyscotch, s’exécute dans le réseau Docker et est servi sur/proxy de l’adresse de Hoppscotch. Ouvrez http://localhost:9170, allez dans Settings → Interceptor, choisissez Proxy et définissez la Proxy URL sur http://localhost:9170/proxy. Le réglage reste dans le navigateur.

Le réglage Interceptor. La capture d'écran provient d'une ancienne configuration : utilisez http://localhost:9170/proxy comme Proxy URL.

Importer les API des services
develop/hoppscotch/openapi/ contient un fichier OpenAPI pour l’API interne de chaque service. Dans Hoppscotch, ouvrez Collections → Import → Import from File et sélectionnez tous les fichiers en une fois. Chaque fichier devient une collection dont les requêtes vont à l’adresse Docker du service. Les mêmes fichiers sont présentés dans la section API des services.
Problèmes de CSRF


Ajouter un script de pré-requête

Ajouter les en-têtes de requête

Se connecter avec les outils d'API


