Share via

Rövid útmutató: Sablon specifikáció létrehozása és üzembe helyezése

  • Cikk

Ez a rövid útmutató bemutatja, hogyan csomagolhat be egy Azure Resource Manager-sablont (ARM-sablont) egy sablon specifikációjába. Ezután üzembe helyezi a sablon specifikációt. A sablon specifikációja tartalmaz egy ARM-sablont, amely egy tárfiókot helyez üzembe.

Tipp.

A Bicep használatát javasoljuk, mert ugyanazokkal a képességekkel rendelkezik, mint az ARM-sablonok, és a szintaxis használata egyszerűbb. További információ: Rövid útmutató: Sablon-specifikáció létrehozása és üzembe helyezése a Bicep-lel.

Előfeltételek

Egy Azure-fiók, aktív előfizetéssel. Fiók ingyenes létrehozása.

Megjegyzés:

Ha sablonspektruszt szeretne használni az Azure PowerShell-lel, telepítenie kell az 5.0.0-s vagy újabb verziót. Az Azure CLI-vel való használatához használja a 2.14.2-es vagy újabb verziót.

Sablon létrehozása

Egy helyi sablonból hozhat létre sablonspektratívot. Másolja ki a következő sablont, és mentse helyileg egy azuredeploy.json nevű fájlba. Ez a rövid útmutató feltételezi, hogy mentett egy c:\Templates\azuredeploy.json elérési utat, de bármilyen elérési utat használhat.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "metadata": {
    "_generator": {
      "name": "bicep",
      "version": "0.13.1.58284",
      "templateHash": "13120038605368246703"
    }
  },
  "parameters": {
    "storageAccountType": {
      "type": "string",
      "defaultValue": "Standard_LRS",
      "allowedValues": [
        "Premium_LRS",
        "Premium_ZRS",
        "Standard_GRS",
        "Standard_GZRS",
        "Standard_LRS",
        "Standard_RAGRS",
        "Standard_RAGZRS",
        "Standard_ZRS"
      ],
      "metadata": {
        "description": "Storage Account type"
      }
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]",
      "metadata": {
        "description": "The storage account location."
      }
    },
    "storageAccountName": {
      "type": "string",
      "defaultValue": "[format('store{0}', uniqueString(resourceGroup().id))]",
      "metadata": {
        "description": "The name of the storage account"
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2022-09-01",
      "name": "[parameters('storageAccountName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('storageAccountType')]"
      },
      "kind": "StorageV2",
      "properties": {}
    }
  ],
  "outputs": {
    "storageAccountName": {
      "type": "string",
      "value": "[parameters('storageAccountName')]"
    },
    "storageAccountId": {
      "type": "string",
      "value": "[resourceId('Microsoft.Storage/storageAccounts', parameters('storageAccountName'))]"
    }
  }
}

Sablon specifikáció létrehozása

A sablon specifikációja egy erőforrástípus.Microsoft.Resources/templateSpecs Sablon specifikációjának létrehozásához használja a PowerShellt, az Azure CLI-t, a portált vagy egy ARM-sablont.

  1. Hozzon létre egy új erőforráscsoportot a sablon specifikációjának tartalmaznia.

    New-AzResourceGroup `
  -Name templateSpecRG `
  -Location westus2

  2. Hozza létre a sablon specifikációját az erőforráscsoportban. Adja meg az új sablon specifikációjának a storageSpec nevet.

    New-AzTemplateSpec `
  -Name storageSpec `
  -Version "1.0" `
  -ResourceGroupName templateSpecRG `
  -Location westus2 `
  -TemplateFile "c:\Templates\azuredeploy.json"

Sablon specifikáció üzembe helyezése

Sablonspecifikáció üzembe helyezéséhez használja ugyanazokat az üzembehelyezési parancsokat, mint a sablon üzembe helyezéséhez. Adja meg az üzembe helyezendő sablon specifikációjának erőforrás-azonosítóját.

  1. Hozzon létre egy erőforráscsoportot az új tárfiók tárolásához.

    New-AzResourceGroup `
  -Name storageRG `
  -Location westus2

  2. Kérje le a sablon specifikációjának erőforrás-azonosítóját.

    $id = (Get-AzTemplateSpec -ResourceGroupName templateSpecRG -Name storageSpec -Version "1.0").Versions.Id

  3. A sablon specifikációjának üzembe helyezése.

    New-AzResourceGroupDeployment `
  -TemplateSpecId $id `
  -ResourceGroupName storageRG

  4. Pontosan úgy adja meg a paramétereket, mint egy ARM-sablon esetében. A sablon specifikációjának ismételt üzembe helyezése a tárfiók típusának paraméterével.

    New-AzResourceGroupDeployment `
  -TemplateSpecId $id `
  -ResourceGroupName storageRG `
  -storageAccountType Standard_GRS

