Självstudie: Använda ARM-mallreferensen

Lär dig hur du hittar mallschemainformationen och använder informationen för att 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 kan du anpassa mallen.

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

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. Från Visual Studio code väljer du Arkiv > Ö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älj Arkiv > Spara som för att spara filenazuredeploy.js på den lokala datorn.

Förstå schemat

1. Från Visual Studio Code minimerar du mallen till rotnivån. 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 ett värde för det här elementet för att dokumentera betydande ändringar i mallen.
   • 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.
   • resources: ange de resurstyper som distribueras eller uppdateras i en resursgrupp.
   • outputs: ange de värden som returneras efter distributionen.

2. Expandera resources . En resurs har Microsoft.Storage/storageAccounts definierats. SKU-namnet använder ett parametervärde. Parametern heter storageAccountType .

   

3. Expandera parameters för att se hur storageAccountType definieras. Parametern har fyra tillåtna värden. Du hittar de andra tillåtna värdena och ändrar sedan parameterdefinitionen.

   

Leta upp mallreferensen

1. Bläddra till Azure-mallreferensen.

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

   

   En resursprovider har vanligtvis flera API-versioner:

   

3. Välj Alla resurser under Lagring i den vänstra rutan. På den här sidan visas resurstyper och versioner av lagringsresursprovidern. Vi rekommenderar att du använder de senaste API-versionerna för de resurstyper som definierats i mallen.

   

4. Välj den senaste versionen av storageAccount resurstypen. Den senaste versionen är 2019-06-01 när den här artikeln är skriven. 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 tillåtna värden för SKU-objektet. Det finns fler SKU:er än vad som visas i snabbstartsmallen som du öppnade tidigare. Du kan anpassa snabbstartsmallen så att den innehåller alla tillgängliga lagringstyper.

   

Redigera mallen

Från Visual Studio Code lägger du till de ytterligare lagringskontotyperna enligt följande skärmbild:

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 överfört filen kan du använda ls kommandot och kommandot för att kontrollera att filen har cat laddats upp.

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

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

   • CLI
   • PowerShell

   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'
   

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. Från 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: