Passa al contenuto principale

JM3.2 - Controllare che sia andato tutto bene

In una frase. Dopo il clic si aspetta circa un minuto, poi si guarda lo stato dei servizi e si prova una cosa per ogni servizio aggiornato.

Il pulsante verde non basta. Dice che i servizi nuovi sono stati accesi, non che rispondono. Un servizio può partire e fermarsi subito dopo, per esempio perché non trova il suo archivio. Cinque minuti di controllo evitano che se ne accorga un utente il giorno dopo.

  1. Leggi la fine del lavoro di deploy. L'ultima cosa che scrive è l'elenco dei servizi con il loro stato. Subito dopo l'accensione è normale leggere «sta partendo».

  2. Aspetta circa un minuto. I servizi riaccesi devono avviarsi e iscriversi al Monitor servizi. Intanto l'app può mostrare «Errore server 503» sulle pagine che li usano. Non è un guasto: passa da solo. I servizi più grossi, come ADEnext e GPEnext, possono metterci un po' di più.

  3. Apri l'app ed entra. Se la pagina di accesso si apre e ti lascia entrare, l'app web e il Gateway rispondono.

  4. Prova una cosa per ogni servizio aggiornato.

    • SIGEAnext: apri una tabella con i dati del gestionale.
    • ADEnext: apri una schermata disegnata o un cruscotto.
    • GPEnext: chiedi una stampa in PDF.
    • Ponte col COBOL: apri una maschera storica.
  5. Se una prova non va, guarda chi manca. Sul server, la pagina del Monitor servizi elenca i servizi iscritti. Chi non c'è non è partito: il motivo è scritto nel suo registro. Vedi il libro JC - Gateway e Monitor servizi, pagina «JC3.1 - Vedere quali servizi sono accesi».

  6. Guarda che il resto non si sia mosso. I servizi che non erano cambiati devono risultare accesi da prima dell'aggiornamento. Se sono ripartiti anche loro, qualcosa li ha toccati: di solito un'impostazione cambiata.

Nota. Un servizio che si ferma viene riacceso da solo. Per questo un servizio a cui manca un'impostazione non resta spento: continua a ripartire a vuoto, e nell'elenco lo vedi tornare sempre «sta partendo».

Attenzione. L'errore 503 dopo un aggiornamento dura circa un minuto. Se dopo qualche minuto c'è ancora, e sempre sulla stessa funzione, quel servizio non è partito: vedi Se qualcosa non va.

Per chi sviluppa.
• Il lavoro di deploy finisce con docker compose ps: stati starting, healthy, unhealthy.
• Ogni servizio ha il suo controllo di stato (/actuator/health), che il compose interroga a intervalli. Il tempo concesso per partire va da 40 secondi (Monitor servizi) a 120 (ADEnext, GPEnext): devops/deploy/docker-compose.deploy.yml.
• Gateway, SIGEAnext, GPEnext e app web aspettano che il servizio da cui dipendono sia in salute (depends_on).
• Le porte interne rispondono solo dal server: il controllo di stato a mano si fa da lì.
• Riavvio automatico: restart: unless-stopped.