Opakované použití výrazů pomocí proměnných šablon Azure Resource Manageru

Dokončeno

V předchozím scénáři jste se rozhodli použít výraz tvořený několika funkcemi šablony Azure Resource Manageru (ARM) k vytvoření jedinečného názvu účtu úložiště Azure. Tato flexibilita zajišťuje, že všichni vaši zákazníci budou moct používat šablonu ARM pro svá nasazení. Všimněte si ale, že přidání tohoto výrazu na několika místech je problém při údržbě šablony. Rozhodnete se použít proměnnou pro výraz názvu účtu úložiště, abyste mohli výraz definovat na jednom místě a znovu ho použít v celé šabloně.

Co je proměnná šablony ARM?

Proměnná šablony ARM je konstrukce, která obsahuje hodnotu pro pozdější použití. Proměnné se nejlépe používají, když je potřeba zadat hodnotu na několika místech v šabloně. Kdekoli se proměnná v šabloně používá, Resource Manager ji nahradí vyhodnocenou hodnotou.

Máte například výraz, který definuje hodnotu pro umístění prostředku. Několik prostředků, které jste definovali v šabloně, vyžadují umístění. Můžete vytvořit proměnnou, která bude obsahovat výraz umístění, a pak proměnnou použít všude, kde je požadováno umístění.

Výhody použití proměnných šablon ARM

Proměnné šablony ARM umožňují napsat výraz jednou a pak ho použít na několika místech. Také správa výrazu je na jednom místě a šablona je čitelnější.

Jak se používají proměnné šablony ARM?

Proměnné šablony ARM jsou definovány v části variables: {} šablony. Tady je například výraz pro název účtu úložiště, který jste definovali v poslední lekci. Teď definuje hodnotu proměnné storageName.

"variables": {
  "storageName": "[concat(toLower(parameters('storageNamePrefix')), uniqueString(resourceGroup().id))]"
},

Proměnnou v šabloně pak použijete všude, kde potřebujete název účtu úložiště:

"resources": [
  {
    "type": "Microsoft.Storage/storageAccounts",
    "name": "[variables('storageName')]",
    ...
  }
]

Doporučení pro proměnné šablony ARM

Proměnné šablony jsou uvedeny ve formátu camel case. Nejlépe se používají pro hodnoty, které potřebujete zadat více než jednou, zejména pokud je tato hodnota složitým výrazem.

Nepoužívejte funkci reference v části proměnných šablony. Funkce reference se vyřeší za běhu a proměnné se vyřeší při analýze šablony. Také nepoužívejte proměnné pro apiVersion na zdroji. Verze rozhraní API určuje schéma prostředku a často nemůžete změnit verzi beze změny vlastností prostředku.