Passa al contenuto principale

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, con true o false.
  • 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.