# JM2.2 - Il file delle impostazioni

**In una frase.** Tutto ciò che cambia da un'installazione all'altra, comprese le password, sta in un solo file sul server, fuori dal codice.

Il codice è uguale per tutti. Quello che cambia da un server all'altro sono gli indirizzi, le cartelle e le password. Se stessero nel codice, chiunque lo legga li vedrebbe, e ogni installazione vorrebbe una copia diversa del programma. Per questo stanno in un file a parte, che vive solo sul server.

Nel codice c'è il **modello** del file: l'elenco dei nomi, con le spiegazioni e senza i valori. Sul server c'è la **copia compilata**, con i valori veri. La pipeline e i servizi leggono quella.

Dentro trovi, per gruppi:

<table id="bkmrk-cosa-dice-esempi-di-"><thead><tr><th>Cosa dice</th><th>Esempi di nomi</th></tr></thead><tbody><tr><td>Dove sono gli archivi e con quale utente</td><td>`ADE_DB_URL`, `GPE_DB_URL`, `SIGEA_DB_URL`, con i loro `_USER` e `_PASSWORD`</td></tr><tr><td>Come si controlla chi entra</td><td>`AUTH_ENABLED`, `KEYCLOAK_BASE_URL`, `SSO_REDIRECT_ORIGINS`</td></tr><tr><td>Dove sta il gestionale di sempre</td><td>`SBH_HOST`, `SBH_PORT`, `SBH_ALLOWED_ORIGINS`</td></tr><tr><td>Le cartelle dei dati per le stampe</td><td>`GPE_DATA_DIR`, `GPE_FONT_DIR`, `GPE_CATALOGO_HOST_DIR`</td></tr><tr><td>L'Assistente dei dati</td><td>`SIGEAGENT_ENABLED` e le sue password</td></tr><tr><td>Le porte da cui si entra</td><td>`FRONTEND_PORT`, `GATEWAY_PORT`</td></tr></tbody></table>

Tre regole valgono sempre.

- **Nel modello un valore vuoto è un segreto.** Va chiesto a chi gestisce il server e scritto solo nella copia sul server. Nel modello non si scrive mai un valore vero.
- **Alcune righe sono obbligatorie.** `AUTH_ENABLED` va scritta, con `true` o `false`: se manca, ogni comando si ferma e dice cosa manca. Spegnere il controllo di chi entra deve essere una scelta scritta, non una dimenticanza.
- **Una riga cambiata vale dal deploy successivo.** Il servizio che la legge viene riacceso con il valore nuovo. Gli altri restano accesi.

<p class="callout warning">**Attenzione.** Questo file non entra mai nel codice, in una chat o in un documento. Se serve mostrarlo a qualcuno, si mostrano i nomi, non i valori.</p>

<p class="callout info">**Per chi sviluppa.**  
• Il modello è `devops/deploy/env.simil-prod.example`. Il registro di tutte le variabili, con il significato e il valore predefinito, è `docs/devops/ENVIRONMENT.md`: ha anche l'elenco dei controlli da fare prima di un deploy.  
• Quali servizi si accendono non sta in questo file: lo decide la pipeline. Una variabile d'ambiente del lavoro vince sul file.  
• Una variabile nuova si aggiunge insieme: al modello, al registro e agli avvisi (vedi [Avvisi per chi aggiorna](https://gsdoc.genesyssoftware.eu/link/37917)). </p>