Esercizio - Creare e distribuire un modello di Azure Resource Manager

  • 10 minuti

In questo esercizio si crea un modello di Azure Resource Manager (ARM), lo si distribuisce in Azure e quindi si aggiorna il modello di Azure Resource Manager in modo da aggiungere parametri e output.

Creare un modello di Azure Resource Manager

  1. Aprire Visual Studio Code e creare un nuovo file denominato azuredeploy.json.

  2. Copiare e incollare il seguente codice nel file.

    {
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {},
  "functions": [],
  "variables": {},
  "resources": [],
  "outputs": {}
}

    Si noti che questo file presenta tutte le sezioni di un modello di ARM descritte nell'unità precedente.

  3. Salvare le modifiche apportate al file premendo CTRL+S.

Distribuire il modello di Resource Manager in Azure

Per distribuire questo modello in Azure, è necessario accedere all'account Azure dal terminale di Visual Studio Code. Assicurati di aver installato gli strumenti Azure CLI.

  1. Selezionare Terminale > nuovo terminale per aprire una finestra del terminale.

  2. Se la barra dei comandi della finestra del terminale indica bash, si dispone della shell corretta da cui lavorare ed è possibile passare alla sezione successiva.

    1. In caso contrario, selezionare l'elenco a discesa e scegliere Seleziona profilo predefinito.

      Screenshot che mostra la finestra del terminale di Visual Studio Code con Bash nel menu a discesa.

    2. Selezionare Git Bash.

      Screenshot della finestra del terminale di Visual Studio Code che mostra l'elenco a discesa per selezionare la shell.

  3. Passare alla directory nella cartella contenente il file del modello di ARM.

Accedere ad Azure

Nella finestra del terminale eseguire questo comando per accedere ad Azure.

az login

Nella finestra del browser visualizzata accedere al proprio account. Dopo avere effettuato l'accesso, verrà visualizzato un elenco di sottoscrizioni associate all'account nel terminale. La sottoscrizione predefinita è contrassegnata con un asterisco (*). Se si hanno più sottoscrizioni, selezionare la sottoscrizione da usare per questo esercizio.

Creare e impostare il gruppo di risorse predefinito

az group create --name <resource-group-name> --location <location>

Sostituire <resource-group-name> con un nome univoco per il gruppo di risorse. Sostituire <la località> con l'area di Azure più vicina. Ad esempio, usare eastus per Stati Uniti orientali.

Impostando il gruppo di risorse predefinito, è possibile omettere tale parametro dai comandi dell'interfaccia della riga di comando di Azure in questo esercizio. Per impostare il gruppo di risorse, eseguire il comando seguente.

az configure --defaults group="<resource-group-name>"

Sostituire <resource-group-name> con il nome del gruppo di risorse.

Distribuire il modello in Azure

Eseguire i comandi seguenti per distribuire il modello di ARM in Azure. Il modello di Resource Manager non dispone ancora di risorse, quindi non sono presenti risorse create. La distribuzione dovrebbe andare a buon fine.

templateFile="azuredeploy.json"
today=$(date +"%d-%b-%Y")
DeploymentName="blanktemplate-"$today

az deployment group create \
 --name $DeploymentName \
 --template-file $templateFile

La sezione superiore del codice precedente imposta le variabili dell'interfaccia della riga di comando di Azure, che includono il percorso al file modello da distribuire e il nome della distribuzione. La sezione inferiore az deployment group create distribuisce il modello in Azure. Si noti che il nome della distribuzione è blanktemplate con la data come suffisso.

Si dovrebbe vedere Running... nel terminale.

Per distribuire questo modello in Azure, è necessario accedere all'account Azure dal terminale di Visual Studio Code. Assicurarsi che Gli strumenti di Azure PowerShell siano installati dalle estensioni di Visual Studio Code.

  1. Nella barra dei comandi selezionare Terminale > nuovo terminale per aprire una finestra di PowerShell.

  2. Se la barra dei comandi della finestra del terminale mostra PowerShell, è disponibile la shell corretta da cui lavorare ed è possibile passare alla sezione successiva.

    Screenshot della finestra del terminale di Visual Studio Code con il terminale

    1. In caso contrario, selezionare la freccia giù e nell'elenco a discesa selezionare PowerShell. Se questa opzione è mancante, selezionare Seleziona profilo predefinito.

    2. Nel campo di input scorrere verso il basso e selezionare PowerShell.

      Screenshot della finestra del terminale di Visual Studio Code che mostra l'elenco a discesa per selezionare la shell.

  3. Passare alla directory nella cartella contenente i file del modello di ARM.

Accedere ad Azure usando Azure PowerShell

Dal terminale in Visual Studio Code eseguire il comando seguente per accedere ad Azure. Viene aperto un browser per accedere all'account.

Connect-AzAccount

Nella finestra del browser visualizzata (la finestra del browser potrebbe essere aperta dietro la finestra corrente, ridurre al minimo la finestra corrente per visualizzarla), accedere al proprio account. Dopo avere effettuato l'accesso, verrà visualizzato un elenco di sottoscrizioni associate all'account nel terminale. La sottoscrizione predefinita è contrassegnata con un asterisco (*). Se si hanno più sottoscrizioni, selezionare la sottoscrizione da usare per questo esercizio.

