Sdílet prostřednictvím

Návod: Přidání prostředku do šablony Azure Resource Manageru

V předchozím kurzu jste zjistili, jak vytvořit a nasadit první prázdnou šablonu Azure Resource Manageru (šablonu ARM). Teď jste připraveni nasadit do této šablony skutečný prostředek. V tomto případě účet úložiště Azure. Dokončení této instrukce trvá 9 minut .

Požadavky

Doporučujeme, abyste dokončili úvodní kurz o šablonách, ale není to nutné.

Potřebujete Visual Studio Code a Azure PowerShell nebo Azure CLI. Další informace najdete v nástrojích šablon.

Přidání prostředku

Pokud chcete do existující šablony přidat definici účtu úložiště Azure, podívejte se na soubor JSON v následujícím příkladu. Místo toho, abyste se pokusili zkopírovat oddíly šablony, zkopírujte celý soubor a nahraďte šablonu jejím obsahem.

Nahraďte {provide-unique-name} a {} jedinečným názvem účtu pro ukládání dat.

Důležité

Název účtu úložiště musí být jedinečný v rámci Azure. Je to jenom malá písmena nebo číslice a má limit 24 znaků. Jako předponu můžete použít název store1 a pak přidat iniciály a dnešní datum. Název může být například store1abc06132022.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2025-06-01",
      "name": "{provide-unique-name}",
      "location": "eastus",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    }
  ]
}

Určení jedinečného názvu pro účet úložiště není snadné a není ideální pro automatizaci velkých nasazení. Později v této sérii kurzů použijete funkce šablon, které usnadňují vytvoření jedinečného názvu.

Vlastnosti zdroje

Možná vás zajímá, jak najít vlastnosti, které se mají použít pro jednotlivé typy prostředků. K vyhledání typů prostředků, které chcete nasadit, můžete použít referenční informace k šabloně ARM .

Každý prostředek, který nasadíte, má alespoň následující tři vlastnosti:

  • type: Typ prostředku. Tato hodnota je kombinací názvového prostoru poskytovatele prostředků a typu prostředku, například Microsoft.Storage/storageAccounts.
  • apiVersion: Verze rozhraní REST API, která se má použít k vytvoření prostředku. Každý poskytovatel prostředků publikuje vlastní verze rozhraní API, takže tato hodnota je specifická pro daný typ.
  • name: Název prostředku.

Většina prostředků má location také vlastnost, která nastaví oblast, kam prostředek nasadíte.

Ostatní vlastnosti se liší podle typu prostředku a verze rozhraní API. Je důležité pochopit připojení mezi verzí rozhraní API a dostupnými vlastnostmi, takže se pojďme podrobněji seznámit.

V tomto kurzu přidáte do šablony účet úložiště. Verzi rozhraní API účtu úložiště můžete vidět na storageAccounts 2021-09-01. Všimněte si, že do šablony nepřidáte všechny vlastnosti. Řada vlastností je nepovinná. Poskytovatel Microsoft.Storage prostředků může vydat novou verzi rozhraní API, ale verze, kterou nasazujete, se nemusí měnit. Tuto verzi můžete dál používat a víte, že výsledky nasazení jsou konzistentní.

Pokud zobrazíte starší verzi rozhraní API , může se zobrazit, že je k dispozici menší sada vlastností.

Pokud se rozhodnete změnit verzi rozhraní API pro prostředek, ujistěte se, že vyhodnotíte vlastnosti pro danou verzi a odpovídajícím způsobem upravíte šablonu.

Nasazení šablony

Šablonu můžete nasadit a vytvořit účet úložiště. Zadejte jiný název nasazení, abyste ho mohli snadno najít v historii.

Pokud jste skupinu prostředků nevytvořili, přečtěte si téma Vytvoření skupiny prostředků. V příkladu se předpokládá, že jste proměnnou nastavili templateFile na cestu k souboru šablony, jak je znázorněno v prvním kurzu.

New-AzResourceGroupDeployment `
  -Name addstorage `
  -ResourceGroupName myResourceGroup `
  -TemplateFile $templateFile

Poznámka:

Pokud nasazení selže, použijte přepínač verbose k získání informací o prostředcích, které vytváříte. Použijte přepínač debug k získání více informací pro ladění.

Tyto chyby jsou dvě možné selhání nasazení, se kterými se můžete setkat:

  • Error: Code=AccountNameInvalid; Message={provide-unique-name} není platný název účtu úložiště. Název účtu úložiště musí mít délku 3 až 24 znaků a musí používat jenom číslice a malá písmena.

    V šabloně nahraďte {provide-unique-name} jedinečným názvem účtu úložiště. Viz Přidat prostředek.

  • Error: Code=StorageAccountAlreadyTaken; Message=The storage account named store1abc09092019 je již obsazeno.

    V šabloně zkuste použít jiný název účtu úložiště.

Toto nasazení trvá déle než nasazení prázdné šablony, protože vytváříte účet úložiště. Může to trvat asi minutu.

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 použili pro nasazení.
  5. Uvidíte, že účet úložiště byl nasazen.
  6. Všimněte si, že popisek nasazení teď říká: Nasazení: 2 Úspěšné.

Vyčistěte zdroje

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

Pokud se nyní rozhodnete skončit, možná budete chtít odstranit prostředky, které jste nasadili, tím, že smažete skupinu zdrojů.

  1. Na webu Azure Portal vyberte v nabídce vlevo skupinu prostředků .
  2. Do pole Filtr zadejte název skupiny prostředků pro libovolné pole ... .
  3. Zaškrtněte políčko vedle myResourceGroup a vyberte myResourceGroup nebo název skupiny prostředků, kterou jste zvolili.
  4. V horní nabídce vyberte Odstranit skupinu prostředků .

Další kroky

Vytvořili jste jednoduchou šablonu pro nasazení účtu úložiště Azure. V dalších kurzech se dozvíte, jak do šablony přidat parametry, proměnné, prostředky a výstupy. Tyto funkce jsou stavebními bloky pro mnohem složitější šablony.

Přidání parametrů

  • Last updated on