Esercitazione: Utilizzare il riferimento del modello di Resource Manager

Questo articolo illustra come trovare le informazioni sullo schema dei modelli e usarle per creare modelli di Azure Resource Manager (modelli di ARM).

In questa esercitazione si usa un modello di base incluso in Modelli di avvio rapido di Azure. Il modello si personalizza usando la documentazione di riferimento del modello.

Questa esercitazione illustra le attività seguenti:

• Aprire un modello di avvio rapido
• Comprendere il modello
• Trovare le informazioni di riferimento sui modelli
• Modificare il modello
• Distribuire il modello

Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.

Prerequisiti

Per completare questo articolo, devi avere quanto segue:

• Visual Studio Code con l'estensione Strumenti di Resource Manager. Consultare Avvio rapido: Creare modelli di ARM con Visual Studio Code.

Aprire un modello di avvio rapido

Modelli di avvio rapido di Azure è un repository di modelli di Azure Resource Manager. Anziché creare un modello da zero, è possibile trovare un modello di esempio e personalizzarlo. Il modello usato in questa guida introduttiva è denominato Create a standard storage account (Creare un account di archiviazione Standard). Il modello definisce una risorsa account di archiviazione di Azure.

1. In Visual Studio Code selezionare File>Apri file.

2. In Nome file incollare l'URL seguente:

   https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.storage/storage-account-create/azuredeploy.json
   

3. Selezionare Apri per aprire il file.

4. Selezionare File>Salva con nome per salvare il file con il nome azuredeploy.json nel computer locale.

Informazioni sullo schema

1. Da Visual Studio Code comprimere il modello a livello di radice. Verrà visualizzata la struttura più semplice, con gli elementi seguenti:

   

   • $schema: specificare il percorso del file di schema JSON che descrive la versione del linguaggio del modello.
   • contentVersion: specificare qualsiasi valore per questo elemento per documentare modifiche rilevanti nel modello.
   • metadata: specificare i metadati del modello.
   • parameters: specificare i valori forniti durante l’implementazione per personalizzare l’implementazione delle risorse.
   • variables: specificare i valori usati come frammenti JSON nel modello per semplificare le espressioni di linguaggio del modello. Questo modello non contiene questo elemento.
   • resources: specificare i tipi di risorse implementate o aggiornate in un gruppo di risorse.
   • outputs: specificare i valori restituiti dopo l’implementazione.

2. Espandere resources, in cui è definita una risorsa Microsoft.Storage/storageAccounts. La versione dell'API mostrata nello screenshot è 2022-09-01. Il nome dello SKU usa un valore di parametro. Il parametro è denominato storageAccountType.

   

3. Espandere parameters per vedere la definizione di storageAccountType. Il parametro prevede otto valori consentiti.

Usando il riferimento del modello, è possibile determinare se si sta usando la versione più recente dell'API e se la definizione del parametro include tutti i valori consentiti.

Trovare le informazioni di riferimento sui modelli

1. Passare a Informazioni di riferimento sui modelli di Azure.

2. Nella casella filtra per titolo, immettere account di archiviazione e selezionare il primo Account di archiviazione in Riferimento > Archiviazione.

   

3. Selezionare il modello di Resource Manager.

4. Un tipo di risorsa offre in genere diverse versioni dell'API. Questa pagina mostra la versione più recente dello schema del modello per impostazione predefinita. Selezionare la casella a tendina Più recente per visualizzare le versioni. La versione più recente mostrata nello screenshot è 2022-09-01. Selezionare Più recente o la versione inferiore alla Più recente per visualizzare la versione più recente. Verificare che la versione corrisponda a quella usata per la risorsa account di archiviazione nel modello. Se si aggiorna la versione dell'API, verificare che la definizione della risorsa corrisponda alle informazioni di riferimento sul modello.

   

5. Questa pagina elenca i dettagli del tipo di risorsa storageAccount. Elenca ad esempio i valori consentiti per l'oggetto SKU. Esistono otto SKU che a quelli elencati nel modello di avvio rapido aperto in precedenza.

   

Distribuire il modello

1. Accedere ad Azure Cloud Shell

2. Scegliere l'ambiente preferito selezionando PowerShell o Bash (per l'interfaccia della riga di comando) nell'angolo in alto a sinistra. Quando si cambia interfaccia, è necessario riavviare la shell.

   

3. Selezionare Carica/Scarica file e quindi Carica. Vedere l'immagine sopra riportata. Selezionare il file salvato nella sezione precedente. Dopo aver caricato il file, è possibile usare i comandi ls e cat per verificare che il file sia stato caricato.

4. In Cloud Shell eseguire i comandi riportati sotto. Selezionare la scheda per visualizzare il codice di PowerShell o il codice dell'interfaccia della riga di comando.

   Quando si implementa il modello, specificare per il parametro storageAccountType un valore appena aggiunto, come Standard_RAGRS. La distribuzione non riesce se si è usato il modello di avvio rapido originale perché in quel caso Standard_RAGRS non è un valore consentito.

   CLI

   echo "Enter a project name that is used to generate resource group name:" &&
   read projectName &&
   echo "Enter the location (i.e. centralus):" &&
   read location &&
   resourceGroupName="${projectName}rg" &&
   az group create --name $resourceGroupName --location "$location" &&
   az deployment group create --resource-group $resourceGroupName --template-file "$HOME/azuredeploy.json" --parameters storageAccountType='Standard_RAGRS'
   

   PowerShell

   $projectName = Read-Host -Prompt "Enter a project name that is used to generate resource group name"
   $location = Read-Host -Prompt "Enter the location (i.e. centralus)"
   $resourceGroupName = "${projectName}rg"
   
   New-AzResourceGroup -Name $resourceGroupName -Location "$location"
   New-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName -TemplateFile "$HOME/azuredeploy.json" -storageAccountType "Standard_RAGRS"
   

Pulire le risorse

Quando non sono più necessarie, eseguire la pulizia delle risorse di Azure distribuite eliminando il gruppo di risorse.

1. Nel portale di Azure selezionare Gruppo di risorse nel menu a sinistra.
2. Immettere il nome del gruppo di risorse nel campo Filtra per nome.
3. Selezionare il nome del gruppo di risorse. Nel gruppo di risorse verranno visualizzate in totale sei risorse.
4. Selezionare Elimina gruppo di risorse nel menu in alto.

Passaggi successivi

In questa esercitazione è stato descritto come usare le informazioni di riferimento sui modelli per personalizzare un modello esistente. Per informazioni su come creare più istanze dell'account di archiviazione, vedere:

Creare più istanze