Differenza tra Paved Road, Golden Path, Guardrail e Railroad

Questo articolo è stato pubblicato in origine su The New Stack.

Paved road, golden path, guardrail: sono tutti pezzi dello stesso puzzle. In sostanza, sono raccolte di best practice, regole, strumenti e limiti stabiliti dai platform engineer per aiutare gli sviluppatori a lavorare in modo rapido e sicuro, riducendo al minimo il carico cognitivo.

Sebbene questi termini possano inizialmente sembrare sinonimi e siano spesso utilizzati come tali, il loro scopo e il grado di orientamento specifico differiscono. Utilizzati insieme, possono operare in un quadro più ampio, come una vera e propria rete ferroviaria (Railroad framework).

Paved Road: il vostro percorso di sviluppo standard

Considerate una strada frequentemente percorsa dalle auto dirette verso una destinazione specifica. La sua familiarità la rende l’opzione preferita e standardizzata per gli automobilisti. È semplice e presenta una segnaletica chiara, percorsi e uscite consigliati per rendere l’intero percorso sicuro ed efficiente e impedire ai guidatori di commettere errori.

Analogamente, immaginiamo che i platform engineer definiscano percorsi fluidi e consigliati per gli sviluppatori. Questi percorsi sono proprio le paved road (strade asfaltate) e fanno riferimento a set di strumenti, pratiche e processi standardizzati, noti e ben documentati, progettati per semplificare l’intero ciclo di vita della distribuzione del software (SDLC).

Le paved road rappresentano percorsi battuti all’interno di una internal developer platform (IDP) che guidano i team di sviluppo attraverso la complessità, dalla codifica alla distribuzione e al monitoraggio.

L’obiettivo principale è migliorare l’efficienza, la collaborazione e la qualità complessiva stabilendo un framework comune e garantendo un approccio coerente in tutta l’organizzazione. Alcuni esempi di paved road includono documentazione e linee guida dettagliate, protocolli e strategie, modelli già pronti e dashboard intelligenti.

Paved Road: benefici e insidie 

Le paved road avvantaggiano gli sviluppatori attraverso tutte le fasi del SDLC con:

• Standardizzazione: La coerenza tra strumenti, pratiche e processi nei vari team consente una maggiore armonia e riduce le probabilità di frammentazione.
• Flussi di lavoro ottimizzati: Le paved road definiscono passaggi chiari e incorporano best practice che riducono al minimo vaghezze e ridondanze, ottimizzando al contempo l’esperienza dello sviluppatore e preservando la velocità.
• Autonomia: Le paved road sono raccomandazioni, quindi offrono un percorso. Gli sviluppatori possono adattare tali suggerimenti in base alle proprie esigenze. In sostanza, gli sviluppatori effettuano scelte all’interno di un percorso definito, garantendo autonomia.
• Cooperazione: Gli sviluppatori sono consapevoli di utilizzare gli stessi strumenti e di attenersi alle stesse pratiche. Questo facilita la condivisione delle conoscenze e promuove una solida cultura di gruppo.

Tuttavia, le sfide sono dietro l’angolo senza un’adeguata implementazione:

• Cattive abitudini: Le paved road, pur garantendo standardizzazione e flussi di lavoro semplificati, a volte possono formalizzare comportamenti degli sviluppatori esistenti e potenzialmente inefficienti, perpetuando cattive abitudini.
• Spostamento dei punti dolenti: Se progettate male, le paved road potrebbero trasferire i punti critici dagli sviluppatori al platform team, complicando eccessivamente le cose.

Le paved road nascono da Netflix. Netflix utilizza una combinazione di norme culturali e strumenti specifici per standardizzare lo sviluppo, in particolare per la sua vasta architettura di microservizi basata su Amazon Web Services (AWS). Ciò include pipeline standardizzate, moduli riutilizzabili e modelli che promuovono la coerenza nella creazione e nell’utilizzo di soluzioni altamente disponibili e sicure.

Golden Path: percorsi curati per portare a termine lo sviluppo

Restiamo sull’analogia con la strada. Pensiamo a un’autostrada perfettamente costruita: strade ampie, corsie ben separate, segnaletica ben visibile.

Gli automobilisti non hanno nemmeno bisogno di pianificare il percorso migliore, perché devono semplicemente seguire la strada. Hanno a disposizione il modo più efficiente e personalizzato per raggiungere una destinazione, come se fossero guidati da un percorso GPS predeterminato e ottimale.

Allo stesso modo, i golden path (sentieri dorati) si riferiscono a percorsi predefiniti, specifici per un’attività e integrati per la creazione di software. Rappresentano strumenti coerenti, codice integrato e funzionalità che aiutano gli sviluppatori ad accelerare lo sviluppo dei progetti.

Gli sviluppatori implementano percorsi curati e appositamente scelti per svolgere un’attività specifica. Ciò si traduce in un processo decisionale semplificato, consentendo loro di concentrarsi sulla creazione dell’applicazione migliore entro i tempi previsti. Un esempio potrebbe essere la specifica delle versioni esatte di librerie, database e componenti chiave da utilizzare per un tipo specifico di applicazione. Controlli di qualità, conformità e requisiti di audit sono integrati per ridurre il carico di lavoro degli sviluppatori e consentire la corretta implementazione dei golden path. 

