Guida introduttiva: Creare modelli di Azure Resource Manager con Visual Studio CodeQuickstart: Create Azure Resource Manager templates with Visual Studio Code

Gli strumenti di Azure Resource Manager per Visual Studio Code forniscono supporto per i linguaggi, frammenti di risorse e completamento automatico delle risorse.The Azure Resource Manager Tools for Visual Studio Code provide language support, resource snippets, and resource autocompletion. Questi strumenti consentono di creare e convalidare i modelli di Azure Resource Manager.These tools help create and validate Azure Resource Manager templates. In questa guida di avvio rapido si userà l'estensione per creare un modello di Azure Resource Manager da zero.In this quickstart, you use the extension to create an Azure Resource Manager template from scratch. In questo modo è possibile sperimentare le funzionalità delle estensioni, come i frammenti di modelli di Resource Manager, la convalida, i completamenti e il supporto per i file di parametri.While doing so you experience the extensions capabilities such as ARM template snippets, validation, completions, and parameter file support.

Per completare questo argomento di avvio rapido, è necessario avere Visual Studio Code con l'estensione degli strumenti di Azure Resource Manager installata.To complete this quickstart, you need Visual Studio Code, with the Azure Resource Manager tools extension installed. È inoltre necessario aver installato e autenticato l'interfaccia della riga di comando di Azure o il modulo di Azure PowerShell.You also need either the Azure CLI or the Azure PowerShell module installed and authenticated.

Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.If you don't have an Azure subscription, create a free account before you begin.

Creare un modello di Azure Resource ManagerCreate an ARM template

Creare e aprire con Visual Studio Code un nuovo file denominato azuredeploy.json.Create and open with Visual Studio Code a new file named azuredeploy.json. Immettere arm nell'editor di codice, che avvia i frammenti di Azure Resource Manager per lo scaffolding di un modello di Resource Manager.Enter arm into the code editor, which initiates Azure Resource Manager snippets for scaffolding out an ARM template.

Selezionare arm! per creare un modello con ambito per la distribuzione di un gruppo di risorse di Azure.Select arm! to create a template scoped for an Azure resource group deployment.

Immagine che mostra i frammenti di codice per scaffolding di Azure Resource Manager

Questo frammento di codice crea i blocchi predefiniti di base per un modello di Resource Manager.This snippet creates the basic building blocks for an ARM template.

Immagine che mostra un modello di Resource Manager con scaffolding completo

Si noti che la modalità di linguaggio di Visual Studio Code è cambiata da JSON a Modello di Azure Resource Manager.Notice that the Visual Studio Code language mode has changed from JSON to Azure Resource Manager Template. L'estensione include un server di linguaggio specifico per i modelli di Resource Manager che fornisce appositi servizi di convalida, completamento e altri servizi di linguaggio.The extension includes a language server specific to ARM templates which provides ARM template-specific validation, completion, and other language services.

Immagine che mostra Azure Resource Manager in modalità di linguaggio Visual Studio Code

Aggiungere una risorsa di AzureAdd an Azure resource

L'estensione include frammenti per molte risorse di Azure.The extension includes snippets for many Azure resources. Questi frammenti possono essere usati per aggiungere facilmente risorse alla distribuzione del modello.These snippets can be used to easily add resources to your template deployment.

Posizionare il cursore nel blocco resources del modello, digitare storage e selezionare il frammento arm-storage.Place the cursor in the template resources block, type in storage, and select the arm-storage snippet.

Immagine che mostra l'aggiunta di una risorsa al modello di Resource Manager

Questa azione aggiunge una risorsa di archiviazione al modello.This action adds a storage resource to the template.

Immagine che mostra una risorsa di archiviazione di Azure in un modello di Resource Manager

La chiave tab può essere usata per spostarsi tramite TAB tra le proprietà configurabili dell'account di archiviazione.The tab key can be used to tab through configurable properties on the storage account.

Immagine che mostra come usare TAB per spostarsi tra le opzioni di configurazione delle risorse

Completamento e convalidaCompletion and validation

Una delle funzionalità più avanzate dell'estensione è l'integrazione con gli schemi di Azure.One of the most powerful capabilities of the extension is its integration with Azure schemas. Gli schemi di Azure forniscono all'estensione funzionalità di convalida e completamento con riconoscimento della risorsa.Azure schemas provide the extension with validation and resource-aware completion capabilities. Modificare l'account di archiviazione per vedere il funzionamento di convalida e completamento.Let's modify the storage account to see validation and completion in action.

Aggiornare prima di tutto il tipo di account di archiviazione impostandolo su un valore non valido, ad esempio megaStorage.First, update the storage account kind to an invalid value such as megaStorage. Si noti che questa azione genera un avviso che indica che megaStorage non è un valore valido.Notice that this action produces a warning indicating that megaStorage is not a valid value.

Immagine che mostra una configurazione di archiviazione non valida

Per usare le funzionalità di completamento, rimuovere megaStorage, posizionare il cursore all'interno delle virgolette doppie e premere ctrl + space.To use the completion capabilities, remove megaStorage, place the cursor inside of the double quotes, and press ctrl + space. Questa azione presenta un elenco di completamento di valori validi.This action presents a completion list of valid values.

Immagine che mostra il completamento automatico dell'estensione

Aggiungere i parametri del modelloAdd template parameters

A questo punto, creare e usare un parametro per specificare il nome dell'account di archiviazione.Now create and use a parameter to specify the storage account name.

