Sdílet prostřednictvím

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

Tento kurz vás seznámí s šablonami Azure Resource Manageru (š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ý čas dokončení se liší podle toho, kolik nástrojů potřebujete nainstalovat.

Tento kurz je první ze série. Při procházení řady upravujete počáteční šablonu krok za krokem, dokud prozkoumáte 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 budete mít jistotu, ž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 JSON ARM.

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

Návod

Pokud s šablonami ARM začínáte, můžete místo toho zvážit výuku Bicep. Bicep je nový jazyk, který nabízí stejné funkce jako šablony ARM, ale s jednodušší syntaxí. Pokud se chcete začít učit Bicep, přečtěte si článek 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 můžete použít Visual Studio Code.

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

K nasazení šablony potřebujete také Azure PowerShell nebo Azure Command-Line Interface (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 PowerShellu 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.

  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 tuto cestu je potřeba zadat později při nasazování šablony.

  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": []
}

    Prostředí Editoru Visual Studio Code vypadá takto:

    Snímek obrazovky editoru Visual Studio Code zobrazující prázdnou šablonu ARM se strukturou JSON v editoru

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

    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 šabloně. Schéma například definuje resources jako jednu z platných vlastností šablony. Nemějte obavy, ž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 prostředky můžete přidat později.

  7. Uložte soubor.

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

Přihlásit se do Azure

Pokud chcete začít pracovat s Azure PowerShellem 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 PowerShellem 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ísto názvu předplatného můžete také použít ID předplatného.

Set-AzContext SubscriptionName

Vytvořit skupinu zdrojů

Když nasadíte šablonu, můžete určit skupinu prostředků pro uložení prostředků. Před spuštěním příkazu pro nasazení vytvořte skupinu prostředků pomocí Azure CLI Bash nebo Azure PowerShellu.

Poznámka:

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

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í také vytvořte proměnnou, která ukládá cestu k souboru šablony. Tato proměnná usnadňuje spouštění příkazů nasazení, protože při každém nasazení nemusíte znovu zadávat cestu. Nahraďte {provide-the-path-to-the-template-file} a {} cestou k vašemu 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, zda nasazení proběhlo úspěšně.

Poznámka:

Pokud nasazení selže, pomocí verbose přepínače získejte informace o vytvořených prostředcích. Použijte přepínač debug k získání více informací pro ladění.

Ověření nasazení

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

  1. Přihlaste se do Azure Portalu.

  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é zdroje, protože jste použili prázdnou šablonu.

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

    Snímek obrazovky webu Azure Portal zobrazující stav nasazení v části Základy ve skupině prostředků

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

    Snímek obrazovky portálu Azure zobrazující historii nasazení s vybraným nasazením 'blanktemplate'.

  7. Zobrazí se souhrn nasazení. V tomto případě není moc vidět, protože nejsou nasazeny žádné prostředky. Později v této sérii může být užitečné si projít souhrn v historii nasazení. Všimněte si, že vlevo vidíte vstupy, výstupy a šablonu, kterou nasazení použilo.

    Snímek obrazovky portálu Azure zobrazující souhrn nasazení pro nasazení typu blanktemplate.

Vyčistěte zdroje

Pokud přecházíte k dalšímu kurzu, není nutné skupinu prostředků mazat.

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

  1. Na webu 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ů .

    Snímek obrazovky webu Azure Portal se zvýrazněnou možností Odstranit skupinu prostředků v zobrazení skupiny prostředků

Další kroky

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

Přidat prostředek

  • Last updated on