Distribuire il modello in Azure

New-AzResourceGroup -Name <ResourceGroupName> -Location <Location>

Sostituire con un nome univoco per il gruppo di risorse. Sostituisci con la regione di Azure più vicina a te. Ad esempio, usare eastus per Stati Uniti orientali.

Impostando il gruppo di risorse predefinito, è possibile omettere tale parametro dai comandi dell'interfaccia della riga di comando di Azure in questo esercizio. Per impostare il gruppo di risorse, eseguire il comando seguente.

Set-AzDefault -ResourceGroupName <ResourceGroupName>

sostituire <ResourceGroupName> con il nome del gruppo di risorse.

Distribuire il modello in Azure eseguendo i comandi seguenti. Il modello di Resource Manager non dispone ancora di risorse, quindi non sono presenti risorse create.

$templateFile="azuredeploy.json"
$today=Get-Date -Format "MM-dd-yyyy"
$deploymentName="blanktemplate-"+"$today"
New-AzResourceGroupDeployment `
  -Name $deploymentName `
  -TemplateFile $templateFile

La sezione superiore del codice precedente imposta le variabili di Azure PowerShell, che includono il percorso al file modello di distribuzione e il nome della distribuzione. Quindi il comando New-AzResourceGroupDeployment distribuisce il modello in Azure. Si noti che il nome della distribuzione è blanktemplate con la data come suffisso.

Quando distribuisci il tuo modello ARM in Azure, accedi al portale di Azure.

  1. Nel menu delle risorse selezionare Gruppi di risorse.

  2. Selezionare il gruppo di risorse creato in questo esercizio.

  3. Nel riquadro Panoramica si noterà che una distribuzione è riuscita.

    Interfaccia del portale di Azure per la panoramica del gruppo di risorse con la sezione distribuzioni che mostra che ne è stata completata una.

  4. Selezionare 1 Operazione riuscita per visualizzare i dettagli della distribuzione.

    Interfaccia del portale di Azure per le distribuzioni dove è presente una distribuzione elencata con stato riuscito.

  5. Selezionare blanktemplate per individuare le risorse distribuite. In questo caso è vuoto perché non sono state ancora specificate risorse nel modello.

    Interfaccia del portale di Azure per la distribuzione specifica senza risorse elencate.

  6. Lasciare aperta la pagina nel browser in modo da poter controllare di nuovo le distribuzioni.

Aggiungere una risorsa al modello di Resource Manager

Nell'attività precedente si è appreso come creare un modello vuoto e distribuirlo. A questo punto, si è pronti per distribuire una risorsa effettiva. In questa attività si aggiunge una risorsa di archiviazione su Azure al modello ARM.

  1. Nel file azuredeploy.json in Visual Studio Code aggiornare il file in modo che sia simile al seguente:

    {
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {},
  "functions": [],
  "variables": {},
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2025-01-01",
      "name": "storageaccount1",
      "tags": {
        "displayName": "storageaccount1"
      },
      "location": "[resourceGroup().location]",
      "kind": "StorageV2",
      "sku": {
        "name": "Standard_LRS"
      }
    }
  ],
  "outputs": {}
}

  2. Modificare i valori del nome della risorsa e displayName in un valore univoco, ad esempio learnexercise12321. Questo nome deve essere univoco a livello globale in Azure, contenere da 3 a 24 caratteri e includere solo lettere minuscole, numeri e trattini.

  3. Il percorso della risorsa è impostato sulla stessa posizione del gruppo di risorse in cui viene distribuita. Lasciare l'impostazione predefinita.

  4. Salvare il file.

Distribuire il modello di Resource Manager aggiornato

In questo esempio si modifica il nome della distribuzione in modo da rispecchiare meglio l'obiettivo della distribuzione.

Eseguire i comandi dell'interfaccia della riga di comando di Azure seguenti nel terminale. Questo frammento è lo stesso codice usato in precedenza, ma il nome della distribuzione è cambiato.

templateFile="azuredeploy.json"
today=$(date +"%d-%b-%Y")
DeploymentName="addstorage-"$today

az deployment group create \
  --name $DeploymentName \
  --template-file $templateFile

Eseguire i comandi di Azure PowerShell seguenti nel terminale. Questo frammento è lo stesso codice usato in precedenza, ma il nome della distribuzione è cambiato.

$templateFile="azuredeploy.json"
$today=Get-Date -Format "MM-dd-yyyy"
$deploymentName="addstorage-"+"$today"
New-AzResourceGroupDeployment `
  -Name $deploymentName `
  -TemplateFile $templateFile

Controllare la distribuzione

  1. Al termine della distribuzione, tornare al portale di Azure nel browser. Vai al tuo gruppo di risorse e noterai che ora sono presenti 2 distribuzioni riuscite. Selezionare il collegamento.

    Si noti che entrambe le distribuzioni sono presenti nell'elenco.

    Screenshot che mostra l'interfaccia del portale di Azure per le distribuzioni con due distribuzioni elencate con uno stato riuscito.

  2. Selezionare addstorage.

    Screenshot dell'interfaccia del portale di Azure per la distribuzione specifica con una risorsa elencata.

Si noti che l'account di archiviazione è distribuito.