Dinamikus tervek létrehozása paraméterekkel

A különböző összetevőket, például erőforráscsoportokat, Azure Resource Manager-sablonokat (ARM-sablonokat), szabályzatokat vagy szerepkör-hozzárendeléseket tartalmazó teljes terv lehetővé teszi objektumok gyors létrehozását és konzisztens létrehozását az Azure-ban. Ezeknek az újrafelhasználható tervezési mintáknak és tárolóknak a rugalmas használata érdekében az Azure Blueprints támogatja a paramétereket. A paraméter a definíció és a hozzárendelés során is rugalmasan módosítja a terv által üzembe helyezett összetevők tulajdonságait.

Egy egyszerű példa az erőforráscsoport-összetevő. Egy erőforráscsoport létrehozásakor két kötelező értéket kell megadnia: a nevet és a helyet. Ha erőforráscsoportot ad hozzá a tervhez, ha nem léteznek paraméterek, akkor ezt a nevet és helyet kell megadnia a terv minden használatához. Ez az ismétlődés azt eredményezné, hogy a terv minden egyes használata ugyanabban az erőforráscsoportban hoz létre összetevőket. Az adott erőforráscsoportban lévő erőforrások duplikálódnak, és ütközést okoznak.

A probléma megoldása a paraméterek. Az Azure Blueprints lehetővé teszi az összetevő minden tulajdonságának értékét az előfizetéshez való hozzárendelés során. A paraméter lehetővé teszi egy olyan terv újbóli használatát, amely egy erőforráscsoportot és más erőforrásokat hoz létre egyetlen előfizetésen belül ütközés nélkül.

Tervparaméterek

A REST API-n keresztül paraméterek hozhatók létre a terven. Ezek a paraméterek eltérnek a támogatott összetevők paramétereiétől. Amikor létrehoz egy paramétert a terven, azt a terv összetevői használhatják. Ilyen lehet például az erőforráscsoport elnevezésének előtagja. Az összetevő a tervparaméterrel létrehozhat egy "többnyire dinamikus" paramétert. Mivel a paraméter a hozzárendelés során is meghatározható, ez a minta olyan konzisztenciát tesz lehetővé, amely megfelelhet az elnevezési szabályoknak. A lépésekért tekintse meg a statikus paraméterek beállítását – tervszintű paramétert.

SecureString és secureObject paraméterek használata

Bár egy ARM-sablonösszetevő támogatja a secureString és a secureObject típus paramétereit, az Azure Blueprints használatához mindegyiknek csatlakoznia kell egy Azure Key Vaulthoz. Ez a biztonsági intézkedés megakadályozza a titkos kódok és a tervekkel együtt történő tárolásának nem biztonságos gyakorlatát, és ösztönzi a biztonságos minták alkalmazását. Az Azure Blueprints támogatja ezt a biztonsági mértéket, és észleli, hogy bármelyik biztonságos paraméter szerepel egy ARM-sablonösszetevőben. A szolgáltatás ezután a hozzárendelés során a következő Key Vault-tulajdonságokat kéri az észlelt biztonságos paraméterenként:

• Key Vault-erőforrás-azonosító
• Key Vault titkos kód neve
• Key Vault titkos verziója

Ha a terv-hozzárendelés rendszer által hozzárendelt felügyelt identitást használ, a hivatkozott Key Vaultnak ugyanabban az előfizetésben kell lennie, amelyhez a tervdefiníció hozzá van rendelve.

Ha a terv-hozzárendelés felhasználó által hozzárendelt felügyelt identitást használ, a hivatkozott Key Vault egy központi előfizetésben is létezhet. A terv hozzárendelése előtt a felügyelt identitásnak megfelelő jogosultságokat kell biztosítani a Key Vaulton.

Az Azure Key Vaultról további információt a Key Vault áttekintésében talál.

Paramétertípusok

Statikus paraméterek

A terv definíciójában definiált paraméterértéket statikus paraméternek nevezzük, mivel a terv minden használata ezzel a statikus értékkel fogja üzembe helyezni az összetevőt. Az erőforráscsoport-példában, bár nincs értelme az erőforráscsoport nevének, a helynek lehet értelme. Ezután a terv minden hozzárendelése létrehozná az erőforráscsoportot, függetlenül attól, hogy a hozzárendelés során hívják-e, ugyanazon a helyen. Ez a rugalmasság lehetővé teszi, hogy szelektíven határozza meg a szükséges, és mi módosítható a hozzárendelés során.

