Självstudie: Använda ARM-mallreferensen

Lär dig hur du hittar mallschemainformationen och använder informationen för att skapa Azure Resource Manager-mallar (ARM-mallar).

I den här självstudien använder du en basmall från Azure-snabbstartsmallar. Med hjälp av mallreferensdokumentationen validerar du mallen.

Den här självstudien omfattar följande uppgifter:

• Öppna en snabbstartsmall
• Förstå mallen
• Leta upp mallreferensen
• Redigera mallen
• Distribuera mallen

Om du inte har en Azure-prenumeration kan du skapa ett kostnadsfritt konto innan du börjar.

Förutsättningar

För att kunna följa stegen i den här artikeln behöver du:

• Visual Studio Code med Resource Manager Tools-tillägget. Se Snabbstart: Skapa ARM-mallar med Visual Studio Code.

Öppna en snabbstartsmall

Azure Snabbstartsmallar är en lagringsplats för ARM-mallar. I stället för att skapa en mall från början får du en exempelmall som du anpassar. Den mall som används i den här snabbstarten kallas Create a standard storage account (Skapa ett standardlagringskonto). Mallen definierar en Azure Storage-kontoresurs.

1. I Visual Studio Code väljer du Öppna fil>.

2. I Filnamn klistrar du in följande URL:

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

3. Välj Öppna för att öppna filen.

4. VäljSpara somfil> för att spara filen som azuredeploy.json på den lokala datorn.

Förstå schemat

1. Dölj mallen till rotnivån från Visual Studio Code. Du får den enklaste strukturen med följande element:

   

   • $schema: ange platsen för JSON-schemafilen som beskriver versionen av mallspråket.
   • contentVersion: ange valfritt värde för det här elementet för att dokumentera betydande ändringar i mallen.
   • metadata: ange mallens metadata.
   • parameters: ange de värden som anges när distributionen körs för att anpassa resursdistributionen.
   • variables: ange de värden som används som JSON-fragment i mallen för att förenkla mallspråkuttryck. Den här mallen innehåller inte det här elementet.
   • resources: ange de resurstyper som distribueras eller uppdateras i en resursgrupp.
   • outputs: ange de värden som returneras efter distributionen.

2. Expandera resources. Det finns en Microsoft.Storage/storageAccounts definierad resurs. API-versionen som visas på skärmbilden är 2022-09-01. SKU-namnet använder ett parametervärde. Parametern kallas storageAccountType.

   

3. Expandera parameters för att se hur storageAccountType definieras. Parametern har åtta tillåtna värden.

Med mallreferensen kan du ta reda på om du använder den senaste API-versionen och om parameterdefinitionen innehåller alla tillåtna värden.

Leta upp mallreferensen

1. Bläddra till Referens för Azure-mall.

2. I rutan Filtrera efter rubrik anger du lagringskonton och väljer de första lagringskontona under Referenslagring>.

   

3. Välj ARM-mall.

4. En resurstyp har vanligtvis flera API-versioner. Den här sidan visar den senaste versionen av mallschemat som standard. Välj listrutan Senaste för att se versionerna. Den senaste versionen som visas på skärmbilden är 2022-09-01. Välj antingen Senaste eller version direkt under Senaste för att se den senaste versionen. Kontrollera att den här versionen matchar den version som används för lagringskontoresursen i mallen. Om du uppdaterar API-versionen kontrollerar du att resursdefinitionen matchar mallreferensen.

   

5. På den här sidan visas information om resurstypen storageAccount. Den visar till exempel de tillåtna värdena för Sku-objektet . Det finns åtta SKU:er och de matchar de som anges i snabbstartsmallen som du öppnade tidigare.

   

Distribuera mallen

1. Logga in på Azure Cloud Shell

2. Välj önskad miljö genom att välja Antingen PowerShell eller Bash (för CLI) i det övre vänstra hörnet. Du måste starta om gränssnittet när du byter.

   

3. Välj Ladda upp/ned filer och välj sedan Ladda upp. Se föregående skärmbild. Välj den fil som du sparade i föregående avsnitt. När du har laddat upp filen kan du använda ls kommandot och cat kommandot för att kontrollera att filen har laddats upp.

4. Kör följande kommandon från Cloud Shell. Välj fliken så att du ser PowerShell-koden eller CLI-koden.

   När du distribuerar mallen anger du parametern storageAccountType med ett nytt mervärde, till exempel Standard_RAGRS. Distributionen skulle misslyckas om du använde den ursprungliga snabbstartsmallen eftersom Standard_RAGRS inte var ett tillåtet värde.

   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"
   

Rensa resurser

När Azure-resurserna inte längre behövs rensar du de resurser som du har distribuerat genom att ta bort resursgruppen.

1. I Azure Portal väljer du Resursgrupp på den vänstra menyn.
2. Ange resursgruppens namn i fältet Filtrera efter namn.
3. Välj resursgruppens namn. Du bör se totalt sex resurser i resursgruppen.
4. Välj Ta bort resursgrupp på den översta menyn.

Nästa steg

I den här självstudien lärde du dig hur du använder mallreferensen för att anpassa en befintlig mall. Du hittar mer information om att skapa flera instanser av lagringskonton i:

Skapa flera instanser