Snabbstart: Skapa ARM-mallar med Visual Studio Code
I Azure Resource Manager Tools for Visual Studio Code finns språkstöd, resursfragment och automatisk komplettering av resurser. Dessa verktyg hjälper dig att skapa och Azure Resource Manager mallar (ARM-mallar). I den här snabbstarten använder du tillägget för att skapa en ARM-mall från grunden. När du gör det får du funktioner för tillägg som ARM-mallfragment, validering, slutförande och stöd för parameterfiler.
För att slutföra den här snabbstarten behöver Visual Studio Code, med tillägget Azure Resource Manager verktyg installerat. Du behöver också antingen Azure CLI eller Azure PowerShell-modulen installerad och autentiserad.
Om du inte har en Azure-prenumeration kan du skapa ett kostnadsfritt konto innan du börjar.
Skapa en ARM-mall
Skapa och öppna med Visual Studio Koda en ny fil med namnet azuredeploy.json. Ange arm i kodredigeraren, som initierar Azure Resource Manager kodfragment för att skapa en ARM-mall.
Välj arm! att skapa en mall som är begränsad till en distribution av en Azure-resursgrupp.
Det här kodfragmentet skapar de grundläggande byggstenarna för en ARM-mall.
Observera att Visual Studio Code-språkläget har ändrats från JSON till Azure Resource Manager Template. Tillägget innehåller en språkserver som är specifik för ARM-mallar som tillhandahåller ARM-mallspecifik validering, slutförande och andra språktjänster.
Lägga till en Azure-resurs
Tillägget innehåller kodfragment för många Azure-resurser. Dessa kodfragment kan användas för att enkelt lägga till resurser i malldistributionen.
Placera markören i mallresursernas block, skriv i storage och välj arm-storage-kodfragmentet.
Den här åtgärden lägger till en lagringsresurs i mallen.
Tabbtangenten kan användas för att bläddra igenom konfigurerbara egenskaper på lagringskontot.
Slutförande och validering
En av de mest kraftfulla funktionerna i tillägget är dess integrering med Azure-scheman. Azure-scheman ger tillägget funktioner för verifiering och resursmedveten slutförande. Nu ska vi ändra lagringskontot så att validering och slutförande visas i praktiken.
Uppdatera först typen av lagringskonto till ett ogiltigt värde, till exempel megaStorage . Observera att den här åtgärden genererar en varning som anger att megaStorage inte är ett giltigt värde.
Om du vill använda slutförandefunktionerna tar du megaStorage bort , placerar markören inuti dubbla citattecken och trycker på ctrl + space . Den här åtgärden visar en slutförandelista med giltiga värden.
Lägga till mallparametrar
Skapa och använd nu en parameter för att ange lagringskontots namn.
Placera markören i parameterblocket, lägg till en vagnretur, " skriv och välj sedan new-parameter kodfragmentet. Den här åtgärden lägger till en allmän parameter i mallen.
Uppdatera namnet på parametern till storageAccountName och beskrivningen till Storage Account Name .
Namn på Azure-lagringskonto har en minsta längd på 3 tecken och högst 24. Lägg till minLength både maxLength och i parametern och ange lämpliga värden.
På lagringsresursen uppdaterar du nu namnegenskapen för att använda parametern . Det gör du genom att ta bort det aktuella namnet. Ange ett dubbelt citattecken och en inledande [ hakparentes , som skapar en lista över ARM-mallfunktioner. Välj parametrar i listan.
Om du anger ett enkelt citattecken inom hakparenteserna skapas en lista över alla parametrar som definierats i mallen, i det ' här fallet storageAccountName. Välj parametern .
Skapa en parameterfil
Med en ARM-mallparameterfil kan du lagra miljöspecifika parametervärden och skicka dessa värden som en grupp vid distributionen. Du kan till exempel ha en parameterfil med värden som är specifika för en testmiljö och en annan för en produktionsmiljö.
Tillägget gör det enkelt att skapa en parameterfil från dina befintliga mallar. Det gör du genom att högerklicka på mallen i kodredigeraren och välja Select/Create Parameter File .
Välj New > All Parameters > Välj ett namn och en plats för parameterfilen.
Den här åtgärden skapar en ny parameterfil och mappar den med mallen som den skapades från. Du kan se och ändra mappningen av den aktuella mall-/parameterfilen i Visual Studio kodstatusfältet när mallen är markerad.
Nu när parameterfilen har mappats till mallen validerar tillägget både mallen och parameterfilen tillsammans. Om du vill se den här valideringen i praktiken lägger du till ett värde med två storageAccountName tecken i parametern i parameterfilen och sparar filen.
Gå tillbaka till ARM-mallen och observera att ett fel har uppstått som anger att värdet inte uppfyller parameterkriterierna.
Uppdatera värdet till något lämpligt, spara filen och gå tillbaka till mallen. Observera att felet på parametern har lösts.
Distribuera mallen
Öppna den integrerade Visual Studio Code med nyckelkombinationen och använd antingen Azure CLI eller ctrl + ` Azure PowerShell för att distribuera mallen.
az group create --name arm-vscode --location eastus
az deployment group create --resource-group arm-vscode --template-file azuredeploy.json --parameters azuredeploy.parameters.json
Rensa resurser
När Azure-resurserna inte längre behövs kan du använda Azure CLI eller Azure PowerShell modulen för att ta bort snabbstartsresursgruppen.
az group delete --name arm-vscode