Introduzione
Uno dei vantaggi della distribuzione dell'infrastruttura come codice è la possibilità di condividere i modelli, per poter collaborare al codice Bicep con gli altri membri del team. È importante che il codice Bicep sia facile da leggere e da usare.
In questo modulo verranno illustrati alcuni modi per determinare la struttura e lo stile del codice Bicep in modo che gli altri utenti possano facilmente comprenderlo, modificarlo e distribuirlo.
Scenario di esempio
Si supponga di essere un amministratore dell'infrastruttura di Azure per un'azienda di giocattoli. Insieme al team, si è deciso di usare Bicep come standard per le distribuzioni di Azure ed è stata creata una libreria di modelli riutilizzabili.
Due membri del team responsabile del controllo della qualità hanno il compito di eseguire un sondaggio tra i clienti. A tale scopo, devono distribuire un nuovo sito Web e un nuovo database. Hanno una scadenza molto rigida e vogliono evitare di creare un modello completamente nuovo se non è necessario. Dopo aver parlato con loro dei requisiti, ci si ricorda di avere già un modello simile a quello necessario.
Poiché il modello è uno dei primi file Bicep scritti, si teme che non sia pronto per essere usato ora. La domanda è: come è possibile aggiornare il modello in modo che sia corretto e facile da comprendere, da leggere e da modificare?
Cosa si fa?
In questo modulo verrà illustrato come migliorare ed effettuare il refactoring dei file Bicep in modo che gli altri utenti possano usare più facilmente il codice. Si vedrà l'importanza dei parametri e dei nomi per far sì che il codice Bicep e le distribuzioni di Azure siano utili anche per gli altri utenti. Si apprenderà anche come definire la struttura del modello, seguire uno stile coerente e aggiungere commenti che consentano ai colleghi di comprendere il funzionamento del modello.
Qual è l'obiettivo principale?
Al termine del modulo, si sarà in grado di creare modelli Bicep chiari, riutilizzabili e ben documentati.
Prerequisiti
È consigliabile avere familiarità con la struttura e la sintassi di Bicep, inclusi parametri, cicli, condizioni e moduli.
Per completare gli esercizi del modulo, è necessario quanto segue:
- Visual Studio Code installato localmente
- Estensione Bicep per Visual Studio Code installata in locale