Kifejezések újbóli használata az Azure Resource Manager-sablon változóival

  • 3 perc

Az előző forgatókönyvben úgy döntött, hogy az Azure-tárfiók egyedi nevének létrehozásához az Azure Resource Manager- (ARM-) sablon több függvényéből álló kifejezést használ. Ez a rugalmasság biztosítja, hogy minden ügyfél használhatja az ARM-sablont az üzemelő példányaikhoz. Azt azonban tapasztalja, hogy a kifejezés több helyen való hozzáadása problémát jelent a sablon karbantartása során. Ön úgy dönt, hogy a tárfiók nevének kifejezéséhez változót használ, így egyetlen helyen határozhatja meg a kifejezést, de több helyen felhasználhatja a sablonban.

Mi az az ARM-sablonváltozó?

Az ARM-sablonváltozó egy olyan konstrukció, amely egy értéket tárol a későbbi használathoz. Amikor egy értéket több helyen kell megadni egy sablonban, érdemes változót használni. Mindenhol, ahol a sablonban a változót kell használni, a Resource Manager lecseréli a változót a feloldott értékre.

Van például egy olyan kifejezése, amely az erőforrás helyének értékét határozza meg. A sablonban definiált erőforrások közül többnek helyre van szüksége. Létrehozhat egy változót a helykifejezés tárolásához, majd a változót bárhol használhatja, ahol szükség van rá.

Az ARM-sablonváltozók használatának előnyei

Az ARM-sablonváltozók lehetővé teszik egy kifejezés egyszeri megírását, majd több helyen történő használatát. Emellett a kifejezés karbantartása is egy helyen történik, és a sablon könnyebben olvasható.

Hogyan használhatok ARM-sablonváltozókat?

Az ARM-sablonváltozók a sablon variables: {} szakaszában vannak definiálva. Itt például a tárfiók nevének változója látható, amelyet az előző leckében határozott meg. Most ez határozza meg a storageName változó értékét.

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

Ezután használja ezt a változót a sablonban mindenhol, ahol meg kell adni a tárfiók nevét:

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

Javaslatok az ARM-sablonváltozók használatához

A sablonváltozókat CamelCase, azaz szóközi nagybetűs formátumban adjuk meg. A leghatékonyabban azokhoz az értékekhez használhatók, amelyeket többször is meg kell adni, különösen, ha az érték egy összetett kifejezés.

Ne használja a reference függvényt a sablon változók szakaszában. A reference függvényt futásidőben oldja fel a rendszer, a változók feloldása pedig a sablon elemzésekor történik. Ne használjon változókat az erőforrások apiVersion értékéhez. Az API-verzió határozza meg az erőforrás sémáját, és sok esetben a verzió nem módosítható az erőforrás tulajdonságainak módosítása nélkül.