JM2.3 - Accendere un servizio nuovo
In una frase. Un servizio nuovo si aggiunge con poche righe e senza toccare gli altri; prima del deploy, però, sul server deve esserci già quello che gli serve per partire.
Aggiungere un servizio non vuol dire rifare l'installazione. Ogni servizio è una scatola a sé, con un'etichetta che dice se va acceso. L'esempio più recente è GPEnext, il servizio delle stampe: a novembre 2026 è entrato fra quelli che la pipeline costruisce e accende.
Descrivi il servizio nello stack. Un blocco che dice da quale cartella del codice si costruisce, quali impostazioni legge e con quale etichetta si accende.
Dillo alla pipeline. L'etichetta va aggiunta all'elenco dei servizi da costruire e a quello dei servizi da accendere. Da quel momento il servizio ha anche la sua impronta: si ricostruisce solo quando cambia.
Prepara il server, prima del deploy. È il passo che si dimentica. Per GPEnext servono tre cose:
- l'archivio dei Modelli di stampa e il suo utente, creati una volta sul database. Le tabelle le crea il servizio da solo al primo avvio;
- nel file delle impostazioni le tre righe dell'archivio:
GPE_DB_URL,GPE_DB_USER,GPE_DB_PASSWORD; - le cartelle dei dati GPE sul server, leggibili dal servizio: dati, caratteri di stampa, catalogo dei modelli di base.
Dai una rotta al Gateway. Senza, le pagine non sanno come raggiungerlo: vedi il libro JC - Gateway e Monitor servizi, pagina «JC4.1 - Aggiungere una rotta».
Fai il deploy e controlla. Il servizio nuovo deve comparire acceso e in salute: vedi Controllare che sia andato tutto bene.
Attenzione. Se le righe dell'archivio mancano, GPEnext non parte e continua a riprovare a vuoto. Il resto del gestionale lavora come prima: non vanno solo le stampe.
Nota. Per importare i modelli del gestionale storico non basta che GPEnext sia acceso. Nella cartella dei dati GPE devono esserci i vecchi modelli, nella sottocartella local/model. Se manca, la finestra di importazione lo dice e non elenca niente: vedi il libro JK - GPEnext, pagina «JK6.1 - Importare i modelli legacy».
Per spegnere un servizio non basta togliere l'etichetta: il deploy non ferma i servizi usciti dall'elenco. Vanno fermati a mano, una volta. I loro dati restano.
Per chi sviluppa.
• Blocco del servizio: devops/deploy/docker-compose.deploy.yml, con profiles:. Pipeline: il profilo in PROFILI_CLASSICO e PROFILI_TUTTI, e una riga costruisci nel lavoro build:images di .gitlab-ci.yml.
• GPEnext: profilo gpe-next, che accende anche il servizio di impaginazione. Cartelle: GPE_DATA_DIR, GPE_FONT_DIR, GPE_CATALOGO_HOST_DIR. Passi completi in devops/deploy/README.md, paragrafo 3.7.
• L'Assistente dei dati ha i suoi passi nel paragrafo 3.6: senza le sue password il deploy si ferma prima di toccare qualunque servizio, e dice quale manca.
• Compose e pipeline sono file protetti: li modifica una persona, non un automatismo.