Oktatóanyag: Sablonspecifikáció üzembe helyezése csatolt sablonként

Megtudhatja, hogyan helyezhet üzembe egy meglévő sablonspecifikációtcsatolt üzembe helyezéssel. A sablonspecifikációk használatával megoszthatja az ARM-sablonokat a szervezet más felhasználóival. Miután létrehozott egy sablonspecifikációt, üzembe helyezheti a sablonspecifikációt Azure PowerShell vagy az Azure CLI használatával. A sablonspecifikációt a megoldás részeként is üzembe helyezheti egy csatolt sablon használatával.

Előfeltételek

Egy Azure-fiók, aktív előfizetéssel. Hozzon létre ingyenes fiókot.

Megjegyzés

Ha sablonspecifikációt szeretne használni Azure PowerShell, 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.

Sablonspecifikáció létrehozása

Kövesse a következő rövid útmutatót: Sablonspecifikáció létrehozása és üzembe helyezése a tárfiók üzembe helyezéséhez szükséges sablonspecifikáció létrehozásához. A következő szakaszban szüksége lesz a sablon specifikációjának, a sablonspecifikáció nevének és a sablonspecifikáció verziójának erőforráscsoport-nevére.

A fő sablon létrehozása

Ha sablonspecifikációt szeretne üzembe helyezni egy ARM-sablonban, adjon hozzá egy üzembehelyezési erőforrást a fő sablonhoz. templateLink A tulajdonságban adja meg egy sablonspecifikáció erőforrás-azonosítóját. Hozzon létre egy sablont az azuredeploy.json nevű következő JSON-val. Ez az oktatóanyag feltételezi, hogy mentett egy c:\Templates\deployTS\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",
  "parameters": {
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    },
    "tsResourceGroup":{
      "type": "string",
      "metadata": {
        "Description": "Specifies the resource group name of the template spec."
      }
    },
    "tsName": {
      "type": "string",
      "metadata": {
        "Description": "Specifies the name of the template spec."
      }
    },
    "tsVersion": {
      "type": "string",
      "defaultValue": "1.0.0.0",
      "metadata": {
        "Description": "Specifies the version the template spec."
      }
    },
    "storageAccountType": {
      "type": "string",
      "defaultValue": "Standard_LRS",
      "metadata": {
        "Description": "Specifies the storage account type required by the template spec."
      }
    }
  },
  "variables": {
    "appServicePlanName": "[concat('plan', uniquestring(resourceGroup().id))]"
  },
  "resources": [
    {
      "type": "Microsoft.Web/serverfarms",
      "apiVersion": "2016-09-01",
      "name": "[variables('appServicePlanName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "B1",
        "tier": "Basic",
        "size": "B1",
        "family": "B",
        "capacity": 1
      },
      "kind": "linux",
      "properties": {
        "perSiteScaling": false,
        "reserved": true,
        "targetWorkerCount": 0,
        "targetWorkerSizeId": 0
      }
    },
    {
      "type": "Microsoft.Resources/deployments",
      "apiVersion": "2020-10-01",
      "name": "createStorage",
      "properties": {
        "mode": "Incremental",
        "templateLink": {
          "id": "[resourceId(parameters('tsResourceGroup'), 'Microsoft.Resources/templateSpecs/versions', parameters('tsName'), parameters('tsVersion'))]"
        },
        "parameters": {
          "storageAccountType": {
            "value": "[parameters('storageAccountType')]"
          }
        }
      }
    }
  ],
  "outputs": {
    "templateSpecId": {
      "type": "string",
      "value": "[resourceId(parameters('tsResourceGroup'), 'Microsoft.Resources/templateSpecs/versions', parameters('tsName'), parameters('tsVersion'))]"
    }
  }
}

A sablon specifikációazonosítóját a resourceID() függvény hozza létre. A resourceID() függvény erőforráscsoport-argumentuma nem kötelező, ha a templateSpec az aktuális üzemelő példány erőforráscsoportjában található. Az erőforrás-azonosítót paraméterként közvetlenül is átadhatja. Az azonosító lekéréséhez használja a következőt:

PowerShell

$id = (Get-AzTemplateSpec -ResourceGroupName $resourceGroupName -Name $templateSpecName -Version $templateSpecVersion).Versions.Id

Parancssori felület

id = $(az ts show --name $templateSpecName --resource-group $resourceGroupName --version $templateSpecVersion --query "id")

Megjegyzés

Ismert probléma merült fel a sablon specifikációazonosítóinak lekérésével és egy változóhoz való hozzárendelésével kapcsolatban a Windows PowerShell.

A paraméterek sablonspecifikációnak való átadásának szintaxisa a következő:

"parameters": {
  "storageAccountType": {
    "value": "[parameters('storageAccountType')]"
  }
}

Megjegyzés

Az apiVersion értéke Microsoft.Resources/deployments 2020-06-01 vagy újabb lehet.

A sablon üzembe helyezése

A csatolt sablon üzembe helyezésekor a webalkalmazást és a tárfiókot is üzembe helyezi. Az üzembe helyezés ugyanaz, mint a többi ARM-sablon üzembe helyezése.

PowerShell

New-AzResourceGroup `
  -Name webRG `
  -Location westus2

New-AzResourceGroupDeployment `
  -ResourceGroupName webRG `
  -TemplateFile "c:\Templates\deployTS\azuredeploy.json" `
  -tsResourceGroup templateSpecRg `
  -tsName storageSpec `
  -tsVersion 1.0

Parancssori felület

az group create \
  --name webRG \
  --location westus2

az deployment group create \
  --resource-group webRG \
  --template-file "c:\Templates\deployTS\azuredeploy.json" \
  --parameters tsResourceGroup=templateSpecRG tsName=storageSpec tsVersion=1.0

Következő lépések

A csatolt sablonokat tartalmazó sablonspecifikációk létrehozásáról a Csatolt sablon sablonspecifikációjának létrehozása című témakörben olvashat.