Tutorial: Implementación de una especificación de plantilla como una plantilla vinculada

Artículo
03/20/2024

Obtenga información sobre cómo implementar una especificación de plantilla existente mediante una implementación vinculada. Las especificaciones de plantilla se usan para compartir plantillas de ARM con otros usuarios de la organización. Después de haber creado una especificación de plantilla, puede implementarla mediante Azure PowerShell o la CLI de Azure. También puede implementar la especificación de plantilla como parte de la solución mediante una plantilla vinculada.

Requisitos previos

Una cuenta de Azure con una suscripción activa. Cree una cuenta gratuita.

Nota:

Para usar especificaciones de plantilla con Azure PowerShell, debe instalar la versión 5.0.0 o posterior. Para usarlas con la CLI de Azure, utilice la versión 2.14.2 o posterior.

Creación de una especificación de plantilla

Consulte Inicio rápido: Creación e implementación de la especificación de plantilla para crear una especificación de plantilla para implementar una cuenta de almacenamiento. Necesitará el nombre del grupo de recursos de la especificación de plantilla, el nombre de la especificación de plantilla y la versión de la especificación de plantilla en la sección siguiente.

Creación de la plantilla principal

Para crear una especificación de plantilla en una plantilla de ARM, agregue un recurso de implementaciones a la plantilla principal. En la propiedad templateLink, especifique el identificador de recurso de una especificación de plantilla. Cree una plantilla con el siguiente código JSON denominado azuredeploy.json. En este tutorial se da por supuesto que se ha guardado en la ruta de acceso c:\Templates\deployTS\azuredeploy.json, pero puede usar cualquier ruta de acceso.

{
  "$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'))]"
    }
  }
}

El identificador de especificación de plantilla se genera mediante la función resourceID(). El argumento del grupo de recursos de la función resourceID() es opcional si templateSpec está en el mismo grupo de recursos de la implementación actual. También puede pasar directamente el identificador de recurso como un parámetro. Para obtener el identificador, use:

PowerShell
CLI

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

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

Nota

Existe un problema conocido al obtener el identificador de la especificación de plantilla y luego asignárselo a una variable en Windows PowerShell.

La sintaxis para pasar parámetros a la especificación de plantilla es la siguiente:

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

Nota:

El valor de apiVersion de Microsoft.Resources/deployments debe ser 2020-06-01 o posterior.

Implementación de la plantilla

Al implementar la plantilla vinculada, se implementa tanto la aplicación web como la cuenta de almacenamiento. La implementación es la misma que la de otras plantillas de ARM.

PowerShell
CLI

New-AzResourceGroup `
  -Name webRG `
  -Location westus2

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

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

Pasos siguientes

Para obtener información sobre cómo crear una especificación de plantilla que incluya plantillas vinculadas, consulte Creación de una especificación de plantilla con plantillas vinculadas.

Compartir vía