Tutti gli articoli
12 min di lettura

Pattern di architettura d'integrazione: come scegliere quello giusto

Un ordinato pannello di centralino telefonico con due prese collegate da un solo cavetto, una campanella e una rastrelliera di caselle in legno vuote, con una singola spia ambrata sulla parete sul fondo.

Per un'azienda piccola o in crescita, il pattern d'integrazione giusto è il più semplice che sopravvive al tuo prossimo cambiamento. Collega direttamente due o tre sistemi stabili. Metti uno strato di API davanti ai sistemi che prevedi di far crescere. Usa una coda o un canale publish/subscribe (pub/sub) quando più sistemi devono reagire allo stesso evento, oppure quando un sistema lento non deve bloccare gli altri. Costruiamo queste connessioni per negozi online, CRM ed ERP, e gli errori che vediamo nascono dalla scelta di un pattern per moda invece che per la forma del problema.

In breve

  • Un pattern d'integrazione è un modo collaudato di collegare i sistemi. Le famiglie principali sono il trasferimento di file, la banca dati condivisa, le chiamate API dirette (richiesta/risposta) e la messaggistica.
  • Il point-to-point va benissimo per una manciata di sistemi stabili. Diventa costoso perché ogni nuovo sistema aggiunge altre connessioni.
  • L'integrazione a eventi, basata sul pub/sub, disaccoppia i sistemi: uno può guastarsi o cambiare senza rompere gli altri. In cambio è più difficile da analizzare quando qualcosa non va.
  • Scegli ponendoti cinque domande: quanti sistemi, chi ha bisogno di una risposta subito, quanto volume, cosa succede quando qualcosa si guasta e chi lo manterrà.
  • Quasi tutte le architetture reali mescolano più pattern. L'abilità sta nel sapere dove collocare ciascuno.

Che cos'è un pattern di architettura d'integrazione

Un pattern di architettura d'integrazione è una risposta riutilizzabile a un problema ricorrente: due o più applicazioni devono condividere dati o attivarsi a vicenda, e tu vuoi che continui a funzionare mentre l'azienda cambia. La guida all'architettura di Salesforce descrive i pattern come strategie per gli scenari d'integrazione più comuni e li suddivide in data integration, process integration and virtual integration. In parole semplici:

  • L'integrazione dei dati tiene allineata la stessa informazione fra più sistemi, per esempio le schede clienti nel tuo negozio online e nel tuo CRM.
  • L'integrazione dei processi fa girare un processo aziendale attraverso più applicazioni, per esempio ordine, pagamento, spedizione e fattura.
  • L'integrazione virtuale legge i dati da un altro sistema quando servono, invece di copiarli.

La stessa guida dice che la scelta giusta dipende da cosa sanno fare i sistemi, da quanti dati si spostano, da come vengono gestiti i guasti e dal fatto che i passaggi debbano riuscire o fallire insieme. È un buon punto di partenza per la tua decisione, e ci torniamo più avanti.

I quattro stili di base

Il riferimento classico, Enterprise Integration Patterns di Hohpe e Woolf, elenca four integration styles: trasferimento di file, banca dati condivisa, invocazione remota di procedure (un sistema ne chiama un altro direttamente) e messaggistica. Il loro punto è che non devi scegliere uno stile e usarlo ovunque. Scegli lo stile migliore per ogni singola integrazione.

Un elenco simile compare in un approfondimento tecnico sui sistemi distribuiti, che cita shared database, file transfer, synchronous request-response and asynchronous events. Lo stesso testo nota che chiamare un altro servizio via HTTP ti lega a quel servizio più di quanto faccia l'invio di un messaggio, perché devi conoscerne parecchio.

Stile Come funziona Uso tipico Rischio principale
Trasferimento di file Un sistema esporta un file, un altro lo importa Esportazioni notturne, reportistica, passaggio alla contabilità I dati sono sempre un po' vecchi
Banca dati condivisa Più applicazioni leggono e scrivono sulle stesse tabelle Sistemi legacy sotto lo stesso tetto Ogni modifica allo schema può rompere tutto per tutti
Richiesta/risposta (API) Un sistema ne chiama un altro e aspetta la risposta Verifica prezzi, conferma di pagamento, accesso Se il chiamato è fuori servizio, il chiamante resta bloccato
Messaggistica / eventi Un sistema invia un messaggio e prosegue Eventi d'ordine, notifiche, lavori in background Più parti in movimento, più difficile da tracciare

