Scrittura di template ARM

I modelli ARM consentono di definire l'infrastruttura Azure come codice in formato JSON. Questo permette di eseguire distribuzioni ripetibili e coerenti, con controllo della versione insieme al codice dell'applicazione. I modelli sono idempotenti: eseguire più volte lo stesso modello produce lo stesso risultato, rendendo sicuro applicarlo nuovamente dopo eventuali modifiche.

Ogni modello ARM inizia con una proprietà $schema che punta all'URL dello schema del modello, seguita da una stringa contentVersion. Lo schema indica al portale Azure e alle estensioni dell'editor come convalidare il modello e fornire IntelliSense. Le cinque sezioni principali successive sono parameters, variables, functions, resources e outputs.

I parametri rendono riutilizzabili i modelli accettando input al momento della distribuzione. Ogni parametro ha un type (string, int, bool, object, array, secureString), un defaultValue facoltativo e allowedValues facoltativi per la convalida. L'uso di secureString per le password garantisce che il valore non venga mai registrato nella cronologia delle distribuzioni.

Le variabili memorizzano valori calcolati a partire dai parametri o dalle funzioni del modello, riducendo le ripetizioni e semplificando la manutenzione dei modelli. Le variabili vengono valutate una volta e utilizzate in tutta la sezione resources tramite l'espressione [variables('name')]. Un modello comune consiste nel creare un nome di risorsa concatenando un parametro con un suffisso univoco.

L'array resources è il cuore di un modello ARM. Ogni elemento descrive una risorsa Azure con i campi obbligatori type, apiVersion, name e location. apiVersion fissa la versione dello schema del provider di risorse: utilizzate sempre una versione stabile recente per accedere alle funzionalità più recenti ed evitare proprietà deprecate.

Le espressioni dei modelli ARM sono racchiuse tra parentesi quadre [...] e supportano funzioni integrate per stringhe, array, oggetti e ID delle risorse. Tra le funzioni comuni figurano concat(), resourceGroup(), resourceId(), uniqueString() e parameters(). ARM valuta queste funzioni lato server al momento della distribuzione, non localmente.

La sezione outputs definisce i valori che ARM restituisce dopo una distribuzione completata correttamente. Gli output sono essenziali per concatenare i modelli: potete distribuire un modello di rete e restituire l'ID risorsa della subnet, quindi passarlo come parametro a un modello di VM. Gli output possono fare riferimento a qualsiasi espressione, comprese le proprietà delle risorse della distribuzione.

Per le architetture complesse, ARM supporta i modelli collegati (che fanno riferimento a URL di modelli esterni) e i modelli annidati (che incorporano un modello nell'array resources usando il tipo Microsoft.Resources/deployments). In questo modo potete suddividere una distribuzione infrastrutturale di grandi dimensioni in componenti modulari e riutilizzabili, mantenendo un unico modello di orchestrazione come punto di ingresso.

Anziché passare i parametri dalla riga di comando, memorizzateli in un file dei parametri separato: un file JSON con un oggetto parameters contenente coppie nome-valore. I file dei parametri possono essere specifici per l'ambiente (ad esempio, dev.parameters.json e prod.parameters.json) e salvati nel controllo del codice sorgente, mantenendo i valori sensibili nei riferimenti ad Azure Key Vault anziché in testo normale.

Utilizzate il comando dell'Azure CLI az deployment group create per distribuire un modello in un gruppo di risorse. Prima di distribuire in produzione, eseguite az deployment group validate per individuare errori di schema e di logica, quindi az deployment group what-if per visualizzare in anteprima le modifiche alle risorse. Questi tre comandi costituiscono una pipeline di distribuzione sicura: convalidare, visualizzare in anteprima, distribuire.

Seguite queste procedure consigliate per i modelli ARM: utilizzate i parametri per i valori specifici dell'ambiente, utilizzate le variabili per evitare ripetizioni, fissate le versioni dell'API su versioni stabili, utilizzate secureString per le password, aggiungete descrizioni nei metadati dei parametri e suddividete i modelli di grandi dimensioni in moduli collegati. Salvate i modelli in un repository Git e distribuiteli tramite una pipeline CI/CD per garantire la tracciabilità.

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

In questa lezione avete imparato che i modelli ARM sono documenti JSON che definiscono in modo dichiarativo l'infrastruttura Azure, che parametri e variabili rendono i modelli riutilizzabili e manutenibili e che il flusso di lavoro validate, what-if, deploy consente distribuzioni sicure e ripetibili. Nella prossima lezione esplorerete Bicep, un'astrazione moderna del formato JSON di ARM.