Golden Path: benefici e limiti

In generale, i golden path garantiscono prestazioni migliori, maggiore coerenza e un’esperienza complessiva ottimizzata per gli sviluppatori. Ecco alcuni vantaggi:

• Regolativi: I golden path forniscono agli sviluppatori metodi chiari e specificamente progettati, semplificando il processo decisionale.
• Supporto dietro le quinte: Un platform team seleziona e mantiene attivamente golden path per guidare on demand e risolvere rapidamente problemi.
• Specificità: I golden path sono pensati appositamente per raggiungere obiettivi di sviluppo specifici, ad esempio la creazione di un backend o di un servizio mobile, riducendo così l’ambiguità.
• Riduzione del carico cognitivo: Percorsi ben definiti possono astrarre le complessità, consentendo agli sviluppatori di concentrarsi su funzionalità specifiche.
• Accesso self-service: Gli sviluppatori possono scoprire e utilizzare moduli e componenti autonomamente tramite l’internal developer portal.
• Flessibilità: Gli sviluppatori possono discostarsi dal percorso predefinito, ma sono consapevoli che seguire le best practice più diffuse li aiuta ad accelerare l’intero processo.

Sfortunatamente, anche i golden path presentano delle criticità: 

• Gabbie dorate: Scelte progettuali scadenti o regole eccessivamente prescrittive possono ostacolare l’innovazione o limitare l’uso di strumenti specializzati.
• Manutenzione continua: Il supporto costante richiede aggiornamenti regolari per evitare di consolidare pratiche obsolete o dipendenze inaffidabili.
• Complicazione eccessiva: Alcune attività non richiedono necessariamente una guida regolativa passo passo. Implementare golden path inutilmente può complicare eccessivamente i processi anziché semplificarli.

L’origine dei golden path risale a Spotify, che per la prima volta li menzionò in relazione al suo portale, Backstage.

Backstage funge da hub centrale per i golden path di Spotify, offrendo modelli software per vari progetti (servizi backend, siti web, pipeline di dati). Questo fornisce un modo regolarizzato e supportato ufficialmente per avviare nuovi progetti, automatizzando costantemente i processi comuni per semplificare la documentazione, l’onboarding e lo sviluppo.

Guardrail: mantenete la vostra spedizione software in carreggiata

Pensate ai guardrail come a barriere fisiche lungo una strada che impediscono a un veicolo di uscire dal tracciato o di deviare in aree pericolose.

I guardrail sono limitazioni, linee guida, regole o confini architetturali stabiliti dagli enterprise architect per guidare gli sviluppatori. Rappresentano le barriere di sicurezza lungo paved road e golden path, impedendo agli sviluppatori di deviare accidentalmente in territori pericolosi o di commettere errori che potrebbero causare danni.

In sostanza, i guardrail forniscono un ulteriore livello di controllo proattivo e automatico per garantire il rispetto delle policy e delle best practice consolidate. In questo modo, le attività di sviluppo rimangono entro limiti accettabili di rischio, conformità e operatività, senza ostacolare l’innovazione.

Esempi di guardrail includono controlli automatizzati, strumenti, avvisi o documentazione estesa. Un guardrail potrebbe impedire a uno sviluppatore di distribuire un’applicazione con vulnerabilità di sicurezza note. Potrebbe anche avere a che fare con la convalida di script che impostano i controlli prima che le modifiche vengano applicate. Oppure, potrebbe fornire un contesto pertinente per alimentare gli agenti di intelligenza artificiale.

Guardrail: misure protettive o nessuna via d’uscita?

Proprio come le barriere sulla strada vi aiutano a rimanere in carreggiata, i guardrail aiutano a evitare insidie, configurazioni errate e azioni che portano a vulnerabilità o instabilità. Alcuni vantaggi includono:

• Creatività al sicuro: Gli sviluppatori sono liberi di testare e provare nuove soluzioni entro limiti definiti. La loro sete di innovazione è regolata da controlli automatizzati che sostituiscono il monitoraggio manuale.
• Rinforzo proattivo: I guardrail, implementati tramite everything as code (EaC) e policy as code (PoC), rafforzano la conformità e le politica di sicurezza, mitigando rischi ed errori e accelerando le distribuzioni sicure e self-service.
• Automazione: In caso di modifiche, i guardrail consentono una rapida individuazione e convalida. I controlli automatici fungono da filtri che consentono una rapida identificazione e risoluzione dei problemi.

Ma che dire dell’iperprotezione o delle misure di protezione mal implementate?

• Implementazione attenta: I guardrail mal configurati o obsoleti possono introdurre rischi o rafforzare una fiducia mal riposta.
• Nessuna via d’uscita: Guardrail eccessivamente rigidi possono far sentire gli sviluppatori soffocati, limitando i loro sforzi di innovare.
• Complessità di integrazione: Per essere efficienti, i guardrail necessitano di un’integrazione fluida nelle pipeline CI/CD. L’integrazione può rallentare a causa di toolchain complesse, tecnologie eterogenee, compartimenti stagni, mancanza di maturità organizzativa o lacune nelle competenze.
• Resistenza culturale: Gli sviluppatori potrebbero non essere sempre d’accordo con determinate limitazioni e regole. Affinché i guardrail siano efficaci, è necessario un cambiamento culturale, a partire da un feedback costruttivo e contestuale, visto come un’opportunità di miglioramento.