Point-to-point: semplice finché regge

Point-to-point significa che il sistema A parla direttamente con il sistema B. Un negozio online che invia gli ordini direttamente a un ERP è l'esempio di tutti i giorni. È rapido da costruire, facile da analizzare e non richiede infrastruttura aggiuntiva. Per due o tre sistemi con interfacce stabili è spesso la risposta corretta, e non proveremmo a dissuaderti.

Il problema è aritmetico. Ogni nuovo sistema può aver bisogno di una connessione verso tutti quelli già presenti, quindi il numero di collegamenti cresce molto più in fretta del numero di sistemi. Il corso sui microservizi di Confluent fa la stessa osservazione: each direct link is a form of coupling, e lunghe catene di chiamate dirette possono portare a guasti a cascata, dove un servizio lento trascina giù tutto ciò che dipende da lui.

Una regola pratica da una guida alla progettazione dei sistemi: il point-to-point è adatto a fewer than five systems or throwaway prototypes. Oltre quella soglia, di solito serve uno strato condiviso.

Hub-and-spoke e l'approccio guidato dalle API

Per uscire dal groviglio, molti team mettono qualcosa in mezzo. Le forme comuni sono due.

Hub-and-spoke (spesso un enterprise service bus, ESB) instrada e trasforma tutto attraverso un componente centrale. Le regole di conversione stanno in un unico posto, il che aiuta quando hai da 10 a 30 sistemi e un team d'integrazione centrale. Il prezzo è che l'hub diventa un punto unico di guasto e un collo di bottiglia per i cambiamenti: un errore in una trasformazione può toccare tutti i flussi che ci passano.

L'integrazione guidata dalle API avvolge ogni sistema dietro un'interfaccia chiara e documentata. Gli altri sistemi chiamano quell'interfaccia e non toccano mai le parti interne. Il vantaggio è che puoi sostituire il sistema dietro l'API, per esempio un ERP legacy, senza riscrivere tutti i consumatori. Per i progetti nuovi, le API in stile REST sono la scelta predefinita di quasi tutti i team. La debolezza è quella comune a tutte le chiamate sincrone: se l'API è fuori servizio, tutto ciò che la chiama resta in attesa.

Un'idea collegata è il modello di dati canonico, un unico formato condiviso verso cui e da cui tutti i sistemi convertono. Riduce la manutenzione man mano che i sistemi si moltiplicano, ma all'inizio richiede uno sforzo vero per essere progettato bene. Tienilo piccolo e copri solo i dati che attraversano davvero i confini fra sistemi.

Messaggistica: code e pub/sub

La messaggistica elimina l'attesa. Il mittente mette un messaggio su un canale e va avanti; il destinatario lo preleva quando è pronto. Ci sono due forme, e la differenza conta.

Code (messaggistica point-to-point)

In una coda, ogni messaggio va esattamente a un consumatore. La panoramica di IBM sui message broker porta l'esempio tipico: payroll and financial transactions, dove ogni pagamento deve essere inviato una volta sola. Le code sono anche un modo naturale per distribuire il lavoro fra più worker e per riprovare i lavori falliti. Non diffondono a tutti: se tre sistemi devono sapere dello stesso ordine, una coda semplice è lo strumento sbagliato.

Un'avvertenza vale per ogni coda. Pensala come un ammortizzatore per picchi brevi, not a hidden bottomless buffer che nasconde uno squilibrio permanente fra la velocità con cui il lavoro arriva e quella con cui viene elaborato. Se l'arretrato cresce e basta, hai un problema di capacità, non d'integrazione.

Publish/subscribe

Nel pub/sub, un sistema pubblica un evento su un topic e ogni abbonato ne riceve la propria copia. Chi pubblica non sa e non deve sapere quanti consumatori esistono. Aggiungere un nuovo consumatore, per esempio un flusso di analisi o un servizio di punti fedeltà, non richiede alcuna modifica a chi pubblica.

Coda (point-to-point) Pub/sub
Chi riceve un messaggio Un solo consumatore Tutti gli abbonati
Adatto a Lavori, compiti, pagamenti Notifiche, diffusioni, molte reazioni a un solo evento
Aggiungere un consumatore Divide il lavoro Aggiunge un altro ascoltatore, chi pubblica non cambia
Attenzione a Nessuna diffusione multipla Ordinamento e spazio di archiviazione crescono con gli abbonati

