Strumenti di sviluppo consigliati
Questi servizi opzionali non sono necessari per eseguire Overleaf, ma aiutano molto a sviluppare, fare debug ed esaminare i dati. Fanno tutti parte dell’ambiente di sviluppo, quindi non c’è nulla da aggiungere adocker-compose.yml. Dopo l’accesso al sito, il menu Dev tools nella sua barra di navigazione rimanda a quelli che il sito serve sui propri percorsi.
Grafana
Grafana è servito dal sito su/grafana/, tramite webpack-dev-server, quindi non gli serve una porta propria. La sua cartella Overleaf Develop contiene queste dashboard:

All services: lo stato di ogni servizio, l'host e le risorse usate da ogni servizio

Data flow: una modifica nel suo percorso da document-updater attraverso project-history fino a history-v1 e Mongo
/metrics dei servizi, mongodb-exporter, redis-exporter, cadvisor e node-exporter; Alloy invia i log di ogni container del progetto a Loki, dove li leggono i filtri Log search, Service e Log level delle dashboard. I loro dati vivono solo nei container, quindi ricrearli li svuota. cAdvisor gira in modalità privilegiata e legge /, /sys, i dati di Docker e il socket di containerd dell’host, in sola lettura; node-exporter legge / dell’host.
Le dashboard sono generate: modifica develop/grafana/make-dashboards ed eseguilo, invece di modificare i file JSON.
Mailpit
ConMAILPIT_ENABLED=true, web invia ogni email a Mailpit invece che a un vero server di posta, e la conferma dell’email è attiva (EMAIL_CONFIRMATION_DISABLED=false). Link di attivazione, inviti ai progetti, reimpostazioni della password e codici di conferma si possono quindi seguire dalla casella di posta.

Un'email di attivazione, un invito a un progetto, un codice di conferma e una reimpostazione della password in Mailpit
Mongo Express
Mongo Express mostra le collezioni del databasesharelatex e permette di visualizzare, modificare, importare ed esportare i loro documenti.

Le collezioni del database sharelatex in Mongo Express
RedisInsight
RedisInsight conserva le sue connessioni indevelop/data/redis-insight. La prima volta, scegli Connect existing database e inserisci l’host redis e la porta 6379.

RedisInsight connesso al servizio redis
Configurare Hoppscotch
Richieste API tramite proxy
Hoppscotch invia le richieste dal browser, che non può raggiungere i servizi tramite i loro nomi Docker. Il suo proxy, Proxyscotch, gira nella rete Docker ed è servito su/proxy dell’indirizzo di Hoppscotch. Apri http://localhost:9170, vai in Settings → Interceptor, scegli Proxy e imposta la Proxy URL su http://localhost:9170/proxy. L’impostazione resta nel browser.

L'impostazione Interceptor. Lo screenshot proviene da una configurazione precedente: usa http://localhost:9170/proxy come Proxy URL.

Importare le API dei servizi
develop/hoppscotch/openapi/ contiene un file OpenAPI per l’API interna di ogni servizio. In Hoppscotch, apri Collections → Import → Import from File e seleziona tutti i file in una volta. Ogni file diventa una collezione le cui richieste vanno all’indirizzo Docker del servizio. Gli stessi file sono mostrati nella sezione API dei servizi.
Problemi con CSRF


Aggiungere una Pre-Request

Aggiungere gli header della richiesta

Effettuare il login con gli strumenti API


