JM4.3 - Se qualcosa non va
In una frase. I problemi più comuni di un aggiornamento, come «vedo questo, faccio questo», e le parole da sapere.
Quando un aggiornamento non va, la domanda utile è: a che passo si è fermato? Prima del clic non è cambiato niente sul server. Dopo il clic, quasi sempre il problema è un servizio solo, e quasi sempre gli manca qualcosa per partire.
Per chi usa il gestionale
- Vedo «Errore server 503» subito dopo un aggiornamento. I servizi stanno ripartendo. Aspetta un minuto e riprova.
- Dopo qualche minuto l'errore c'è ancora, su una funzione sola. Quel servizio non è partito. Il resto puoi usarlo. Avvisa chi gestisce il server.
- Stavo lavorando in una maschera storica e la sessione si è chiusa. L'aggiornamento ha riacceso il Ponte col COBOL. Rientra: il lavoro non confermato va rifatto.
- Non vedo la funzione nuova. Ricarica la pagina. Se non c'è ancora, il pulsante del deploy forse non è stato premuto: la modifica è pronta ma non è sul server.
Per chi fa l'aggiornamento
- La pipeline non è partita. Parte solo quando la modifica entra nella versione principale. Su un ramo a parte non parte niente.
- Il build non ha ricostruito niente. È giusto, se la modifica non tocca nessun servizio: per esempio solo documentazione.
- Il deploy si ferma subito e nomina una password. Mancano le righe dell'Assistente dei dati nel file delle impostazioni. Non ha toccato nessun servizio: aggiungile e premi di nuovo.
- Ogni comando si ferma e chiede
AUTH_ENABLED. La riga è obbligatoria nel file delle impostazioni: scrivila, contrueofalse. - GPEnext torna sempre «sta partendo». Mancano le righe del suo archivio:
GPE_DB_URL,GPE_DB_USER,GPE_DB_PASSWORD. Oppure l'archivio non è stato creato. - GPEnext è acceso ma l'importazione dei vecchi modelli non elenca niente. Nella cartella dei dati GPE manca la sottocartella
local/model, o il servizio non la può leggere. - Un servizio che non avevo toccato è ripartito. È cambiata una sua impostazione, o un file che entra nella sua impronta.
- Ho tolto un servizio dall'elenco ma gira ancora. Il deploy non spegne chi esce dall'elenco: va fermato a mano.
- Un servizio dà 503 e non passa. Guarda sul server la pagina del Monitor servizi e il registro del servizio: vedi il libro JC - Gateway e Monitor servizi.
Se serve tornare alla versione di prima: Tornare indietro.
Parole da sapere
- Server di prova. L'installazione dove si guarda il lavoro prima di portarlo altrove. Oggi è l'unica tenuta aggiornata dalla pipeline.
- Versione principale. Il codice approvato, da cui si costruisce ciò che va sul server.
- Pipeline. La sequenza di passi automatici: test, build, deploy.
- Build. Preparare la versione nuova di un servizio. Non cambia ancora niente sul server.
- Deploy. Mettere la versione nuova al posto della vecchia. Parte con un clic.
- Impronta. Il segno che dice se il contenuto di un servizio è cambiato. Uguale: non si ricostruisce.
- Contenitore. La scatola chiusa in cui gira un servizio, con tutto ciò che gli serve.
- File delle impostazioni. Il file sul server con indirizzi, cartelle e password. Non sta nel codice.
- Migrazione. Un passaggio che cambia la forma di un archivio. Parte da solo all'avvio del servizio e va solo in avanti.
- Avviso. La voce che dice cosa fare dopo un cambiamento.
Per chi sviluppa. Registri e stato: docker compose ps e docker logs <contenitore> sul server. I passi operativi, con la verifica di ognuno, sono in devops/deploy/RUNBOOK-simil-prod.md.