Kurz: Vytvoření a nasazení první šablony ARM

Tento kurz vás seznámí s Azure Resource Manager šablony (šablony ARM). Ukazuje, jak vytvořit úvodní šablonu a nasadit ji do Azure. Dozvíte se o struktuře šablony a nástrojích, které budete potřebovat pro práci se šablonami. Dokončení tohoto kurzu trvá přibližně 12 minut, ale skutečný čas se bude lišit v závislosti na tom, kolik nástrojů potřebujete nainstalovat.

Tento kurz je první z řady. Během této série budete upravovat počáteční šablonu krok za krokem, dokud neprojdete všechny základní části šablony ARM. Tyto prvky jsou stavebními bloky pro mnohem složitější šablony. Doufáme, že na konci série jste si jistí, že vytváříte vlastní šablony a jste připraveni automatizovat nasazení pomocí šablon.

Pokud se chcete dozvědět o výhodách používání šablon a o tom, proč byste měli nasazení automatizovat pomocí šablon, přečtěte si přehled šablon ARM. Další informace o šablonách ARM prostřednictvím sady modulů s asi návodem na Microsoft Learn najdete v tématu Nasazení a správa prostředků v Azure pomocí šablon ARM.

Pokud předplatné Azure ještě nemáte, napřed si vytvořte bezplatný účet.

Získání nástrojů

Začáte tím, že se ujistete, že máte nástroje potřebné k vytváření a nasazování šablon. Nainstalujte tyto nástroje na místní počítač.

Editor

Šablony jsou soubory JSON. K vytváření šablon potřebujete dobrý editor JSON. Doporučujeme Visual Studio Code s rozšířením Resource Manager Tools. Pokud potřebujete tyto nástroje nainstalovat, projděte si rychlý start: Vytváření šablon ARM pomocí Visual Studio Code.

Nasazení z příkazového řádku

K nasazení šablony Azure PowerShell azure CLI. Pokud používáte Azure CLI, musíte mít nejnovější verzi. Pokyny k instalaci najdete v těchto pokynech:

Po instalaci Azure PowerShell nebo Azure CLI se poprvé přihlaste. Nápovědu najdete v tématu Přihlášení – PowerShell nebo Přihlášení – Azure CLI.

Důležité

Pokud používáte Azure CLI, ujistěte se, že máte verzi 2.6 nebo novější. Příkazy uvedené v tomto kurzu nebudou fungovat, pokud používáte starší verze. Pokud chcete zkontrolovat nainstalovanou verzi, použijte: az --version .

Teď se můžete začít učit o šablonách.

Vytvoření první šablony

  1. Otevřete Visual Studio Code s nainstalovaným rozšířením Resource Manager Tools.

  2. V nabídce File (Soubor) vyberte New File (Nový soubor) a vytvořte nový soubor.

  3. V nabídce File (Soubor) vyberte Save as (Uložit jako).

  4. Pojmechte soubor azuredeploy a vyberte příponu souboru json. Úplný název souboru je azuredeploy.json.

  5. Uložte soubor na pracovní stanici. Vyberte cestu, kterou si snadno zapamatujete, protože ji zadáte později při nasazování šablony.

  6. Zkopírujte a vložte do souboru následující kód JSON:

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

    Vaše prostředí Visual Studio Code vypadat takhle:

    Šablona ARM Visual Studio Code první šablonu

    Tato šablona nenasazovat žádné prostředky. Začínáme s prázdnou šablonou, abyste se mohli seznámit s postupem nasazení šablony a zároveň minimalizovat pravděpodobnost, že se něco pokazí.

    Soubor JSON obsahuje tyto prvky:

    • $schema: Určuje umístění souboru schématu JSON. Soubor schématu popisuje vlastnosti, které jsou k dispozici v rámci šablony. Například schéma definuje jako resources jednu z platných vlastností šablony. Nedělejte si starosti, že datum pro schéma je 2019-04-01. Tato verze schématu je aktuální a zahrnuje všechny nejnovější funkce. Datum schématu se nezměnilo, protože od svého úvodu nebyly provedeny žádné změny, které by rušil.
    • contentVersion: Určuje verzi šablony (například 1.0.0.0). Pro tento prvek můžete zadat libovolnou hodnotu. Tuto hodnotu použijte k dokumentovat významné změny v šabloně. Při nasazování prostředků pomocí šablony můžete tuto hodnotu použít k tomu, abyste se ujistili, že se používá ta pravá šablona.
    • resources: Obsahuje prostředky, které chcete nasadit nebo aktualizovat. V současné době je prázdný, ale prostředky přidáte později.
  7. Soubor uložte.

