Bicep: IaC moderno per Azure

Bicep è un linguaggio specifico per dominio (DSL) sviluppato da Microsoft come alternativa concisa e fortemente tipizzata ai modelli ARM JSON. Bicep viene compilato nel formato ARM JSON standard, quindi utilizza lo stesso motore di distribuzione ARM e supporta tutti i tipi di risorsa Azure fin dal primo giorno. Bicep elimina gran parte del codice ripetitivo richiesto dal JSON puro e offre una migliore sicurezza dei tipi e un supporto IntelliSense.

Lo stesso account di archiviazione che in un modello ARM richiede circa 25 righe di JSON ne richiede solo circa 8 in Bicep. Bicep elimina '$schema', contentVersion, il contenitore dell'array resources e la sintassi prolissa delle espressioni. I nomi e i tipi delle proprietà rimangono identici, poiché Bicep è un livello di astrazione diretto sopra ARM JSON: non esiste alcuna differenza a runtime.

I parametri Bicep utilizzano la sintassi concisa param name type = defaultValue. Potete applicare decoratori (preceduti da @) direttamente sopra un parametro per aggiungere vincoli come @minLength(), @maxLength(), @allowed() e @description(). Il decoratore @secure() contrassegna un parametro come sensibile ed è equivalente a secureString in ARM JSON.

Le variabili Bicep vengono dichiarate con la parola chiave var e possono contenere qualsiasi espressione, inclusa l'interpolazione di stringhe tramite la sintassi '${value}'. L'interpolazione di stringhe è uno dei miglioramenti più leggibili rispetto ad ARM JSON: non sono più necessarie chiamate alla funzione concat(). Bicep supporta inoltre le espressioni condizionali tramite l'operatore ternario condition ? trueValue : falseValue.

In Bicep, a ogni risorsa viene assegnato un nome simbolico, ovvero un identificatore utilizzato per farvi riferimento nel modello. Il nome simbolico non coincide con il nome Azure della risorsa. Utilizzate i nomi simbolici per accedere alle proprietà delle risorse e stabilire dipendenze implicite facendo riferimento a una risorsa all'interno di un'altra; in questo modo non è necessario un array dependsOn esplicito.

Gli output di Bicep vengono dichiarati con la parola chiave output, seguita dal nome, dal tipo e dal valore dell'output. È possibile fare riferimento alle proprietà di una risorsa distribuita usando il nome simbolico e la notazione con il punto, molto più leggibile rispetto alla funzione reference() di ARM. Gli output sono essenziali per passare valori tra le chiamate ai moduli Bicep.

I moduli Bicep sono l'equivalente dei template collegati in formato JSON di ARM e consentono di suddividere l'infrastruttura in componenti riutilizzabili. Un modulo è semplicemente un altro file .bicep. È possibile farvi riferimento usando la parola chiave module, passare parametri e utilizzare i relativi output. I moduli possono anche essere pubblicati e utilizzati da un Azure Container Registry per il riutilizzo da parte dell'intero team.

Se dispone già di template JSON ARM esistenti, la CLI di Bicep può decompilarli in Bicep usando bicep decompile. Il risultato potrebbe richiedere alcune operazioni manuali di pulizia, ma offre un eccellente punto di partenza. Microsoft mette inoltre a disposizione un playground online all'indirizzo aka.ms/bicepdemo, dove è possibile incollare JSON ARM e visualizzare in tempo reale l'equivalente in Bicep.

Azure CLI supporta direttamente i file Bicep: non è necessario compilarli manualmente in JSON ARM prima della distribuzione. Passi il percorso del file .bicep a az deployment group create con il flag --template-file; la CLI eseguirà la compilazione in modo trasparente. Gli stessi sottocomandi validate e what-if funzionano con i file Bicep esattamente come con il JSON ARM.

Bicep supporta i cicli sulle risorse usando la sintassi for ... in per creare più istanze di una risorsa a partire da un parametro array, eliminando la duplicazione dovuta al copia-incolla. La parola chiave if abilita la distribuzione condizionale delle risorse: una risorsa viene inclusa solo quando una determinata condizione è vera. Entrambe le funzionalità vengono compilate rispettivamente nei costrutti ARM copy e condition.

L'estensione Bicep per Visual Studio Code offre funzionalità avanzate di IntelliSense, controllo dei tipi ed evidenziazione degli errori inline durante la digitazione. La CLI di Bicep include un linter che verifica la presenza di violazioni delle best practice, ad esempio parametri inutilizzati, descrizioni mancanti e versioni API errate. Esegua az bicep lint --file main.bicep nella pipeline CI per individuare i problemi prima della distribuzione.

Verifichi la comprensione dei concetti di Microsoft Azure Fundamentals (AZ-900) trattati in questa lezione.

In questa lezione ha imparato che Bicep è un'astrazione concisa e fortemente tipizzata sul JSON ARM, che viene compilata in template ARM standard; i moduli e i cicli consentono di scrivere codice d'infrastruttura riutilizzabile e DRY; inoltre, Azure CLI distribuisce direttamente i file Bicep supportando lo stesso flusso di lavoro validate/what-if/deploy. Prossimamente esploreremo Terraform in Azure.