Sdílet prostřednictvím

Kurz: Přidání parametrů do šablony ARM

V předchozím kurzu jste se dozvěděli, jak do šablony přidat účet úložiště Azure a nasadit ho. V tomto kurzu se dozvíte, jak vylepšit šablonu Azure Resource Manageru (šablonu ARM) přidáním parametrů. Dokončení této instrukce trvá 14 minut .

Požadavky

Doporučujeme, abyste dokončili kurz o prostředcích, ale není to nutné.

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

Kontrola šablony

Na konci předchozího kurzu má vaše šablona následující soubor JSON:

{
  "$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
      }
    }
  ]
}

Můžete si všimnout, že u této šablony došlo k problému. Název účtu úložiště je pevně zakódovaný. Tuto šablonu můžete použít pouze k nasazení stejného účtu úložiště pokaždé. Pokud chcete nasadit účet úložiště s jiným názvem, musíte vytvořit novou šablonu, což samozřejmě není praktický způsob, jak automatizovat nasazení.

Znovupoužitelná šablona

Pokud chcete, aby byla šablona opakovaně použitelná, přidejte parametr, který můžete použít k předání názvu účtu úložiště. Soubor JSON v následujícím příkladu ukazuje změny v šabloně. Parametr storageName je identifikován jako řetězec. Název účtu úložiště je všechna malá písmena nebo číslice a má limit 24 znaků.

Zkopírujte celý soubor a nahraďte šablonu jejím obsahem:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storageName": {
      "type": "string",
      "minLength": 3,
      "maxLength": 24
    }
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2025-06-01",
      "name": "[parameters('storageName')]",
      "location": "eastus",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    }
  ]
}

Nasazení šablony

Pojďme šablonu nasadit. Následující příklad nasadí šablonu pomocí Azure CLI nebo Azure PowerShellu. Všimněte si, že název účtu úložiště zadáte jako jednu z hodnot v příkazu nasazení. Jako název účtu úložiště zadejte stejný název, který jste použili v předchozím kurzu.

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 proměnnou nastavíte templateFile na cestu k souboru šablony, jak je znázorněno v prvním kurzu.

New-AzResourceGroupDeployment `
  -Name addnameparameter `
  -ResourceGroupName myResourceGroup `
  -TemplateFile $templateFile `
  -storageName "{your-unique-name}"

Pochopte aktualizace prostředků

Když nasadíte účet úložiště se stejným názvem, jaký jste použili dříve, může vás zajímat, jak opětovné nasazení ovlivňuje prostředek.

Pokud prostředek již existuje a ve vlastnostech není žádná změna, není nutné provádět další akce. Pokud prostředek existuje a vlastnost se změní, prostředek se aktualizuje. Pokud prostředek neexistuje, vytvoří se.

Tento způsob zpracování aktualizací znamená, že vaše šablona může zahrnovat všechny prostředky, které potřebujete pro řešení Azure. Šablonu můžete bezpečně nasadit a vědět, že se prostředky mění nebo se vytvářejí jenom v případě potřeby. Pokud do účtu úložiště přidáte například soubory, můžete účet úložiště znovu nasadit, aniž byste ztratili soubory.

Přizpůsobení podle prostředí

Parametry umožňují přizpůsobit nasazení tím, že poskytují hodnoty přizpůsobené konkrétnímu prostředí. Můžete například předat různé hodnoty na základě toho, jestli nasazujete do vývojového, testovacího nebo produkčního prostředí.

Předchozí šablona vždy nasadí standardní místně redundantní úložiště (LRS) Standard_LRS účet. V závislosti na prostředí můžete chtít flexibilitu nasadit různé skladové jednotky (SKU). Následující příklad ukazuje změny přidání parametru pro skladovou položku. Zkopírujte celý soubor a vložte ho do šablony:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storageName": {
      "type": "string",
      "minLength": 3,
      "maxLength": 24
    },
    "storageSKU": {
      "type": "string",
      "defaultValue": "Standard_LRS",
      "allowedValues": [
        "Standard_LRS",
        "Standard_GRS",
        "Standard_RAGRS",
        "Standard_ZRS",
        "Premium_LRS",
        "Premium_ZRS",
        "Standard_GZRS",
        "Standard_RAGZRS"
      ]
    }
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2025-06-01",
      "name": "[parameters('storageName')]",
      "location": "eastus",
      "sku": {
        "name": "[parameters('storageSKU')]"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    }
  ]
}

Parametr storageSKU má výchozí hodnotu. Tuto hodnotu použijte, pokud nasazení ho nezadá. Obsahuje také seznam povolených hodnot. Tyto hodnoty odpovídají hodnotám potřebným k vytvoření účtu úložiště. Chcete, aby uživatelé šablony předali SKU (jednotky skladových zásob), které fungují.

Opětovné nasazení šablony

Jste připraveni k opětovnému nasazení. Výchozí skladová položka je nastavená na Standard_LRS, a proto jste již zadali hodnotu parametru.

New-AzResourceGroupDeployment `
  -Name addskuparameter `
  -ResourceGroupName myResourceGroup `
  -TemplateFile $templateFile `
  -storageName "{your-unique-name}"

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í.

Pokud chcete vidět flexibilitu šablony, pojďme ji znovu nasadit. Tentokrát nastavte parametr skladové položky na standardní geograficky redundantní úložiště (GRS) Standard_GRS. Můžete buď předat nový název a vytvořit jiný účet úložiště, nebo použít stejný název k aktualizaci existujícího účtu úložiště. Obě možnosti fungují.

New-AzResourceGroupDeployment `
  -Name usenondefaultsku `
  -ResourceGroupName myResourceGroup `
  -TemplateFile $templateFile `
  -storageName "{your-unique-name}" `
  -storageSKU Standard_GRS

Nakonec spustíme ještě jeden test a podíváme se, co se stane, když předáte skladovou položku, která není jednou z povolených hodnot. V tomto případě otestujeme scénář, ve kterém si uživatel šablony myslí, že základní je jedním ze skladových položek.

New-AzResourceGroupDeployment `
  -Name testskuparameter `
  -ResourceGroupName myResourceGroup `
  -TemplateFile $templateFile `
  -storageName "{your-unique-name}" `
  -storageSKU basic

Příkaz selže okamžitě s chybovou zprávou, která uvádí povolené hodnoty. Procesor ARM najde chybu před spuštěním nasazení.

Vyčistěte zdroje

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

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

  1. Na webu Azure Portal vyberte v nabídce vlevo skupinu prostředků .
  2. Do textového pole Filtr pro libovolné pole... zadejte název skupiny prostředků.
  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ů .

Další kroky

Vylepšili jste šablonu, kterou jste vytvořili v prvním kurzu přidáním parametrů. V dalším kurzu se dozvíte o funkcích šablon.

Přidání funkcí šablony

  • Last updated on