I guardrail sono emersi in modo organico come concetto nel platform engineering e in DevSecOps per enfatizzare l’efficace governance della piattaforma e le sue capacità di automazione.

AWS utilizza policy di gestione degli accessi (IAM) e policy di controllo dei servizi come principali barriere di sicurezza per autorizzazioni e restrizioni organizzative con il suo prodotto Cloud Security. AWS CloudFormation Guard convalida i modelli Infrastructure as Code (IaC) rispetto alle policy di sicurezza e ai costi prima della distribuzione. Amazon Bedrock Guardrails filtra i contenuti dannosi e oscura le informazioni sensibili nei prompt/output dell’AI, garantendo un utilizzo responsabile dell’AI stessa.

Railroad: il vostro “treno” di sviluppo a tutta velocità

E se paved road, golden path e guardrail potessero essere integrati in un paradigma olistico più ampio?

Pensate al modello railroad come a binari standardizzati e automatizzati per treni specifici ad alta velocità. I ​​binari sono così ben definiti da consentire velocità e affidabilità incredibili, con un margine di deviazione minimo o nullo. Il framework railroad comprende l’intero ecosistema di sviluppo software progettato per portare i progetti di sviluppo dall’ideazione iniziale all’implementazione finale con velocità, sicurezza ed efficienza ottimali.

Questo sistema strutturato rende lo sviluppo un viaggio in treno che corre su binari definiti: le paved road potrebbero essere le linee principali per le attività comuni, i golden path potrebbero essere le corsie preferenziali per le attività critiche, mentre i guardrail potrebbero essere segnali e misure per mantenere tutto sicuro e in carreggiata. In questo scenario, il team di progettazione della piattaforma agisce come un operatore di rete ferroviaria. Si assicura che tutto funzioni fluidamente così che i progetti raggiungano la loro destinazione senza intoppi.

Il modello Railroad: un quadro più ampio

Guardando al quadro più ampio, i vantaggi più significativi dell’adozione di un modello così strutturato sono:

• Time to market: Binari ottimizzati garantiscono che il treno ad alta velocità dello sviluppo arrivi a destinazione prima, sano e salvo. Questo framework riduce drasticamente i cicli di sviluppo, riducendo i tempi di commercializzazione.
• Riduzione dei costi: La standardizzazione e l’automazione basata sull’intelligenza artificiale possono aumentare l’efficienza e individuare tempestivamente i problemi, con conseguente significativa riduzione dei costi.
• Affidabilità: Le best practice integrate e i controlli automatizzati basati sull’intelligenza artificiale aiutano a creare software solidi e affidabili.
• Produttività degli sviluppatori: Gli sviluppatori possono liberare la loro creatività perché automazione e interfacce pratiche alleggeriscono il loro carico cognitivo.
• Scalabilità e prevedibilità: Iniziare in piccolo e crescere gradualmente è fondamentale. Un ecosistema progettato meticolosamente previene i problemi, garantendo che i progetti siano ben scalabili e gestiscano facilmente le sfide impreviste.
• Governance e conformità: Confini, regole, documentazione completa. È come avere un manuale strategico di gestione del traffico che garantisce il rispetto di percorsi approvati, sicuri e conformi.
• Adozione dell’AI: I sistemi AI sensibili al contesto migliorano l’automazione e le misure di sicurezza per la previsione e gli avvisi intelligenti. In un certo senso, l’intelligenza artificiale si comporta come un conduttore autonomo, facilitando lo sviluppo ad alta velocità sotto il controllo serrato dei supervisori umani.

La maggior parte delle difficoltà del modello railroad implicano un’attenta pianificazione, un certo grado di maturità e un significativo investimento iniziale in competenze e risorse, sia per la costruzione che per la manutenzione. Infine, il sistema dovrebbe essere progettato per essere resiliente e adattabile, tenendo conto dell’evoluzione delle tecnologie, delle minacce e delle esigenze aziendali.

Riassumendo

Paved road, golden path, guardrail e railroad rappresentano best practice e limiti che aiutano gli sviluppatori a operare in modo sicuro ed efficiente durante l’intero ciclo di vita dello sviluppo del prodotto.

Mentre le paved road sono raccomandazioni standardizzate e distinte, i golden path sono molto più regolativi e specifici per ogni compito. I guardrail sono le barriere di sicurezza poste lungo il percorso per evitare deviazioni dannose. Nel loro insieme, danno forma a un quadro sistemico più ampio, paragonabile a una rete ferroviaria (railroad) interconnessa.

Sono tutti utili, ma presentano anche punti deboli e sfide. La corretta implementazione di un quadro così complesso richiede prontezza, pianificazione, adattamento e ingenti investimenti in risorse e competenze.