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

Tento kurz vás seznámí se šablonami Azure Resource Manager (šablony ARM). Ukazuje, jak vytvořit úvodní šablonu a nasadit ji do Azure. Naučí vás o struktuře šablon a nástrojích, které potřebujete pro práci se šablonami. Dokončení této instrukce trvá 12 minut , ale skutečná doba dokončení se liší podle toho, kolik nástrojů potřebujete nainstalovat.

Tento kurz je první ze série. Při procházení řady upravíte počáteční šablonu krok za krokem, dokud neprojdete všechny základní části šablony ARM. Tyto prvky jsou stavebními bloky pro složitější šablony. Doufáme, že na konci série si nejste 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 automatizovat nasazení pomocí šablon, podívejte se na přehled šablon ARM. Další informace o šablonách ARM prostřednictvím sady modulů Learn najdete v tématu Nasazení a správa prostředků v Azure pomocí šablon ARM JSON.

Pokud nemáte předplatné Microsoft Azure, vytvořte si před zahájením bezplatný účet .

Tip

Pokud s šablonami ARM začínáte, můžete místo toho zvážit učení Bicep. Bicep je nový jazyk, který nabízí stejné funkce jako šablony ARM, ale s jednodušší syntaxí. Pokud chcete začít učit bicep, přečtěte si téma Rychlý start: Vytváření souborů Bicep pomocí editoru Visual Studio Code.

Získání nástrojů

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

Editor

Šablony jsou soubory JSON (JavaScript Object Notation). K vytváření šablon potřebujete dobrý editor JSON. Visual Studio Code doporučujeme s rozšířením Azure Resource Manager Tools. Pokud potřebujete nainstalovat tyto nástroje, přečtěte si téma Rychlý start: Vytvoření šablon ARM pomocí editoru Visual Studio Code.

Nasazení příkazového řádku

K nasazení šablony potřebujete také Azure PowerShell nebo rozhraní Azure Command-Line (CLI). Pokud používáte Azure CLI, musíte mít verzi 2.37.0 nebo novější. Pokyny k instalaci najdete tady:

Po instalaci Azure PowerShell nebo Azure CLI se ujistěte, že se poprvé přihlásíte. 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.37.0 nebo novější. Pokud používáte Azure PowerShell, ujistěte se, že máte verzi 7.2.4 nebo novější. Příkazy uvedené v tomto kurzu nefungují, pokud používáte starší verze. Pokud chcete zkontrolovat nainstalovanou verzi, použijte: az --version.

Dobře, jste připraveni začít se učit o šablonách.

Vytvoření první šablony

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

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

  3. V nabídce Soubor vyberte Uložit jako.

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

  5. Uložte soubor na pracovní stanici. Vyberte cestu, která je snadno zapamatovatelná, protože při nasazení šablony je potřeba tuto cestu zadat později.

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

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

    Takto vypadá prostředí Visual Studio Code:

    Šablona ARM Visual Studio Code – první šablona.

    Tato šablona nenasazuje žádné prostředky. Začínáme prázdnou šablonou, abyste se seznámili s postupem nasazení šablony a minimalizovali tak pravděpodobnost, že se něco pokazí.

    Soubor JSON má 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. Schéma například definuje resources jako jednu z platných vlastností šablony. Nedělejte si starosti, že datum schématu je 2019-04-01. Tato verze schématu je aktuální a obsahuje všechny nejnovější funkce. Datum schématu se nezměnilo, protože od jejího zavedení nedošlo k žádným zásadním změnám.
    • contentVersion: Určuje verzi šablony, například 1.0.0.0. Pro tento prvek můžete zadat libovolnou hodnotu. Pomocí této hodnoty můžete zdokumentovat významné změny v šabloně. Při nasazování prostředků pomocí šablony můžete tuto hodnotu použít, abyste měli jistotu, že používáte správnou šablonu.
    • resources: Obsahuje prostředky, které chcete nasadit nebo aktualizovat. V současné době je prázdný, ale později můžete přidat prostředky.
  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 částech kódu a vyberte 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, zvolte předplatné, které chcete použít. Nahraďte SubscriptionName názvem předplatného. Můžete také místo názvu předplatného použít SVÉ ID předplatného.

Set-AzContext SubscriptionName

Vytvoření skupiny prostředků

Když nasazujete šablonu, můžete zadat skupinu prostředků, která bude obsahovat prostředky. Před spuštěním příkazu k nasazení vytvořte skupinu prostředků. Použijte k tomu Bash Azure CLI nebo Azure PowerShell.

Poznámka

Ukázky pro Azure CLI jsou napsané pro prostředí Bash. Pokud chcete tuto ukázku spustit v Windows PowerShell nebo příkazovém řádku, budete možná muset odebrat zpětné lomítka a napsat příkaz jako jeden řádek, například:

az group create --name myResourceGroup --location "Central US"

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. Pojmenujte nasazení, abyste ho mohli snadno identifikovat v historii nasazení. Pro usnadnění můžete také vytvořit 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} 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. ProvisioningState Vyhledejte, jestli nasazení proběhlo úspěšně.

Poznámka

Pokud se nasazení nezdaří, pomocí verbose přepínače získejte informace o vytvořených prostředcích. debug Pomocí přepínače získáte další informace pro ladění.

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. Zaškrtněte políčko vlevo od myResourceGroup a vyberte myResourceGroup.

  4. Vyberte skupinu prostředků, kterou jste vytvořili v předchozím postupu. Výchozí název je myResourceGroup. Skupina prostředků ještě nemá žádné prostředky, protože jste nasadili prázdnou šablonu.

  5. Všimněte si uprostřed přehledu v části Základy na stránce se stavem nasazení vedle nasazení. Vyberte 1 úspěch.

    Podívejte se na stav nasazení.

  6. Zobrazí se historie nasazení pro skupinu prostředků. Zaškrtněte políčko vlevo od prázdného objektu a vyberte blanktemplate.

    Vyberte nasazení.

  7. Zobrazí se souhrn nasazení. V tomto případě není moc vidět, protože se nenasazují žádné prostředky. Později v této řadě vám může pomoct projít si souhrn v historii nasazení. Všimněte si, že na levé straně vidíte vstupy, výstupy a šablonu, kterou nasazení použilo.

    Viz souhrn nasazení.

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

Pokud přecházíte k dalšímu kurzu, nemusíte skupinu prostředků odstraňovat.

Pokud se teď zastavíte, možná budete chtít odstranit skupinu prostředků.

  1. V Azure Portal vyberte v nabídce vlevo skupiny prostředků.

  2. Do pole Filtr zadejte název skupiny prostředků pro libovolné textové pole...

  3. Zaškrtněte políčko vedle myResourceGroup a vyberte myResourceGroup nebo název vaší skupiny prostředků.

  4. V horní nabídce vyberte Odstranit skupinu prostředků .

    Viz odstranění.

Další kroky

Vytvořili jste jednoduchou šablonu pro nasazení do Azure. V dalším kurzu se dozvíte, jak přidat účet úložiště do šablony a nasadit ho do skupiny prostředků.