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:
| Cosa dice | Esempi di nomi |
|---|---|
| Dove sono gli archivi e con quale utente | ADE_DB_URL, GPE_DB_URL, SIGEA_DB_URL, con i loro _USER e _PASSWORD |
| Come si controlla chi entra | AUTH_ENABLED, KEYCLOAK_BASE_URL, SSO_REDIRECT_ORIGINS |
| Dove sta il gestionale di sempre | SBH_HOST, SBH_PORT, SBH_ALLOWED_ORIGINS |
| Le cartelle dei dati per le stampe | GPE_DATA_DIR, GPE_FONT_DIR, GPE_CATALOGO_HOST_DIR |
| L'Assistente dei dati | SIGEAGENT_ENABLED e le sue password |
| Le porte da cui si entra | FRONTEND_PORT, GATEWAY_PORT |
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_ENABLEDva scritta, contrueofalse: 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.
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.
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).
Nessun commento