L'ultima riga viene da un not a hidden bottomless buffer, che nota come i topic offrano un vero disaccoppiamento ma rendano più difficili le garanzie di ordinamento e facciano crescere l'archiviazione con il numero di abbonati.

Integrazione a eventi

L'integrazione a eventi è il pub/sub applicato a tutta l'azienda. I sistemi emettono eventi ("ordine effettuato", "fattura pagata", "scorte basse") e altri reagiscono. La pagina informativa svizzera di SAP descrive i pezzi in gioco: i produttori inviano eventi in tempo reale e un event broker acts like a central switch che gestisce i canali, garantisce la consegna e disaccoppia produttori e consumatori, spesso con filtraggio, memorizzazione e riproduzione degli eventi.

Proprio quest'ultima funzione rende le architetture a eventi più tolleranti. Se un sistema a valle resta offline per un'ora, gli eventi aspettano e vengono elaborati al suo ritorno, invece di andare persi o bloccare il mittente. Permette anche di collegare un sistema legacy in modo graduale, pubblicando i suoi cambiamenti come eventi mentre intorno crescono i servizi nuovi.

Gregor Hohpe aggiunge una precisazione utile: il basso accoppiamento comes from the publish-subscribe channel, not from events themselves. Se tutti i consumatori dipendono dalla forma esatta di un evento, hai solo spostato l'accoppiamento. Progetta gli eventi come contratti stabili e modificali con cautela.

Quanto ti costa

I sistemi a eventi non sono gratis. In una guida pratica alla comunicazione a eventi, l'autore fa notare che never know exactly who received an event, che il debug diventa un lavoro da investigatore e che i cambiamenti di schema vanno coordinati con tutti i consumatori. Mettilo in conto dal primo giorno:

  • Dai a ogni evento un identificativo unico e una marca temporale, così puoi tracciarlo.
  • Rendi i consumatori idempotenti, cioè elaborare due volte lo stesso evento non deve fare danni. I duplicati capitano.
  • Predisponi una dead-letter queue, un'area di parcheggio per i messaggi che falliscono ripetutamente, e qualcuno che la controlli.
  • Versiona i formati dei tuoi eventi.

L'introduzione di Enterprise Integration Patterns è sincera sugli altri svantaggi della messaggistica asincrona: un more complex programming model, sequencing issues and overhead for bulk data. Sono buoni motivi per applicarla dove rende, non ovunque.

I pattern a confronto

Un confronto fra stili di interoperabilità li valuta su accoppiamento, tipo di interazione, complessità e scalabilità. Riassunto per un piccolo team, sulla base di that comparison, risulta così:

Pattern Accoppiamento Interazione Complessità di realizzazione Scalabilità
Point-to-point Molto alto Sincrona Bassa Si complica con la crescita dei sistemi
ESB / hub Basso, tramite il bus Qualsiasi Alta Complessa
Gateway API Medio Prevalentemente sincrona Media Buona
Message broker / eventi Basso, tramite gli eventi Asincrona Alta Eccellente

Lo schema è chiaro: più indipendenza vuoi fra i sistemi, più infrastruttura e disciplina ti assumi. Questo scambio è tutto il tema.

Esempi per una piccola impresa tipo

I nomi dei pattern sono astratti, quindi ecco tre situazioni che incontriamo spesso nelle PMI e nelle startup svizzere.

Negozio online verso ERP. Gli ordini devono arrivare all'ERP e le giacenze devono tornare indietro. Con un negozio e un ERP, una connessione API diretta è ragionevole. Se più avanti aggiungi un marketplace e un secondo magazzino, metti uno strato d'integrazione fra loro prima di aggiungere il terzo collegamento diretto. Il lato ERP ha le sue opzioni; ERP integration approaches spiega in cosa si distinguono le principali.

Ordine effettuato, cinque cose che succedono. Email di conferma, fattura, prelievo in magazzino, aggiornamento del CRM, punti fedeltà. Qui il pub/sub calza: il negozio pubblica "ordine effettuato" una volta sola e ogni sistema a valle si abbona. Aggiungere più tardi una sesta reazione non tocca il negozio.

Conferma di pagamento alla cassa. Il cliente è lì che aspetta, quindi ti serve una risposta adesso. Questa è una chiamata sincrona richiesta/risposta, anche se tutto il resto intorno è asincrono. Abbinare i due stili è normale: l'integrazione a eventi deve convivere con quella basata su API, non sostituirla.