Statikus paraméterek beállítása a portálon

1. A bal oldali panelen válassza a Minden szolgáltatás lehetőséget. Keresse meg és válassza ki a Tervek elemet.

2. A bal oldalon válassza a Tervdefiníciók lehetőséget .

3. Jelöljön ki egy meglévő tervet, majd válassza a Terv szerkesztése vagy a + Terv létrehozása lehetőséget, és töltse ki az információkat az Alapismeretek lapon.

4. Válassza a Tovább: Összetevők vagy az Összetevők lapot.

5. A tervhez hozzáadott, paraméterbeállításokat tartalmazó összetevők a Paraméterek oszlopban kitöltött Y paraméterek X-jét jelenítik meg. Válassza ki az összetevősort az összetevő paramétereinek szerkesztéséhez.

   

6. Az Összetevő szerkesztése lapon a kiválasztott összetevőnek megfelelő értékbeállítások jelennek meg. Az összetevő minden paraméterének van egy címe, egy értékmezője és egy jelölőnégyzete. Állítsa be a jelölőnégyzet bejelöletlenné, hogy statikus paraméter legyen. Az alábbi példában csak a Hely statikus paraméter , mivel nincs bejelölve, és az erőforráscsoport neve be van jelölve.

   

Statikus paraméterek beállítása a REST API-ból

Minden REST API URI tartalmaz olyan változókat, amelyeket le kell cserélnie saját értékekre:

• {YourMG} – Cserélje le a felügyeleti csoport nevére
• {subscriptionId} – Cserélje le az előfizetése azonosítójára

Tervszintű paraméter

Terv REST API-val történő létrehozásakor tervparaméterek hozhatók létre. Ehhez használja a következő REST API URI-t és törzsformátumot:

• REST API URI

  PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/{YourMG}/providers/Microsoft.Blueprint/blueprints/MyBlueprint?api-version=2018-11-01-preview
  

• Kérelem törzse

  {
      "properties": {
          "description": "This blueprint has blueprint level parameters.",
          "targetScope": "subscription",
          "parameters": {
              "owners": {
                  "type": "array",
                  "metadata": {
                      "description": "List of AAD object IDs that is assigned Owner role at the resource group"
                  }
              }
          },
          "resourceGroups": {
              "storageRG": {
                  "description": "Contains the resource template deployment and a role assignment."
              }
          }
      }
  }
  

A tervszintű paraméter létrehozása után a tervhez hozzáadott összetevőkön is használható. Az alábbi REST API-példa létrehoz egy szerepkör-hozzárendelési összetevőt a terven, és a tervszintű paramétert használja.

• REST API URI

  PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/{YourMG}/providers/Microsoft.Blueprint/blueprints/MyBlueprint/artifacts/roleOwner?api-version=2018-11-01-preview
  

• Kérelem törzse

  {
      "kind": "roleAssignment",
      "properties": {
          "resourceGroup": "storageRG",
          "roleDefinitionId": "/providers/Microsoft.Authorization/roleDefinitions/8e3af657-a8ff-443c-a75c-2fe8c4bcb635",
          "principalIds": "[parameters('owners')]"
      }
  }
  

Ebben a példában a principalIds tulajdonság a tulajdonosok tervszint paraméterét [parameters('owners')]használja a következő érték használatával: . Ha egy összetevő paraméterét tervszintű paraméterrel állítja be, az továbbra is egy statikus paraméter példája. A tervszint paraméter nem állítható be a terv hozzárendelése során, és minden hozzárendelésnél ugyanaz az érték lesz.

Összetevőszintű paraméter

A statikus paraméterek létrehozása egy összetevőn hasonló, de a függvény használata parameters() helyett egy egyenes értéket vesz fel. Az alábbi példa két statikus paramétert hoz létre: tagName és tagValue. Az egyes értékek közvetlenül meg lesznek adva, és nem használ függvényhívást.

• REST API URI

  PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/{YourMG}/providers/Microsoft.Blueprint/blueprints/MyBlueprint/artifacts/policyStorageTags?api-version=2018-11-01-preview
  

