Rychlý Start: vytvoření šablon ARM pomocí Visual Studio Code
nástroje Azure Resource Manager pro Visual Studio Code poskytují podporu jazyků, fragmenty prostředků a automatického dokončování prostředků. Tyto nástroje vám pomůžou vytvořit a ověřit šablony Azure Resource Manager (šablony ARM). V tomto rychlém startu použijete rozšíření k vytvoření šablony ARM od začátku. V takovém případě se můžete setkat s funkcemi rozšíření, jako jsou fragmenty šablon ARM, ověřování, dokončování a podpora souborů parametrů.
k dokončení tohoto rychlého startu potřebujete Visual Studio Codes nainstalovanou rozšířením nástroje Azure Resource Manager tools . potřebujete také rozhraní příkazového řádku Azure CLI nebo modul Azure PowerShell nainstalovaný a ověřený.
Pokud předplatné Azure ještě nemáte, napřed si vytvořte bezplatný účet.
Vytvoření šablony ARM
vytvořte a otevřete pomocí Visual Studio Code nový soubor s názvem azuredeploy. json. Zadejte arm do editoru kódu, který iniciuje Azure Resource Manager fragmentů pro generování šablon ARM.
Tuto možnost vyberte arm! , pokud chcete vytvořit šablonu vymezenou pro nasazení skupiny prostředků Azure.
Tento fragment kódu vytvoří základní stavební bloky pro šablonu ARM.
všimněte si, že režim Visual Studio Code jazyka se změnil z formátu JSON na šablonu Azure Resource Manager. Toto rozšíření zahrnuje jazykový Server specifický pro šablony ARM, které poskytuje ověřování, dokončování a další jazykové služby specifické pro šablonu ARM.
Přidání prostředku Azure
Přípona obsahuje fragmenty pro mnoho prostředků Azure. Tyto fragmenty kódu lze použít k snadnému přidání prostředků do nasazení šablony.
Umístěte kurzor do bloku prostředků šablony, zadejte storage a vyberte fragment úložiště ARM .
Tato akce přidá prostředek úložiště do šablony.
Klávesa TAB se dá použít k tabulátoru prostřednictvím konfigurovatelných vlastností účtu úložiště.
Dokončení a ověření
Jednou z nejúčinnějších schopností rozšíření je jeho integrace se schématy Azure. Schémata Azure poskytují rozšíření s možnostmi dokončování ověřování a prostředků. Pojďme Upravit účet úložiště, aby se zobrazilo ověření a dokončení v akci.
Nejdřív aktualizujte druh účtu úložiště na neplatnou hodnotu, třeba megaStorage . Všimněte si, že tato akce vytvoří upozornění, což znamená, že není megaStorage platná hodnota.
Chcete-li použít možnosti dokončování, odstraňte megaStorage kurzor do dvojitých uvozovek a stiskněte klávesu ctrl + space . Tato akce zobrazí seznam dokončení platných hodnot.
Přidat parametry šablony
Nyní vytvořte a použijte parametr pro zadání názvu účtu úložiště.
Umístěte kurzor do bloku Parameters, přidejte návratový znak, zadejte " a potom vyberte new-parameter fragment. Tato akce přidá obecný parametr do šablony.
Aktualizujte název parametru na storageAccountName a popis Storage Account Name .
Názvy účtů Azure Storage mají minimální délku 3 znaky a musí být v rozmezí 24. Přidejte obojí minLength a maxLength do parametru a zadejte odpovídající hodnoty.
Nyní můžete v prostředku úložiště aktualizovat vlastnost název tak, aby používala parametr. Uděláte to tak, že odeberete aktuální název. Zadejte dvojité uvozovky a levou hranatou závorku [ , která vytvoří seznam funkcí šablon ARM. V seznamu vyberte parametry .
Když zadáte jednoduchou uvozovku ' uvnitř kulatých závorek, vytvoří se seznam všech parametrů definovaných v šabloně, v tomto případě storageAccountName. Vyberte parametr.
Vytvoření souboru parametrů
Soubor parametrů šablony ARM umožňuje ukládat hodnoty parametrů specifické pro prostředí a předávat tyto hodnoty do jako skupinu v době nasazení. Například můžete mít soubor parametrů s hodnotami specifickými pro testovací prostředí a jiný pro produkční prostředí.
Rozšíření usnadňuje vytvoření souboru parametrů z existujících šablon. Provedete to tak, že kliknete pravým tlačítkem na šablonu v editoru kódu a vyberete Select/Create Parameter File .
Vyberte New > All Parameters > vyberte název a umístění souboru parametrů.
Tato akce vytvoří nový soubor parametrů a namapuje ho se šablonou, ze které byl vytvořen. při výběru šablony můžete zobrazit a upravit aktuální mapování souborů nebo parametrů na stavovém řádku Visual Studio Code.
Teď, když je soubor parametrů namapován na šablonu, rozšíření ověří jak šablonu, tak i soubor parametrů společně. Chcete-li toto ověřování zobrazit v praxi, přidejte do storageAccountName parametru v souboru parametrů hodnotu se dvěma znaky a soubor uložte.
Přejděte zpět do šablony ARM a Všimněte si, že byla vyvolána chyba oznamující, že hodnota nesplňuje kritéria parametru.
Aktualizujte hodnotu podle potřeby, uložte soubor a přejděte zpět do šablony. Všimněte si, že chyba v parametru byla vyřešena.
Nasazení šablony
pomocí kombinace kláves otevřete integrovaný terminál Visual Studio Code ctrl + ` a k nasazení šablony použijte buď Azure CLI, nebo modul Azure PowerShell.
az group create --name arm-vscode --location eastus
az deployment group create --resource-group arm-vscode --template-file azuredeploy.json --parameters azuredeploy.parameters.json
Vyčištění prostředků
pokud už prostředky azure nepotřebujete, odstraňte pomocí modulu azure CLI nebo Azure PowerShell skupinu prostředků pro rychlý start.
az group delete --name arm-vscode