Come scegliere: cinque domande

Usale in quest'ordine. Fermati alla prima risposta che risolve la questione.

  1. Quanti sistemi, oggi e fra due anni? Meno di cinque e stabili: il point-to-point va bene. Da dieci a trenta con un team centrale: un hub o uno strato di API. Molti di più, con team che gestiscono i propri servizi: una dorsale a eventi, secondo le fewer than five systems or throwaway prototypes citate sopra.
  2. Chi chiama ha bisogno di una risposta immediata? Se sì, e la catena di dipendenze è corta, chiama in modo sincrono. Se no, invia un messaggio.
  3. Quanto è irregolare il carico? Code ed eventi assorbono i picchi, per esempio una giornata di campagna o la chiusura di fine mese, che travolgerebbero una chiamata diretta.
  4. Cosa succede quando un sistema è fuori servizio? Se l'azienda non può permettersi dati persi o in ritardo, usa la messaggistica con tentativi ripetuti e riproduzione. Se un guasto breve è accettabile, le chiamate dirette sono più semplici.
  5. Chi lo farà funzionare? Le architetture a eventi richiedono monitoraggio e qualcuno che le capisca. Un pattern che il tuo team non sa gestire è il pattern sbagliato, per quanto elegante.

E una sesta regola, non scritta: non progettare per 30 sistemi quando ne hai tre. Costruisci la versione più semplice che abbia una giuntura pulita dove poter innestare il pattern successivo.

Dove un ingegnere senior cambia il risultato

I progetti d'integrazione di solito vanno storti ai margini: un requisito cambia a metà strada, la persona che capiva l'ERP se ne va, oppure una connessione veloce si irrigidisce in una dipendenza che nessuno osa toccare. Ampersand è un piccolo studio di Zurigo e in ogni progetto gli ingegneri senior restano coinvolti dalla prima consulenza fino alla consegna, così chi sceglie il pattern è anche chi lo porta fino in fondo.

Realizziamo integrazioni di sistemi e collegamenti via API per negozi online, CRM ed ERP, e ci occupiamo di replatforming e migrazione di sistemi legacy. La nostra pagina dei prezzi indica il lavoro d'integrazione come singola connessione o come pacchetto completo, e un piano Run & monitor a 750 CHF al mese per mantenere in salute le integrazioni dopo il lancio. Se non sei sicuro di quale pattern faccia al caso tuo, la nostra attività di consulenza e audit nasce esattamente per questa domanda. Guarda le opzioni di integrazione e migrazione sulla nostra pagina dei prezzi, oppure parti da ampersand.ch.

Domande frequenti

Qual è la differenza fra pub/sub e point-to-point?

Nella messaggistica point-to-point, ogni messaggio viene consumato da un solo destinatario, come nel caso di un ordine di pagamento che va eseguito una volta sola. Nel pub/sub, un messaggio pubblicato su un topic viene consegnato a payroll and financial transactions. Usa il primo per i compiti e il secondo per le diffusioni, dove più sistemi reagiscono allo stesso evento.

L'integrazione a eventi è sempre meglio delle API?

No. È adatta alle reazioni in tempo reale, ai picchi di carico e ai casi con più consumatori per evento. Tutto ciò in cui chi chiama deve attendere una risposta, come una conferma di pagamento, resta compito di un'API sincrona. Quasi tutte le architetture sane usano entrambe.

Quando basta il point-to-point?

Quando colleghi un numero ridotto di sistemi stabili, grosso modo meno di cinque, oppure quando costruisci un prototipo che prevedi di sostituire. Tieni le connessioni documentate e dietro un'interfaccia chiara, così potrai introdurre più tardi uno strato condiviso senza riscrivere tutto.

Con quale pattern dovrebbe iniziare una startup?

Comincia con chiamate API dirette fra i tuoi pochi sistemi centrali e aggiungi una coda dove il lavoro può essere svolto in background, per esempio email o generazione delle fatture. Introduci il pub/sub quando un secondo o un terzo sistema deve reagire allo stesso evento.

Fonti

Parliamone

Hai un progetto che tocca questo tema?

Una chiamata gratuita di 10 minuti è il modo più rapido per capire se siamo lo studio giusto.

Prenota una chiamata gratuita di 10 min