Lo sviluppo software è un percorso complesso e articolato in più fasi, irto di sfide comuni come la mancanza di standardizzazione, la scarsa coerenza tra i progetti e l’onboarding lento e laborioso di nuove applicazioni e membri del team.
Un blueprint di progetto affronta queste sfide direttamente, fornendo agli sviluppatori una linea di partenza autorevole e validata che semplifica la creazione e la governance di interi progetti.
Si tratta di una base strutturata che supporta il flusso di lavoro degli sviluppatori e ne migliora l’efficienza, accelerando l’intero ciclo di vita del software. In sostanza, i blueprint di progetto sono modelli preconfigurati progettati per aggirare alcuni onerosi passaggi preliminari di configurazione, aiutando i team ad avviare nuovi progetti più rapidamente.
Cos’è un blueprint di progetto?
Un blueprint di progetto è un concetto fondamentale nel platform engineering, in particolare per quanto riguarda le internal developer platform (IDP) e l’ottimizzazione dello sviluppo software. Si tratta di un repository Git preconfigurato (un modello) che contiene una struttura predefinita per evitare operazioni di copia/incolla quando si avviano nuovi progetti con la stessa configurazione di base.
Se creare una nuova applicazione fosse come cucinare, un blueprint di progetto sarebbe il vostro stampino standardizzato e di alta qualità. Allo stesso modo, proprio come un blueprint di una costruzione garantisce che un nuovo edificio sia strutturalmente solido e conforme, o come la guida all’assemblaggio di una fabbrica garantisce una qualità costante per ogni prodotto fabbricato, un blueprint di progetto riduce drasticamente i tempi di configurazione offrendo modelli finiti e convalidati.
In questo modo, lo sviluppo può iniziare immediatamente, invece di rimanere bloccati nella configurazione iniziale, nella definizione della baseline di sicurezza e nell’impostazione della pipeline. Il valore fondamentale dei blueprint risiede nel rendere disponibili percorsi di sviluppo ottimali che applicano gli standard ingegneristici e accelerano lo sviluppo fin dal primo giorno.
Blueprint di progetto: come funziona?
Immaginate di dover costruire un condominio completamente nuovo. Un blueprint di progetto è come creare una planimetria generale per l’intera struttura, definendo il layout, lo stile di design e le caratteristiche principali che tutti i singoli appartamenti dell’edificio dovranno seguire. Questo approccio garantisce che ogni nuovo appartamento si allinei al progetto generale, rendendo la configurazione più semplice e veloce, mantenendo al contempo la coerenza in tutto l’edificio.
Analogamente, un blueprint di progetto si riferisce alla configurazione di livello più alto che definisce le proprietà comuni per un progetto completo (inclusi ambienti predefiniti, provider e struttura generale). Con Mia-Platform, potete progettare il vostro progetto utilizzando blueprint esistenti per creare qualcosa di nuovo in base a esigenze specifiche molto più velocemente.
Configurazione iniziale di componenti essenziali
Quando l’automazione diventa uno standard, è possibile evitare configurazioni ripetitive e ridurre i tempi di configurazione complessivi di un progetto. È possibile sperimentare con le impostazioni attraverso aree categorizzate che facilitano la coerenza a livello di progetto. Ad esempio:
Template
I template costituiscono la base dei nuovi progetti, consentendo la configurazione iniziale di strutture predefinite, risorse essenziali e servizi. Ciò garantisce una base di configurazione convalidata e coerente. Dall’area Template è possibile:
- Impostare la struttura predefinita del progetto e la configurazione essenziale, inclusa l’abilitazione di Kustomize.
- Configurare la strategia di distribuzione (push o pull, basata su GitOps) e il pipeline runner richiesto.
- Definire i servizi predefiniti (endpoint, decorators) e le variabili di ambiente iniziali utilizzando un file api-console-config.json.
- Configurare automaticamente le dashboard di monitoraggio e le categorie che compaiono nella sezione di monitoraggio dell’ambiente.
Ambienti
Gli ambienti consentono di gestire impostazioni comuni per diversi contesti di runtime in cui verranno eseguite le applicazioni. Definirli a livello di blueprint garantisce che tutti i nuovi progetti abbiano i contesti richiesti configurati automaticamente. In quest’area è possibile:
- Definire e gestire gli ambienti di runtime necessari (ad esempio, sviluppo, staging, produzione), inclusi il loro nome, descrizione e ID.
- Specificare i dettagli della connessione, tra cui l’ID del cluster e lo spazio dei nomi del cluster (namespace), in cui verrà eseguito l’ambiente.
- Impostare URL di esposizione predefiniti per l’applicazione, come l’URL del progetto e l’URL del CMS.
Workload e Runtime
Questa sezione definisce gli standard operativi e di sicurezza per tutti i servizi all’interno di un progetto, ottimizzando la configurazione con policy di sicurezza predefinite e convenzioni per la creazione e la distribuzione dei servizi. Ad esempio, è possibile:
- Impostare il formato e il prefisso per il suggerimento automatico del nome dell’immagine Docker durante la creazione di nuovi microservizi.
- Definire l’elenco dei nomi per le entità Kubernetes (Image Pull Secrets) utilizzate nelle distribuzioni per l’accesso ai registri di immagini di container privati.
- Abilitare le funzionalità di sicurezza predefinite tramite annotazioni pod e contesti di sicurezza (ad esempio Seccomp Profile e AppArmor).
- Configurare le proprietà dell’host per gestire l’accesso privilegiato per impostazione predefinita.
- Visualizzare, monitorare e modificare le impostazioni di runtime.
Esempio di blueprint di progetto: Generazione di un progetto completo per una piattaforma di e-commerce tramite MCP Server
Un blueprint di progetto può accelerare i flussi di sviluppo con modelli pronti all’uso, ma cosa succederebbe se fosse possibile ottenere risultati ancora più rapidi? Con Mia-Platform, è possibile generare interi blueprint di progetto in un batter d’occhio utilizzando il server MCP della console e l’assistente AI integrato che funge da client MCP.
Prendiamo questo esempio. Uno sviluppatore vuole creare un progetto di base per una piattaforma di e-commerce e pone direttamente a Mia-Assistant una richiesta dettagliata:
- Richiesta: “Crea un progetto di e-commerce completo basato sul progetto Basic Template Demo Live. Includi tutti i microservizi, le configurazioni e le risorse, ma templatizza come placeholder i valori specifici dell’ambiente”.
- Azione: Il server MCP prende la struttura del progetto Basic Template Demo Live esistente e la arricchisce aggiungendo componenti e-commerce tipici (gestione prodotti, gestione utenti, pagamenti, notifiche, ecc.) dal Marketplace. Converte poi tutti i valori sensibili specifici dell’ambiente (come URL del database, chiavi segrete e credenziali API) in segnaposto dinamici, come {{MONGODB_CONNECTION_STRING}} per la configurazione del database, {{JWT_SECRET_KEY}} per l’autenticazione o {{STRIPE_WEBHOOK_SECRET}} per i pagamenti.
- Risultato: Un’architettura di e-commerce completamente basata su un modello viene generata con un singolo comando, così che i nuovi utenti devono solo inserire i valori segnaposto per implementare un ambiente di sviluppo sicuro e funzionante.
Esempio di blueprint di progetto: Generazione di un sistema di gestione ospedaliera tramite server MCP
Immaginate uno sviluppatore che ha bisogno di fornire rapidamente l’architettura fondamentale per un nuovo progetto di Sistema di Gestione Ospedaliera (HMS). Può rivolgersi a Mia-Assistant in linguaggio naturale:
“Crea un progetto Mia-Platform denominato HMS_1 per un sistema di gestione ospedaliera utilizzando il modello GitHub Enhanced nel tenant Showcase“.
L’assistente cercherà e sceglierà, basandosi sul contesto pertinente, un blueprint di progetto preconfigurato per ambienti di dati altamente regolamentati, come l’assistenza sanitaria digitale e lo sviluppo di SaMD.
Questo blueprint di progetto automaticamente:
- Implementa l’architettura: crea il repository di base e preconfigura i componenti essenziali come un API Gateway sicuro, un portale per il personale creato con React e un backend per app mobili.
- Definisce le strutture dei dati: include un servizio CRUD con raccolte predefinite per dati sensibili, come pazienti, cartelle cliniche, appuntamenti e fatturazione.
- Applica le misure di sicurezza: Abilita le funzionalità di sicurezza predefinite in tutti gli ambienti, limitando le chiamate al sistema del container per garantire la sicurezza dei dati dei pazienti fin dal primo giorno.
- Risultato: Il team di sviluppo aggira le complesse attività di definizione dei modelli di dati, configurazione degli ambienti infrastrutturali e applicazione delle policy di sicurezza, velocizzando tutta la configurazione iniziale.
Conclusione
Al giorno d’oggi, la velocità è un requisito imprescindibile nel software engineering. Tale velocità è ottenibile tramite pratiche standardizzate e modelli riutilizzabili.
Un blueprint di progetto è una soluzione potente che fornisce agli sviluppatori strutture di base e complete come punto di partenza per creare le proprie applicazioni in modo rapido, coerente e sicuro.
Utilizzate Mia-Platform e il suo server MCP integrato per ridurre ulteriormente i tempi di configurazione dei vostri progetti, aumentando la produttività e garantendo il controllo sulle vostre risorse.
