Kurz: Přidání proměnných do šablony ARM
V tomto kurzu se naučíte přidat proměnnou do šablony Azure Resource Manager (šablona ARM). Proměnné zjednodušují šablony. Umožňují vám napsat výraz jednou a znovu ho použít v celé šabloně. Dokončení tohoto kurzu trvá 7 minut .
Požadavky
Doporučujeme absolvovat kurz o funkcí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 Azure CLI. Další informace najdete v tématu Nástroje šablon.
Zkontrolovat šablonu
Na konci předchozího kurzu měla 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",
"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"
]
},
"location": {
"type": "string",
"defaultValue": "[resourceGroup().location]"
}
},
"resources": [
{
"type": "Microsoft.Storage/storageAccounts",
"apiVersion": "2021-09-01",
"name": "[parameters('storageName')]",
"location": "[parameters('location')]",
"sku": {
"name": "[parameters('storageSKU')]"
},
"kind": "StorageV2",
"properties": {
"supportsHttpsTrafficOnly": true
}
}
]
}
Aby bylo možné snadno pokračovat v sestavování šablony ARM, musí být název účtu úložiště Azure jedinečný. Pokud jste dokončili předchozí kurzy v této sérii, už vás unavuje přijít s jedinečným názvem. Tento problém vyřešíte přidáním proměnné, která vytvoří jedinečný název pro váš účet úložiště.
Použití proměnné
Následující příklad zvýrazňuje změny pro přidání proměnné do šablony, která vytvoří jedinečný název účtu úložiště. 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": {
"storagePrefix": {
"type": "string",
"minLength": 3,
"maxLength": 11
},
"storageSKU": {
"type": "string",
"defaultValue": "Standard_LRS",
"allowedValues": [
"Standard_LRS",
"Standard_GRS",
"Standard_RAGRS",
"Standard_ZRS",
"Premium_LRS",
"Premium_ZRS",
"Standard_GZRS",
"Standard_RAGZRS"
]
},
"location": {
"type": "string",
"defaultValue": "[resourceGroup().location]"
}
},
"variables": {
"uniqueStorageName": "[concat(parameters('storagePrefix'), uniqueString(resourceGroup().id))]"
},
"resources": [
{
"type": "Microsoft.Storage/storageAccounts",
"apiVersion": "2021-09-01",
"name": "[variables('uniqueStorageName')]",
"location": "[parameters('location')]",
"sku": {
"name": "[parameters('storageSKU')]"
},
"kind": "StorageV2",
"properties": {
"supportsHttpsTrafficOnly": true
}
}
]
}
Všimněte si, že obsahuje proměnnou s názvem uniqueStorageName. Tato proměnná používá k vytvoření řetězcové hodnoty čtyři funkce.
Funkci parametrů už znáte, takže ji nebudeme zkoumat.
Znáte také funkci resourceGroup . V tomto případě získáte id místo vlastnosti vlastnost location , jak je znázorněno v předchozím kurzu. Vlastnost id vrátí úplný identifikátor skupiny prostředků, včetně ID předplatného a názvu skupiny prostředků.
Funkce uniqueString vytvoří 13znakovou hodnotu hash. Parametry, které předáte, určují vrácenou hodnotu. V tomto kurzu použijete JAKO vstup pro hodnotu hash ID skupiny prostředků. To znamená, že tuto šablonu můžete nasadit do různých skupin prostředků a získat jinou jedinečnou hodnotu řetězce. Stejnou hodnotu ale získáte, pokud nasadíte do stejné skupiny prostředků.
Funkce concat přebírá hodnoty a kombinuje je. Pro tuto proměnnou vezme řetězec z parametru a řetězec z uniqueString funkce a zkombinuje je do jednoho řetězce.
Parametr storagePrefix umožňuje předat předponu, která vám pomůže identifikovat účty úložiště. Můžete vytvořit vlastní zásady vytváření názvů, které usnadňují identifikaci účtů úložiště po nasazení z rozsáhlého seznamu prostředků.
Nakonec si všimněte, že název účtu úložiště je teď nastavený na proměnnou místo parametru.
Nasazení šablony
Pojďme nasadit šablonu. Nasazení této šablony je jednodušší než u předchozích šablon, protože pro název účtu úložiště zadáte jenom předponu.
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.
New-AzResourceGroupDeployment `
-Name addnamevariable `
-ResourceGroupName myResourceGroup `
-TemplateFile $templateFile `
-storagePrefix "store" `
-storageSKU Standard_LRS
Poznámka
Pokud nasazení selže, použijte verbose přepínač k získání informací o vytvář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ů ze Azure Portal.
- Přihlaste se k webu Azure Portal.
- V nabídce vlevo vyberte Skupiny prostředků.
- Vyberte skupinu prostředků.
- Všimněte si, že název vašeho nasazeného účtu úložiště je úložiště a řetězec náhodných znaků.
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 skupinu prostředků odstranit.
- V Azure Portal v nabídce vlevo vyberte Skupiny prostředků.
- Do textového pole Filtr pro libovolné pole... zadejte název skupiny prostředků.
- Zaškrtněte políčko vedle myResourceGroup a vyberte myResourceGroup nebo název vaší skupiny prostředků.
- V horní nabídce vyberte Odstranit skupinu prostředků .
Další kroky
V tomto kurzu přidáte proměnnou, která vytvoří jedinečný název účtu úložiště. V dalším kurzu vrátíte hodnotu z nasazeného účtu úložiště.