Kurz: Přidání prostředku do šablony ARM

Článek
06/20/2024

V předchozím kurzu jste zjistili, jak vytvořit a nasadit první prázdnou šablonu Azure Resource Manager (š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é.

Musíte mít nainstalovaný Visual Studio Code a pracovat s rozšířením Azure Resource Manager Tools a Azure PowerShell nebo Rozhraní příkazového řádku Azure Command-Line (CLI). Další informace najdete v tématu Nástroje šablon.

Přidat prostředek

Pokud chcete do existující šablony přidat definici účtu úložiště Azure, podívejte se na zvýrazněný 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 složené závorky {} jedinečným názvem účtu úložiště.

Důležité

Název účtu úložiště musí být v rámci Azure jedinečný. Jsou to jenom malá písmena nebo číslice a má limit 24 znaků. Jako předponu můžete použít název , jako je store1 , a pak přidat svoje 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": "2021-09-01",
      "name": "{provide-unique-name}",
      "location": "eastus",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    }
  ]
}

Uhádnutí jedinečného názvu účtu úložiště není jednoduché a nefunguje dobře pro automatizaci rozsáhlý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 prostředku

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í oboru názvů 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á nastavuje oblast, do které prostředek nasadíte.

Ostatní vlastnosti se liší podle typu prostředku a verze rozhraní API. Je důležité pochopit propojení mezi verzí rozhraní API a dostupnými vlastnostmi, takže pojďme přejít k dalším podrobnostem.

V tomto kurzu přidáte do šablony účet úložiště. Verzi rozhraní API účtu úložiště najdete na stránce storageAccounts 2021-09-01. Všimněte si, že do šablony nepřidáte všechny vlastnosti. Mnohé z těchto vlastností jsou volitelné. Poskytovatel Microsoft.Storage prostředků může vydat novou verzi rozhraní API, ale nasazovaná verze se nemusí měnit. Tuto verzi můžete dál používat a víte, že výsledky vašeho nasazení jsou konzistentní.

Pokud zobrazíte starší verzi rozhraní API , můžete vidět, že je k dispozici menší sada vlastností.

Pokud se rozhodnete změnit verzi rozhraní API pro prostředek, nezapomeňte vyhodnotit vlastnosti této verze a odpovídajícím způsobem upravit šablonu.

Nasazení šablony

Nasazením šablony můžete vytvořit účet úložiště. Dejte svému nasazení jiný název, 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ů. Příklad předpokládá, že jste proměnnou templateFile nastavili na cestu k souboru šablony, jak je znázorněno v prvním kurzu.

PowerShell
Azure CLI

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

Ke spuštění tohoto příkazu pro nasazení potřebujete nejnovější verzi Azure CLI.

az deployment group create \
  --name addstorage \
  --resource-group myResourceGroup \
  --template-file $templateFile

Poznámka

Pokud nasazení selže, pomocí verbose přepínače získejte informace o prostředcích, které vytváříte. debug Pomocí přepínače získáte další informace o ladění.

Jedná se o 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í být dlouhý 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řidání prostředku.
Error: Code=StorageAccountAlreadyTaken; Message=The storage account named store1abc09092019 již byla odebrána.

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ů z Azure Portal.

Přihlaste se k webu Azure Portal.
V nabídce vlevo vyberte Skupiny prostředků.
Zaškrtněte políčko nalevo od myResourceGroup a vyberte myResourceGroup.
Vyberte skupinu prostředků, do které jste nasadili.
Uvidíte, že se účet úložiště nasadil.
Všimněte si, že popisek nasazení teď uvádí: Nasazení: 2 Úspěšné.

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

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

Pokud teď zastavujete, možná budete chtít nasazené prostředky vyčistit odstraněním skupiny prostředků.

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

Další kroky

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

Přidání parametrů

Sdílet prostřednictvím