Dati persistenti
L’Overleaf Toolkit deve memorizzare dati persistenti, come i file necessari per compilare i progetti LaTeX e il contenuto del database MongoDB. Ciò avviene montando alcune directory della macchina host nei container Docker e scrivendo i dati in tali directory.Directory dei dati
Il containersharelatex richiede una directory in cui memorizzare i dati relativi alle compilazioni LaTeX. Questa directory è impostata con la variabile OVERLEAF_DATA_PATH in config/overleaf.rc.
Il container mongo, se abilitato, richiede una directory in cui memorizzare i file del database, e lo stesso vale per il container redis. Anche queste directory possono essere configurate in config/overleaf.rc.
Permessi dei file
Poiché Docker viene eseguito comeroot, le directory dei dati finiranno per essere di proprietà dell’utente root, anche se il Toolkit viene usato da un utente non root. Non è un problema, ma è bene saperlo se intendi modificare i dati persistenti dall’esterno dei container.
Posizione dei file di configurazione
Tutti i file di configurazione di proprietà dell’utente si trovano nella directoryconfig/.
Questa directory è esclusa dal sistema di controllo di versione git, quindi non verrà modificata aggiornando il codice del Toolkit. Il Toolkit non modificherà alcun dato nella directory config/ senza il tuo permesso.
Le modifiche ai file di configurazione non verranno applicate automaticamente ai container esistenti, nemmeno se il container viene fermato e riavviato (con
bin/stop e bin/start). Per applicare le modifiche, esegui bin/up: dietro le quinte, docker compose applicherà automaticamente le modifiche alla configurazione a un nuovo container. (Oppure esegui bin/up -d, se preferisci non collegarti ai log di Docker.)Il file overleaf.rc
Il file config/overleaf.rc contiene le impostazioni di configurazione di primo livello più importanti usate dal Toolkit. Contiene istruzioni che impostano variabili, nel formato: VARIABLE_NAME=value
Per una panoramica di tutte le opzioni di configurazione disponibili, consulta la nostra sezione sulle impostazioni.
Il file variables.env
Il file config/variables.env contiene le variabili d’ambiente che vengono caricate nel container sharelatex e usate per configurare i microservizi di Overleaf. Queste includono il nome dell’applicazione, mostrato nell’intestazione dell’interfaccia web, le impostazioni per l’invio di email e altre impostazioni premium come l’SSO da usare con Server Pro.
Per una panoramica di tutte le variabili d’ambiente disponibili, consulta la sezione Variabili d’ambiente.
Il file version
Il file config/version contiene il numero di versione dell’immagine Docker che verrà usata per creare l’istanza in esecuzione del tuo server Overleaf.
Le modifiche a questi file di configurazione non verranno applicate automaticamente ai container esistenti, nemmeno se il container viene fermato e riavviato (con
bin/stop e bin/start). Per applicare le modifiche, esegui bin/up e il Toolkit creerà automaticamente un nuovo container con le modifiche alla configurazione applicate.Il file docker-compose.override.yml
Se presente, il file config/docker-compose.override.yml verrà incluso nell’invocazione di docker compose. È utile per sovrascrivere configurazioni specifiche di Docker Compose.
Consulta la documentazione di docker-compose per maggiori dettagli.