Hozzáférés biztosítása

Ha engedélyezni szeretné, hogy a szervezet más felhasználói üzembe helyezhessék a sablon specifikációját, olvasási hozzáférést kell biztosítani számukra. Az Olvasó szerepkört hozzárendelheti egy Microsoft Entra-csoporthoz ahhoz az erőforráscsoporthoz, amely a megosztani kívánt sablon-specifikációkat tartalmazza. További információ : Oktatóanyag: Csoporthozzáférés biztosítása Azure-erőforrásokhoz az Azure PowerShell használatával.

Sablon frissítése

Tegyük fel, hogy azonosított egy módosítást a sablonon a sablon specifikációjában. A következő sablon hasonló a korábbi sablonhoz, de hozzáad egy előtagot a tárfiók nevéhez. Másolja ki a következő sablont, és frissítse az azuredeploy.json fájlt.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storageAccountType": {
      "type": "string",
      "defaultValue": "Standard_LRS",
      "allowedValues": [
        "Standard_LRS",
        "Standard_GRS",
        "Standard_ZRS",
        "Premium_LRS"
      ],
      "metadata": {
        "description": "Storage Account type"
      }
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]",
      "metadata": {
        "description": "Location for all resources."
      }
    },
    "namePrefix": {
      "type": "string",
      "maxLength": 11,
      "defaultValue": "store",
      "metadata": {
        "description": "Prefix for storage account name"
      }
    }
  },
  "variables": {
    "storageAccountName": "[concat(parameters('namePrefix'), uniquestring(resourceGroup().id))]"
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2021-04-01",
      "name": "[variables('storageAccountName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('storageAccountType')]"
      },
      "kind": "StorageV2",
      "properties": {}
    }
  ],
  "outputs": {
    "storageAccountName": {
      "type": "string",
      "value": "[variables('storageAccountName')]"
    }
  }
}

Sablon specifikációs verziójának frissítése

Ahelyett, hogy új sablonspecifikációt hoz létre a módosított sablonhoz, adjon hozzá egy új, a meglévő sablon specifikációjának elnevezett 2.0 verziót. A felhasználók bármelyik verziót választhatják az üzembe helyezéshez.

  1. Hozzon létre egy új verziót a sablon specifikációjának.

    New-AzTemplateSpec `
  -Name storageSpec `
  -Version "2.0" `
  -ResourceGroupName templateSpecRG `
  -Location westus2 `
  -TemplateFile "c:\Templates\azuredeploy.json"

  2. Az új verzió üzembe helyezéséhez kérje le a verzió erőforrás-azonosítóját 2.0 .

    $id = (Get-AzTemplateSpec -ResourceGroupName templateSpecRG -Name storageSpec -Version "2.0").Versions.Id

  3. Telepítse ezt a verziót. Adjon meg egy előtagot a tárfiók nevének.

    New-AzResourceGroupDeployment `
  -TemplateSpecId $id `
  -ResourceGroupName storageRG `
  -namePrefix "demoaccount"

Clean up resources

Az ebben a rövid útmutatóban üzembe helyezett erőforrás törléséhez törölje a létrehozott mindkét erőforráscsoportot.

  1. Az Azure Portalon válassza az Erőforráscsoport lehetőséget a bal oldali menüben.

  2. Írja be az erőforráscsoport nevét (templateSpecRG és storageRG) a Szűrő név alapján mezőbe.

  3. Válassza ki az erőforráscsoport nevét.

  4. A felső menüben válassza az Erőforráscsoport törlése lehetőséget.

Következő lépések

A csatolt sablonokat tartalmazó sablon-specifikációk létrehozásáról a csatolt sablon sablonspektratívjának létrehozása című témakörben olvashat.