Titolo del modulo: dgt_plat10 – Backstage developer portal
Descrizione:
Backstage è il framework open source per costruire developer portal, nato in Spotify e oggi progetto CNCF. Offre ai developer un unico punto dove trovare servizi, documentazione, owner e le azioni che possono eseguire sulla piattaforma. Questo modulo ne spiega i componenti e come gestire un'istanza Backstage che un platform team possa mantenere nel tempo.
Obiettivi del modulo:
-
Software Catalog: Modellare component, API, resource, system, domain, utenti e gruppi, e mantenere il catalogo allineato a Git tramite i file catalog-info.yaml.
-
Software Template: Usare lo scaffolder per creare nuovi servizi da template: repository, pipeline CI, documentazione e registrazione nel catalogo in un solo passaggio.
-
TechDocs: Pubblicare documentazione scritta in Markdown accanto al codice, secondo l'approccio docs-like-code.
-
Plugin: Estendere Backstage con plugin per Kubernetes, CI/CD, monitoraggio e sicurezza, usando il nuovo backend system e frontend system.
-
Gestire Backstage: Installare Backstage su Kubernetes con PostgreSQL, configurare l'autenticazione con un identity provider, gestire upgrade e permessi.
Contenuti del modulo:
-
Design del catalogo: Ownership, ciclo di vita e relazioni: rendere il catalogo utile invece di un elenco di repository.
-
Integrazioni: Collegare Backstage a GitLab o GitHub, ai cluster Kubernetes e allo stack di osservabilità.
-
Ricerca: Rendere facili da trovare servizi, API e documentazione.
-
Scorecard: Usare i dati del catalogo per misurare la production readiness e l'adozione delle golden path.
-
Alternative: Quando conviene un'installazione completa di Backstage e quali alternative più leggere esistono per i team piccoli.
Laboratorio pratico in linguaggio naturale:
Gli studenti guidano l'agente AI nell'installazione di Backstage sul cluster Kubernetes di laboratorio, con PostgreSQL e login tramite l'identity provider GDT. Importano nel catalogo i progetti di laboratorio esistenti, scrivono le TechDocs per uno di essi e creano un primo software template. Gli studenti verificano ownership e relazioni nel catalogo e rivedono ogni file di configurazione scritto dall'agente.
Destinatari:
Questo modulo è pensato per gli studenti che hanno completato i moduli Linux, DevOps e Containers, e per sistemisti, DevOps engineer e SRE che vogliono avvicinarsi al Platform Engineering. È consigliata esperienza con Kubernetes.
Gli studenti possono caricare i propri esercizi nel progetto Git Academy DevOps & SRE. Per questo modulo, crea una cartella con il tuo username come nome nella seguente sottocartella: https://github.com/Garanti-Del-Talento/gdt_academy