Blahopřejeme, vytvořili jste svou první šablonu.

Přihlášení k Azure

Pokud chcete začít pracovat s Azure PowerShell nebo Azure CLI, přihlaste se pomocí svých přihlašovacích údajů Azure.

Vyberte karty v následujících oddílech kódu a zvolte si mezi Azure PowerShell a Azure CLI. Příklady rozhraní příkazového řádku v tomto článku jsou napsané pro prostředí Bash.

Connect-AzAccount

Pokud máte více předplatných Azure, vyberte předplatné, které chcete použít. Nahraďte SubscriptionName názvem vašeho předplatného. Místo názvu předplatného můžete také použít ID předplatného.

Set-AzContext SubscriptionName

Vytvoření skupiny prostředků

Při nasazování šablony zadáte skupinu prostředků, která bude tyto prostředky obsahovat. Před spuštěním příkazu k nasazení vytvořte skupinu prostředků. Použijte k tomu Azure CLI nebo Azure PowerShell.

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

Nasazení šablony

K nasazení šablony použijte Azure CLI nebo Azure PowerShell. Použijte skupinu prostředků, kterou jste vytvořili. Zadejte název nasazení, abyste ho mohli snadno identifikovat v historii nasazení. Pro usnadnění také vytvořte proměnnou, která ukládá cestu k souboru šablony. Tato proměnná vám usnadní spouštění příkazů nasazení, protože nebudete muset znovu zadávat cestu při každém nasazování. Nahraďte {provide-the-path-to-the-template-file} a složené závorky cestou k {} souboru šablony.

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

Příkaz nasazení vrátí výsledky. Vyhledejte ProvisioningState , abyste viděli, jestli nasazení proběhlo úspěšně.

Poznámka

Pokud nasazení selhalo, pomocí verbose přepínače získejte informace o vytvářených zdrojích. Pokud chcete debug získat další informace o ladění, použijte přepínač .

Ověření nasazení

Nasazení můžete ověřit prozkoumáním skupiny prostředků z Azure Portal.

  1. Přihlaste se k webu Azure Portal.

  2. V nabídce vlevo vyberte skupiny prostředků.

  3. V posledním postupu vyberte nasazení skupiny prostředků. Výchozí název je myResourceGroup. V rámci skupiny prostředků se nezobrazí žádný prostředek nasazený.

  4. Všimněte si, že v pravém horním rohu přehledu se zobrazí stav nasazení. Vyberte 1 úspěšné.

    Zobrazit stav nasazení

  5. Zobrazí se historie nasazení pro skupinu prostředků. Vyberte blanktemplate.

    Vybrat nasazení

  6. Zobrazí se souhrn nasazení. V tomto případě není k dispozici hodně prostředků, protože nebyly nasazeny žádné prostředky. Později v této sérii může být užitečné zkontrolovat souhrn v historii nasazení. Na levé straně si můžete zobrazit vstupy, výstupy a šablony použité během nasazování.

    Zobrazit souhrn nasazení

Vyčištění prostředků

Pokud se chystáte pokračovat k dalšímu kurzu, nemusíte odstranit skupinu prostředků.

Pokud nyní provádíte zastavování, možná budete chtít odstranit skupinu prostředků.

  1. Z Azure Portal v nabídce vlevo vyberte Skupina prostředků .
  2. Do pole Filtrovat podle názvu zadejte název skupiny prostředků.
  3. Vyberte název skupiny prostředků.
  4. V horní nabídce vyberte Odstranit skupinu prostředků .

Další kroky

Vytvořili jste jednoduchou šablonu pro nasazení do Azure. V dalším kurzu přidáte účet úložiště do šablony a nasadíte ho do vaší skupiny prostředků.