Posizionare il cursore nel blocco parameters, aggiungere un ritorno a capo, digitare "e quindi selezionare il frammento new-parameter.Place your cursor in the parameters block, add a carriage return, type ", and then select the new-parameter snippet. Questa azione aggiunge un parametro generico al modello.This action adds a generic parameter to the template.

Immagine che mostra l'aggiunta di un parametro al modello di Resource Manager

Aggiornare il nome del parametro in storageAccountName e la descrizione in Storage Account Name.Update the name of the parameter to storageAccountName and the description to Storage Account Name.

Immagine che mostra il parametro completato in un modello di Resource Manager

I nomi degli account di archiviazione di Azure possono essere composti da un minimo di 3 e un massimo di 24 caratteri.Azure storage account names have a minimum length of 3 characters and a maximum of 24. Aggiungere sia minLength che maxLength al parametro e specificare i valori appropriati.Add both minLength and maxLength to the parameter and provide appropriate values.

Immagine che mostra l'aggiunta di minLength e maxLength a un parametro del modello di Resource Manager

A questo punto, nella risorsa di archiviazione aggiornare la proprietà name in modo da usare il parametro.Now, on the storage resource, update the name property to use the parameter. A questo scopo, rimuovere il nome corrente.To do so, remove the current name. Immettere una virgoletta doppia e una parentesi quadra aperta [, che produce un elenco di funzioni del modello di Resource Manager.Enter a double quote and an opening square bracket [, which produces a list of ARM template functions. Selezionare parameters nell'elenco.Select parameters from the list.

Immagine che mostra il completamento automatico quando si usano i parametri nelle risorse del modello di Resource Manager

L'immissione di una virgoletta singola ' all'interno delle parentesi tonde produce un elenco di tutti i parametri definiti nel modello, in questo caso storageAccountName.Entering a single quote ' inside of the round brackets produces a list of all parameters defined in the template, in this case, storageAccountName. Selezionare il parametro.Select the parameter.

Immagine che mostra il parametro completato in una risorsa del modello di Resource Manager

Creare un file di parametriCreate a parameter file

Un file di parametri del modello di Resource Manager consente di archiviare valori di parametri specifici dell'ambiente e di passarli come gruppo in fase di distribuzione.An ARM template parameter file allows you to store environment-specific parameter values and pass these values in as a group at deployment time. Ad esempio, è possibile avere un file di parametri con valori specifici di un ambiente di test e un altro per un ambiente di produzione.For example, you may have a parameter file with values specific to a test environment and another for a production environment.

L'estensione semplifica la creazione di un file di parametri dai modelli esistenti.The extension makes it easy to create a parameter file from your existing templates. A questo scopo, fare clic con il pulsante destro del mouse sul modello nell'editor di codice e scegliere Select/Create Parameter File.To do so, right-click on the template in the code editor and select Select/Create Parameter File.

Immagine che mostra il processo di clic con il pulsante destro del mouse per creare un file di parametri da un modello di Resource Manager

Selezionare New > All Parameters e quindi un nome e un percorso per il file dei parametri.Select New > All Parameters > Select a name and location for the parameter file.

Immagine che mostra la finestra di dialogo per il salvataggio del nome del file durante la creazione di un file di parametri da un modello di Resource Manager

Questa azione crea un nuovo file di parametri e lo mappa al modello da cui è stato creato.This action creates a new parameter file and maps it with the template from which it was created. È possibile visualizzare e modificare il mapping corrente tra modello e file di parametri sulla barra di stato di Visual Studio Code durante la sezione del modello.You can see and modify the current template/parameter file mapping in the Visual Studio Code status bar while the template is selected.

Immagine che illustra il mapping del file di modello/parametro nella barra di stato del Visual Studio Code.

Ora che il file di parametri è stato mappato al modello, l'estensione convalida questi due elementi contemporaneamente.Now that the parameter file has been mapped to the template, the extension validates both the template and parameter file together. Per vedere la procedura di convalida, aggiungere un valore di due caratteri al parametro storageAccountName nel file di parametri e salvare il file.To see this validation in practice, add a two-character value to the storageAccountName parameter in the parameter file and save the file.

Immagine che mostra un modello non convalidato a causa di un problema del file di parametri

Tornare nel modello di Resource Manager. Come si può notare, è stato generato un errore indicante che il valore non soddisfa i criteri dei parametri.Navigate back to the ARM template and notice that an error has been raised indicating that the value does not meet the parameter criteria.

Immagine che mostra un modello di Resource Manager valido

Specificare un valore appropriato, salvare il file e tornare nel modello.Update the value to something appropriate, save the file, and navigate back to the template. Come si può notare, l'errore del parametro è stato risolto.Notice that the error on the parameter has been resolved.

Distribuire il modelloDeploy the template

Aprire il terminale integrato di Visual Studio Code con la combinazione di tasti ctrl + ` e usare l'interfaccia della riga di comando di Azure o il modulo di Azure PowerShell per distribuire il modello.Open the integrated Visual Studio Code terminal using the ctrl + ` key combination and use either the Azure CLI or Azure PowerShell module to deploy the template.

az group create --name arm-vscode --location eastus

az deployment group create --resource-group arm-vscode --template-file azuredeploy.json --parameters azuredeploy.parameters.json

Pulire le risorseClean up resources

Quando le risorse non sono più necessarie, usare l'interfaccia della riga di comando di Azure o il modulo di Azure PowerShell per eliminare il gruppo di risorse dell'argomento di avvio rapido.When the Azure resources are no longer needed, use the Azure CLI or Azure PowerShell module to delete the quickstart resource group.

az group delete --name arm-vscode

Passaggi successiviNext steps