Självstudie: Skapa och distribuera din första ARM-mall

  • Artikel
  • 5 minuter för att läsa

I den här självstudien får du Azure Resource Manager mallar (ARM-mallar). Den visar hur du skapar en startmall och distribuerar den till Azure. Du lär dig mer om mallens struktur och de verktyg som du behöver för att arbeta med mallar. Det tar cirka 12 minuter att slutföra den här självstudien, men den faktiska tiden varierar beroende på hur många verktyg du behöver installera.

Den här självstudien är den första i en serie. När du går igenom serien ändrar du startmallen steg för steg tills du har utforskat alla kärndelar i en ARM-mall. Dessa element är byggstenarna för mycket mer komplexa mallar. I slutet av serien hoppas vi att du kan skapa egna mallar och automatisera dina distributioner med mallar.

Om du vill lära dig mer om fördelarna med att använda mallar och varför du bör automatisera distributionen med mallar kan du läsa översikten över ARM-mallar. Mer information om ARM-mallar via en guidad uppsättning moduler på Microsoft Learn finns i Distribuera och hantera resurser i Azure med hjälp av ARM-mallar.

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

Hämta verktyg

Vi börjar med att se till att du har de verktyg du behöver för att skapa och distribuera mallar. Installera dessa verktyg på den lokala datorn.

Redigerare

Mallar är JSON-filer. För att skapa mallar behöver du en bra JSON-redigerare. Vi rekommenderar Visual Studio Code med tillägget Resource Manager Tools. Om du behöver installera de här verktygen kan du gå till Snabbstart: Skapa ARM-mallar med Visual Studio Code.

Kommandoradsdistribution

Du behöver också antingen Azure PowerShell eller Azure CLI för att distribuera mallen. Om du använder Azure CLI måste du ha den senaste versionen. Installationsanvisningarna finns i:

När du har installerat antingen Azure PowerShell eller Azure CLI ska du logga in för första gången. Mer hjälp finns i Logga in – PowerShell eller Logga in – Azure CLI.

Viktigt

Om du använder Azure CLI kontrollerar du att du har version 2.6 eller senare. Kommandona som visas i den här självstudien fungerar inte om du använder tidigare versioner. Om du vill kontrollera den installerade versionen använder du: az --version .

Okej, nu är du redo att börja lära dig om mallar.

Skapa din första mall

  1. Öppna Visual Studio Code med tillägget Resource Manager Tools installerat.

  2. Skapa en ny fil genom att välja Ny fil på Arkiv-menyn.

  3. Välj Spara som på Arkiv-menyn.

  4. Ge filen namnet azuredeploy och välj filnamnstillägget json. Det fullständiga namnet på filen är azuredeploy.json.

  5. Spara filen på din arbetsstation. Välj en sökväg som är lätt att komma ihåg eftersom du anger den sökvägen senare när du distribuerar mallen.

  6. Kopiera och klistra in följande JSON i filen:

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

    Så här ser din Visual Studio Code-miljö ut:

    Arm-mall Visual Studio Code första mallen

    Den här mallen distribuerar inga resurser. Vi börjar med en tom mall så att du kan bekanta dig med stegen för att distribuera en mall samtidigt som du minimerar risken för att något går fel.

    JSON-filen har följande element:

    • $schema: Anger platsen för JSON-schemafilen. Schemafilen beskriver de egenskaper som är tillgängliga i en mall. Schemat definierar till exempel resources som en av de giltiga egenskaperna för en mall. Oroa dig inte att datumet för schemat är 2019-04-01. Den här schemaversionen är uppdaterad och innehåller alla de senaste funktionerna. Schemadatumet har inte ändrats eftersom det inte har skett några större ändringar sedan det introducerades.
    • contentVersion: Anger versionen av mallen (till exempel 1.0.0.0). Du kan ange val annat värde för det här elementet. Använd det här värdet för att dokumentera betydande ändringar i mallen. När du distribuerar resurser med hjälp av mallen kan det här värdet användas för att se till att rätt mall används.
    • resources: Innehåller de resurser som du vill distribuera eller uppdatera. För närvarande är den tom, men du kommer att lägga till resurser senare.

  7. Spara filen.

Grattis, du har skapat din första mall.

Logga in på Azure

Börja arbeta med Azure PowerShell/Azure CLI genom att logga in med dina autentiseringsuppgifter för Azure.

Välj flikarna i följande kodavsnitt för att välja mellan Azure PowerShell och Azure CLI. CLI-exemplen i den här artikeln är skrivna för Bash-gränssnittet.

Connect-AzAccount

Om du har flera Azure-prenumerationer väljer du den prenumeration som du vill använda. Ersätt SubscriptionName med ditt prenumerationsnamn. Du kan också använda prenumerations-ID:t i stället för prenumerationsnamnet.

Set-AzContext SubscriptionName

Skapa resursgrupp

När du distribuerar en mall anger du en resursgrupp som ska innehålla resurserna. Innan du kör distributionskommandot skapar du resursgruppen med antingen Azure CLI eller Azure PowerShell.

New-AzResourceGroup `
  -Name myResourceGroup `
  -Location "Central US"

Distribuera mallen

Om du vill distribuera mallen använder du antingen Azure CLI eller Azure PowerShell. Använd den resursgrupp som du skapade. Namnge distributionen så att du enkelt kan identifiera den i distributionshistoriken. För enkelhetens skull skapar du även en variabel som lagrar sökvägen till mallfilen. Den här variabeln gör det enklare för dig att köra distributionskommandon eftersom du inte behöver ange sökvägen varje gång du distribuerar. Ersätt {provide-the-path-to-the-template-file} och kparenteserna {} med sökvägen till mallfilen.

$templateFile = "{provide-the-path-to-the-template-file}"
New-AzResourceGroupDeployment `
  -Name blanktemplate `
  -ResourceGroupName myResourceGroup `
  -TemplateFile $templateFile

Distributionskommandot returnerar resultat. Leta efter ProvisioningState för att se om distributionen lyckades.

Anteckning

Om distributionen misslyckades använder du verbose växeln för att hämta information om de resurser som skapas. Använd debug växeln för att få mer information om felsökning.

Verifiera distributionen

Du kan verifiera distributionen genom att utforska resursgruppen från Azure Portal.

  1. Logga in på Azure-portalen.

  2. Välj Resursgrupper på den vänstra menyn.

  3. Välj den resursgrupp som distribueras i den senaste proceduren. Standardnamnet är myResourceGroup. Du bör se att ingen resurs har distribuerats i resursgruppen.

  4. Observera att statusen för distributionen visas uppe till höger i översikten. Välj 1 Lyckades.

    Visa distributionsstatus

  5. Du ser en historik över distributionen för resursgruppen. Välj blanktemplate.

    Välj distribution

  6. Du ser en sammanfattning av distributionen. I det här fallet finns det inte mycket att se eftersom inga resurser har distribuerats. Senare i den här serien kan det vara bra att granska sammanfattningen i distributionshistoriken. Observera att du till vänster kan visa indata, utdata och mallen som används under distributionen.

    Visa distributionssammanfattning

Rensa resurser

Om du går vidare till nästa självstudie behöver du inte ta bort resursgruppen.

Om du stoppar nu kanske du vill 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.
  4. Välj Ta bort resursgrupp på den översta menyn.

Nästa steg

Du har skapat en enkel mall för distribution till Azure. I nästa självstudie lägger du till ett lagringskonto i mallen och distribuerar det till resursgruppen.

Lägg till resurs