netgescon-day0/info_per_scambio.md

Ecco il prompt unico da dare all Agent DNS/Web per chiudere configurazione host, DNS e virtual host dei siti NetGescon.

Obiettivo operativo

• Rendere coerenti e raggiungibili in HTTPS i siti NetGescon usati oggi:
  • https://staging.netgescon.it
  • https://updates.netgescon.it
• Fare in modo che il nodo update pubblichi davvero gli endpoint distribution usati dal client update Laravel.

Prompt unico per Agent DNS/Web

Verifica e correggi l infrastruttura web/DNS di NetGescon con questi vincoli e test finali.

Contesto verificato

• La macchina interna di release/update risponde su 192.168.0.53.
• staging.netgescon.it oggi risponde correttamente in HTTPS.
• updates.netgescon.it oggi non ha un virtual host dedicato attivo su nginx, oppure punta a un istanza Laravel non allineata.
• Test eseguiti:
  • https://staging.netgescon.it/api/v1/distribution/health => HTTP 200
  • https://staging.netgescon.it/api/v1/distribution/updates/manifest?channel=free => HTTP 200, manifest versione 0.8.1
  • https://updates.netgescon.it/api/v1/distribution/health forzato verso 192.168.0.53 => HTTP 200 ma con risposta incoerente/vecchia
  • https://updates.netgescon.it/api/v1/distribution/updates/manifest?channel=free forzato verso 192.168.0.53 => HTTP 404
  • https://updates.netgescon.it/api/v1/distribution/updates/package?channel=free&file=netgescon-0.8.1.zip forzato verso 192.168.0.53 => HTTP 404

Lavori richiesti

1. DNS

• Verifica il record A/AAAA di staging.netgescon.it.
• Verifica il record A/AAAA di updates.netgescon.it.
• Se il nodo update deve stare sulla macchina interna 192.168.0.53, allinea DNS interno o split-horizon DNS in modo che updates.netgescon.it risolva correttamente verso quel nodo.
• Se esiste proxy esterno o reverse proxy, verifica che inoltri Host header e HTTPS correttamente.

1. Nginx / vhost

• Verifica i virtual host attivi in /etc/nginx/sites-available e /etc/nginx/sites-enabled.
• staging.netgescon.it deve avere il suo vhost dedicato e funzionante.
• Crea o correggi un vhost dedicato per updates.netgescon.it.
• Non lasciare updates.netgescon.it servito dal vhost di default o da un server_name diverso.
• Il vhost updates deve puntare all applicazione Laravel corretta che espone:
  • /api/v1/distribution/health
  • /api/v1/distribution/updates/manifest
  • /api/v1/distribution/updates/package

1. Laravel / env del nodo update

• Verifica che il document root punti a public/ della app corretta.
• Verifica che APP_URL del nodo update sia https://updates.netgescon.it.
• Verifica che routes/api.php sia registrato nel bootstrap dell app attiva.
• Verifica che storage/app/distribution/free/manifest.json esista sul nodo update corretto.
• Verifica che il package pubblicato esista e sia leggibile dal web server.

1. TLS

• Verifica certificato valido per staging.netgescon.it.
• Verifica certificato valido per updates.netgescon.it.
• Se necessario, rigenera o riallinea certificati e catena completa.

1. Output richiesto dall Agent

• Elenco file nginx modificati.
• Record DNS verificati/modificati.
• APP_URL e document root finali di staging e updates.
• Risultato finale dei test sotto.

Test finali obbligatori

• curl -k https://staging.netgescon.it/api/v1/distribution/health
• curl -k "https://staging.netgescon.it/api/v1/distribution/updates/manifest?channel=free"
• curl -k https://updates.netgescon.it/api/v1/distribution/health
• curl -k "https://updates.netgescon.it/api/v1/distribution/updates/manifest?channel=free"
• curl -k "https://updates.netgescon.it/api/v1/distribution/updates/package?channel=free&file=netgescon-0.8.1.zip" -I

Esito atteso

• staging.health = 200
• staging.manifest = 200
• updates.health = 200
• updates.manifest = 200
• updates.package = 200 oppure 302/304 se gestito da proxy/CDN, ma mai 404

Nota applicativa utile

• Su staging i valori target distribution sono:
  • NETGESCON_UPDATE_URL=https://updates.netgescon.it
  • NETGESCON_UPDATE_CHANNEL=free
  • NETGESCON_NODE_CODE=staging-01

Parte scadenze legacy avviata qui

• La tabella sorgente MDB e letta da parti_comuni.mdb -> Scadenze.
• Campi operativi gia verificati:
  • id_scadenza
  • Dt_scadenza
  • ora_scadenza
  • cod_stabile
  • Descriz_sintetica
  • Gest_ors
  • Natura
  • Rif_f24
  • Importo_f24
  • Richiede_pop_up
  • gg_anticipo
  • Pop_Up_dal
• Non usare Descriz_lunga.