• Kérelem törzse

  {
      "kind": "policyAssignment",
      "properties": {
          "description": "Apply storage tag and the parameter also used by the template to resource groups",
          "policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/49c88fc8-6fd1-46fd-a676-f12d1d3a4c71",
          "parameters": {
              "tagName": {
                  "value": "StorageType"
              },
              "tagValue": {
                  "value": "Premium_LRS"
              }
          }
      }
  }
  

Dinamikus paraméterek

A statikus paraméter ellentéte egy dinamikus paraméter. Ez a paraméter nincs definiálva a tervben, hanem a terv minden hozzárendelése során van definiálva. Az erőforráscsoport-példában a dinamikus paraméter használatának van értelme az erőforráscsoport nevének. A terv minden hozzárendeléséhez más nevet ad. A tervfüggvények listáját a tervfüggvények hivatkozásában találja.

Dinamikus paraméterek beállítása a portálon

1. A bal oldali panelen válassza a Minden szolgáltatás lehetőséget. Keresse meg és válassza ki a Tervek elemet.

2. A bal oldalon válassza a Tervdefiníciók lehetőséget .

3. Kattintson a jobb gombbal a hozzárendelni kívánt tervre. Válassza a Terv hozzárendelése vagy a hozzárendelni kívánt terv kijelölése lehetőséget, majd használja a Terv hozzárendelése gombot.

4. A Terv hozzárendelése lapon keresse meg az Összetevő paraméterei szakaszt. Minden legalább egy dinamikus paraméterrel rendelkező összetevő megjeleníti az összetevőt és a konfigurációs beállításokat. A terv hozzárendelése előtt adja meg a szükséges értékeket a paramétereknek. Az alábbi példában a Név egy dinamikus paraméter, amelyet meg kell határozni a terv hozzárendelésének befejezéséhez.

   

Dinamikus paraméterek beállítása a REST API-ból

A dinamikus paraméterek beállítása a hozzárendelés során az érték közvetlen beírásával történik. A megadott érték ahelyett, hogy függvényt használ, például paramétereket() használ, a megadott érték egy megfelelő sztring. Az erőforráscsoport összetevői "sablonnévvel", névvel és helytulajdonságokkal vannak definiálva. A belefoglalt összetevő összes többi paramétere név>- és értékkulcspárt tartalmazó <paraméterek alatt van definiálva. Ha a terv egy olyan dinamikus paraméterhez van konfigurálva, amely nincs megadva a hozzárendelés során, a hozzárendelés sikertelen lesz.

• REST API URI

  PUT https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Blueprint/blueprintAssignments/assignMyBlueprint?api-version=2018-11-01-preview
  

• Kérelem törzse

  {
      "properties": {
          "blueprintId": "/providers/Microsoft.Management/managementGroups/{YourMG}  /providers/Microsoft.Blueprint/blueprints/MyBlueprint",
          "resourceGroups": {
              "storageRG": {
                  "name": "StorageAccount",
                  "location": "eastus2"
              }
          },
          "parameters": {
              "storageAccountType": {
                  "value": "Standard_GRS"
              },
              "tagName": {
                  "value": "CostCenter"
              },
              "tagValue": {
                  "value": "ContosoIT"
              },
              "contributors": {
                  "value": [
                      "7be2f100-3af5-4c15-bcb7-27ee43784a1f",
                      "38833b56-194d-420b-90ce-cff578296714"
                  ]
                },
              "owners": {
                  "value": [
                      "44254d2b-a0c7-405f-959c-f829ee31c2e7",
                      "316deb5f-7187-4512-9dd4-21e7798b0ef9"
                  ]
              }
          }
      },
      "identity": {
          "type": "systemAssigned"
      },
      "location": "westus"
  }
  

Következő lépések

• Tekintse meg a tervfüggvények listáját.
• Tudnivalók a tervek életciklusáról.
• A tervekkel kapcsolatos műveleti sorrend testreszabásának elsajátítása.
• A tervek erőforrás-zárolásának alkalmazásával kapcsolatos részletek.
• A meglévő hozzárendelések frissítésének elsajátítása.
• A tervek hozzárendelése során felmerülő problémák megoldása általános hibaelhárítással.