Passa al contenuto principale

JC4.1 - Aggiungere una rotta

In una frase. Per far arrivare le richieste a un servizio nuovo basta una rotta nel Gateway: gli altri servizi non si toccano.

Una rotta è una riga che dice: le richieste che cominciano così vanno a quel servizio. Stanno tutte in una classe sola, quindi chi vuole sapere cosa è raggiungibile da fuori guarda in un posto solo. Aggiungerne una vuol dire copiare quelle che ci sono.

  1. Dai un nome al servizio. È il nome con cui si iscrive al Monitor servizi: tutto maiuscolo, con i trattini, per esempio NUOVO-SERVICE. Sta in spring.application.name del servizio.

  2. Aggiungi la rotta nel Gateway. Apri GatewayConfig e copia una rotta esistente. Cambiano tre cose: il nome della rotta (nuovo-service), l'inizio dell'indirizzo (/api/nuovo/**) e la destinazione (lb://NUOVO-SERVICE). Restano uguali stripPrefix(2) e il filtro authenticationFilter: vanno messi sempre.

  3. Nel servizio non ripetere l'inizio dell'indirizzo. Il Gateway toglie /api/nuovo prima di inoltrare. Se la pagina chiama /api/nuovo/clienti, il servizio riceve /clienti.

  4. Fai controllare il lasciapassare anche al servizio. Prendi come modello la SecurityConfig di un servizio esistente. Il nome utente lo leggi dall'intestazione X-User-Id, che scrive il Gateway.

  5. Ricostruisci e riavvia solo il Gateway. I servizi già accesi non vanno fermati.

  6. Prova. Chiama /api/nuovo/... dall'app. Un 503 vuol dire che il servizio non è ancora iscritto al Monitor servizi. Un 404 vuol dire che la rotta c'è ma il servizio non ha quell'indirizzo.

  7. Aggiorna la tabella delle rotte in docs/architettura/riferimento/ARCHITETTURA-MICROSERVIZI.md.

Il server web dell'app non va toccato: manda già al Gateway tutto ciò che comincia per /api/. Serve una regola in più solo per i collegamenti che restano aperti a lungo.

Attenzione.
• Con un numero diverso da 2 in stripPrefix il servizio riceve indirizzi sbagliati.
• Senza authenticationFilter il servizio non riceve il nome utente, e chi chiama potrebbe scriverne uno a piacere.
• Un servizio raggiungibile senza passare dal Gateway non può fidarsi di X-User-Id.

Per chi sviluppa.
• File: backend/middleware/it_gsba_api_gateway/src/main/java/it/gsba/api_gateway/config/GatewayConfig.java.
• Verifica: nella cartella del Gateway ./mvnw -o clean package -DskipTests, vale solo BUILD SUCCESS.
• Anche in sviluppo l'app manda già al Gateway tutto ciò che comincia per /api.
• Prima di cambiare le regole di sicurezza del Gateway si dice cosa cambia e perché: una modifica piccola può spegnere i controlli.