Esercitazione: Aggiungere una risorsa al modello di ARM

Nell'esercitazione precedente è stato illustrato come creare e distribuire il primo modello di Resource Manager (modello di ARM) vuoto. Ora sei pronto per distribuire una risorsa reale a questo modello. In questo caso, un account di archiviazione di Azure. Il completamento di questa istruzione richiede 9 minuti .

Prerequisiti

È consigliabile, ma non obbligatorio, completare l'esercitazione introduttiva sui modelli.

È necessario avere installato Visual Studio Code e usare l'estensione Strumenti di Azure Resource Manager e Azure PowerShell o l'interfaccia della riga di comando di Azure. Per altre informazioni, vedere gli strumenti per i modelli.

Aggiungere la risorsa

Per aggiungere una definizione di account di archiviazione di Azure al modello esistente, esaminare il codice JSON evidenziato nell'esempio seguente. Invece di provare a copiare sezioni del modello, copiare l'intero file e sostituire il modello con il relativo contenuto.

Sostituire {provide-unique-name} e le parentesi graffe {} con un nome di account di archiviazione univoco.

Importante

Il nome dell'account di archiviazione deve essere univoco in Azure. È composto solo da lettere minuscole o numeri e ha un limite di 24 caratteri. È possibile usare un nome come store1 come prefisso e quindi aggiungere le iniziali e la data odierna. Il nome, ad esempio, può essere store1abc06132022.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2021-09-01",
      "name": "{provide-unique-name}",
      "location": "eastus",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    }
  ]
}

Formulare un nome univoco per un account di archiviazione non è semplice e non funziona correttamente per l'automazione di distribuzioni di grandi dimensioni. Più avanti in questa serie di esercitazioni si useranno le funzionalità del modello per semplificare la creazione di un nome univoco.

Proprietà risorsa

Per trovare le proprietà da usare per ogni tipo di risorsa, è possibile usare le informazioni di riferimento per i modelli di Azure Resource Manager che consentono di individuare i tipi di risorsa da distribuire.

A ogni risorsa distribuita sono assegnate almeno le tre proprietà seguenti:

• type: Tipo di risorsa. Questo valore è una combinazione dello spazio dei nomi del provider di risorse e del tipo di risorsa, ad esempio Microsoft.Storage/storageAccounts.
• apiVersion: Versione dell'API REST da utilizzare per la creazione della risorsa. Ogni provider di risorse pubblica le proprie versioni API, di conseguenza questo valore è specifico del tipo.
• name: Nome della risorsa.

La maggior parte delle risorse ha anche una proprietà location che consente di impostare l'area in cui distribuire la risorsa.

Le altre proprietà variano in base al tipo di risorsa e alla versione dell'API. Dal momento che è importante comprendere la connessione tra la versione dell'API e le proprietà disponibili, verranno approfonditi questi aspetti.

In questa esercitazione è stato aggiunto un account di archiviazione al modello. È possibile visualizzare la versione dell'API dell'account di archiviazione in storageAccounts 2021-09-01. Si noti che non tutte le proprietà vengono aggiunte al modello. Molte proprietà sono infatti facoltative. Il provider di risorse Microsoft.Storage potrebbe rilasciare una nuova versione dell'API, ma non è necessario modificare la versione distribuita. È possibile continuare a usare tale versione ed essere certi che i risultati della distribuzione sono comunque coerenti.

Se si visualizza unaversione dell’API precedente, potrebbe essere disponibile un set di proprietà più piccolo.

Se si decide di modificare la versione dell'API per una risorsa, assicurarsi di valutare le proprietà della versione e modificare il modello di conseguenza.

Distribuire un modello

È possibile distribuire il modello per creare l'account di archiviazione. Assegnare alla distribuzione un nome diverso in modo da poterla trovare facilmente nella cronologia.

Se non è stato ancora creato il gruppo di risorse, vedere Creare il gruppo di risorse. Nell'esempio si presuppone che la variabile templateFile sia stata impostata sul percorso del file modello, come illustrato nella prima esercitazione.

PowerShell

New-AzResourceGroupDeployment `
  -Name addstorage `
  -ResourceGroupName myResourceGroup `
  -TemplateFile $templateFile

Interfaccia della riga di comando di Azure

Per eseguire questo comando di distribuzione, è necessario usare la versione più recente dell'interfaccia della riga di comando di Azure.

az deployment group create \
  --name addstorage \
  --resource-group myResourceGroup \
  --template-file $templateFile

Nota

Se la distribuzione non riesce, usare l'opzione verbose per ottenere informazioni sulle risorse che si stanno creando. Usare l'opzione debug per ottenere altre informazioni per il debug.

Questi sono due dei possibili errori di distribuzione che potrebbero verificarsi:

• Error: Code=AccountNameInvalid; Message={provide-unique-name} non è un nome di account di archiviazione valido. Il nome dell'account di archiviazione deve avere una lunghezza compresa tra 3 e 24 caratteri e comprendere solo numeri e lettere minuscole.

  Nel modello, sostituire {provide-unique-name} con un nome univoco dell'account di archiviazione. Vedere Aggiungere una risorsa.

• Error: Code=StorageAccountAlreadyTaken; Message=The storage account named store1abc09092019 è già in uso.

  Nel modello provare con un nome di account di archiviazione diverso.

Questa distribuzione richiede più tempo rispetto alla distribuzione del modello vuoto perché viene creato un account di archiviazione. L'operazione può richiedere circa un minuto.

Verificare la distribuzione

Per verificare la distribuzione, esplorare il gruppo di risorse nel portale di Azure.

1. Accedere al portale di Azure.
2. Nel menu di sinistra selezionare Gruppi di risorse.
3. Selezionare la casella a sinistra di myResourceGroup e selezionare myResourceGroup
4. Selezionare il gruppo di risorse in cui è stata eseguita la distribuzione.
5. Si noterà che è stato distribuito un account di archiviazione.
6. Si noti che l'etichetta di distribuzione ora indica: Distribuzioni: 2 Riuscite.

Pulire le risorse

Se si intende passare all'esercitazione successiva, non è necessario eliminare il gruppo di risorse.

Se invece ci si ferma, è opportuno eliminare il gruppo di risorse per rimuovere le risorse distribuite.

1. Nel portale di Azure selezionare Gruppo di risorse nel menu a sinistra.
2. Digitare il nome del gruppo di risorse nella casella Filtro per qualsiasi campo ... .
3. Selezionare la casella accanto a myResourceGroup e selezionare myResourceGroup o il nome del gruppo di risorse scelto.
4. Selezionare Elimina gruppo di risorse nel menu in alto.

Passaggi successivi

È stato creato un modello semplice per distribuire un account di archiviazione di Azure. Nelle esercitazioni successive verrà illustrato come aggiungere parametri, variabili, risorse e output a un modello. Queste funzionalità costituiscono i blocchi predefiniti di modelli molto più complessi.

Aggiungere i parametri