Inicio rápido: Creación e implementación de una especificación de plantilla

En este inicio rápido se muestra cómo empaquetar una plantilla de Azure Resource Manager como especificación de plantilla. y, posteriormente, implementarla. La especificación de plantilla contiene una plantilla de Resource Manager que implementa una cuenta de almacenamiento.

Sugerencia

Se recomienda Bicep porque ofrece las mismas funcionalidades que las plantillas de ARM y la sintaxis es más fácil de usar. Para más información, consulte Inicio rápido: creación e implementación de una especificación de plantilla con Bicep.

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, use la versión 2.14.2 o posterior.

Creación de una plantilla

Las especificaciones de plantilla se crean a partir de una plantilla local. Copie la siguiente plantilla y guárdela en un archivo local llamado azuredeploy.json. En esta guía de inicio rápido se da por supuesto que se ha guardado en la ruta de acceso c:\Templates\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",
  "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'))]"
    }
  }
}

Crear una especificación de plantilla

La especificación de plantilla es un tipo de recurso llamado Microsoft.Resources/templateSpecs. Para crear una especificación de plantilla, use PowerShell, la CLI de Azure, Azure Portal o una plantilla de Resource Manager.

PowerShell

1. Cree un nuevo grupo de recursos que contiene la especificación de plantilla.

   New-AzResourceGroup `
     -Name templateSpecRG `
     -Location westus2
   

2. Cree la especificación de plantilla en ese grupo de recursos. Asigne a la nueva especificación de plantilla el nombre storageSpec.

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

CLI

1. Cree un nuevo grupo de recursos que contiene la especificación de plantilla.

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

2. Cree la especificación de plantilla en ese grupo de recursos. Asigne a la nueva especificación de plantilla el nombre storageSpec.

   az ts create \
     --name storageSpec \
     --version "1.0" \
     --resource-group templateSpecRG \
     --location "westus2" \
     --template-file "c:\Templates\azuredeploy.json"
   

Portal

1. Inicie sesión en Azure Portal.

2. Busque especificaciones de plantilla. Seleccione Especificaciones de plantilla entre las opciones disponibles.

   

3. Seleccione Importar plantilla.

   

4. Seleccione el icono de la carpeta.

   

5. Vaya a la plantilla local que ha guardado y selecciónela. Seleccione Open (Abrir).

6. Seleccione Import (Importar).

   

7. Proporcione los valores siguientes:

   • Nombre: escriba un nombre para la especificación de plantilla. Por ejemplo, storageSpec
   • Suscripción: seleccione la suscripción de Azure usada para crear la especificación de plantilla.
   • Grupo de recursos: seleccione Crear nuevo y especifique un nuevo nombre de grupo de recursos. Por ejemplo, templateSpecRG.
   • Ubicación: seleccione una ubicación para el grupo de recursos. Por ejemplo, Oeste de EE. UU. 2.
   • Versión: escriba una versión para la especificación de plantilla. Use 1.0.

8. Seleccione Revisar + crear.

9. Seleccione Crear.

Plantilla de ARM

Nota:

Es aconsejable que, en lugar de usar una plantilla de Resource Manager, se use PowerShell o la CLI para crear la especificación de plantilla. Dichas herramientas convierten automáticamente plantillas vinculadas en artefactos conectados a su plantilla principal. Si se usa una plantilla de Resource Manager para crear la especificación de plantilla, las plantillas vinculadas se deben agregar manualmente como artefactos, lo que puede resultar complicado.

1. Cuando se usa una plantilla de Resource Manager para crear la especificación de plantilla, la plantilla se incrusta en la definición de recurso. Es preciso realizar varios cambios en la plantilla local. Copie la siguiente plantilla y guárdela localmente como azuredeploy.json.

   Nota:

   En la plantilla insertada, todas las expresiones de plantilla se deben escapar con un segundo corchete de apertura. Use "[[ en lugar de "[. Las matrices JSON siguen usando un solo corchete de apertura.

   {
     "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
     "contentVersion": "1.0.0.0",
     "parameters": {},
     "functions": [],
     "variables": {},
     "resources": [
       {
         "type": "Microsoft.Resources/templateSpecs",
         "apiVersion": "2021-05-01",
         "name": "storageSpec",
         "location": "westus2",
         "properties": {
           "displayName": "Storage template spec"
         },
         "tags": {},
         "resources": [
           {
             "type": "versions",
             "apiVersion": "2021-05-01",
             "name": "1.0",
             "location": "westus2",
             "dependsOn": [ "storageSpec" ],
             "properties": {
               "mainTemplate": {
                 "$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."
                     }
                   }
                 },
                 "variables": {
                   "storageAccountName": "[[concat('store', uniquestring(resourceGroup().id))]"
                 },
                 "resources": [
                   {
                     "type": "Microsoft.Storage/storageAccounts",
                     "apiVersion": "2022-09-01",
                     "name": "[[variables('storageAccountName')]",
                     "location": "[[parameters('location')]",
                     "sku": {
                       "name": "[[parameters('storageAccountType')]"
                     },
                     "kind": "StorageV2",
                     "properties": {}
                   }
                 ],
                 "outputs": {
                   "storageAccountName": {
                     "type": "string",
                     "value": "[[variables('storageAccountName')]"
                   }
                 }
               }
             },
             "tags": {}
           }
         ]
       }
     ],
     "outputs": {}
   }
   

2. Use la CLI de Azure o PowerShell para crear un nuevo grupo de recursos.

   New-AzResourceGroup `
     -Name templateSpecRG `
     -Location westus2
   

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

3. Implemente la plantilla con la CLI de Azure o PowerShell.

   New-AzResourceGroupDeployment `
     -ResourceGroupName templateSpecRG `
     -TemplateFile "c:\Templates\azuredeploy.json"
   

   az deployment group create \
     --resource-group templateSpecRG \
     --template-file "c:\Templates\azuredeploy.json"
   

Implementación de la especificación de plantilla

Para implementar una especificación de plantilla, utilice los mismos comandos de implementación que para implementar una plantilla. Pase el id. de recurso de la especificación de plantilla para implementarla.

PowerShell

1. Cree un grupo de recursos que contenga la cuenta de almacenamiento nueva.

   New-AzResourceGroup `
     -Name storageRG `
     -Location westus2
   

2. Obtenga el id. de recurso de la especificación de plantilla.

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

3. Implemente la especificación de plantilla.

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

4. Proporcione los parámetros exactamente como lo haría para una plantilla de ARM. Vuelva a implementar la especificación de plantilla con un parámetro para el tipo de cuenta de almacenamiento.

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

CLI

1. Cree un grupo de recursos que contenga la cuenta de almacenamiento nueva.

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

2. Obtenga el id. de recurso de la especificación de plantilla.

   id=$(az ts show --name storageSpec --resource-group templateSpecRG --version "1.0" --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.

3. Implemente la especificación de plantilla.

   az deployment group create \
     --resource-group storageRG \
     --template-spec $id
   

4. Proporcione los parámetros exactamente como lo haría para una plantilla de ARM. Vuelva a implementar la especificación de plantilla con un parámetro para el tipo de cuenta de almacenamiento.

   az deployment group create \
     --resource-group storageRG \
     --template-spec $id \
     --parameters storageAccountType='Standard_GRS'
   

Portal

1. Seleccione la especificación de plantilla que creó.

   

2. Seleccione Implementar.

   

3. Proporcione los valores siguientes:

   • Suscripción: seleccione una suscripción de Azure para crear el recurso.
   • Grupo de recursos: seleccione Crear nuevo y, luego, escriba storageRG.
   • Tipo de cuenta de almacenamiento: seleccione Standard_GRS.

4. Seleccione Revisar + crear.

5. Seleccione Crear.

Plantilla de ARM

1. Copie la siguiente plantilla y guárdela en un archivo local llamado storage.json.

   {
     "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
     "contentVersion": "1.0.0.0",
     "parameters": {},
     "functions": [],
     "variables": {},
     "resources": [
       {
         "type": "Microsoft.Resources/deployments",
         "apiVersion": "2021-04-01",
         "name": "demo",
         "properties": {
           "templateLink": {
             "id": "[resourceId('templateSpecRG', 'Microsoft.Resources/templateSpecs/versions', 'storageSpec', '1.0')]"
           },
           "parameters": {
           },
           "mode": "Incremental"
         }
       }
     ],
     "outputs": {}
   }
   

2. Use la CLI de Azure o PowerShell para crear un nuevo grupo de recursos para la cuenta de almacenamiento.

   New-AzResourceGroup `
     -Name storageRG `
     -Location westus2
   

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

3. Implemente la plantilla con la CLI de Azure o PowerShell.

   New-AzResourceGroupDeployment `
     -ResourceGroupName storageRG `
     -TemplateFile "c:\Templates\storage.json"
   

   az deployment group create \
     --resource-group storageRG \
     --template-file "c:\Templates\storage.json"
   

Conceder acceso

Si quiere permitir que otros usuarios de su organización implementen la especificación de plantilla, debe concederles acceso de lectura. Puede asignar el rol Lector a un grupo de Microsoft Entra para el grupo de recursos que contiene las especificaciones de plantilla que quiere compartir. Para más información, consulte el Tutorial: Concesión de acceso de grupo a recursos de Azure mediante Azure PowerShell.

Actualización de la plantilla

Supongamos que ha identificado un cambio que desea hacer en la plantilla en la especificación de plantilla. La siguiente plantilla es similar a la anterior, salvo que agrega un prefijo para el nombre de la cuenta de almacenamiento. Copie la siguiente plantilla y actualice el archivo azuredeploy.json.

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

Actualización de la versión de la especificación de plantilla

En lugar de crear una nueva especificación de plantilla para la plantilla revisada, agregue una nueva versión denominada 2.0 a la especificación de plantilla existente. Los usuarios pueden la versión que desean implementar.

PowerShell

1. Cree una versión de la especificación de plantilla.

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

2. Para implementar la nueva versión, obtenga el identificador de recurso de la versión 2.0.

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

3. Implemente esa versión. Proporcione un prefijo para el nombre de la cuenta de almacenamiento.

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

CLI

1. Cree una versión de la especificación de plantilla.

   az ts create \
     --name storageSpec \
     --version "2.0" \
     --resource-group templateSpecRG \
     --location "westus2" \
     --template-file "c:\Templates\azuredeploy.json"
   

2. Para implementar la nueva versión, obtenga el identificador de recurso de la versión 2.0.

   id=$(az ts show --name storageSpec --resource-group templateSpecRG --version "2.0" --query "id")
   

3. Implemente esa versión. Proporcione un prefijo para el nombre de la cuenta de almacenamiento.

   az deployment group create \
      --resource-group storageRG \
      --template-spec $id \
      --parameters namePrefix='demoaccount'
   

Portal

1. En la especificación de plantilla, seleccione Crear versión nueva.

   

2. Asigne a la nueva versión el nombre 2.0 y, si lo desea, agregue notas. Seleccione Editar plantilla.

   

3. Reemplace el contenido de la plantilla por la plantilla actualizada. Seleccione Revisar y guardar.

4. Seleccione Save changes (Guardar los cambios).

5. Para implementar la nueva versión, seleccione Versiones

   

6. Para la versión que desea implementar, seleccione los tres puntos e Implementar.

   

7. Rellene los campos como hizo al implementar la versión anterior.

8. Seleccione Revisar + crear.

9. Seleccione Crear.

Plantilla de ARM

1. Una vez más, debe realizar algunos campos en la plantilla local para que funcione con las especificaciones de plantilla. Copie la siguiente plantilla y guárdela localmente como azuredeploy.json.

   {
     "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
     "contentVersion": "1.0.0.0",
     "parameters": {},
     "functions": [],
     "variables": {},
     "resources": [
       {
         "type": "Microsoft.Resources/templateSpecs",
         "apiVersion": "2021-05-01",
         "name": "storageSpec",
         "location": "westus2",
         "properties": {
           "displayName": "Storage template spec"
         },
         "tags": {},
         "resources": [
           {
             "type": "versions",
             "apiVersion": "2021-05-01",
             "name": "2.0",
             "location": "westus2",
             "dependsOn": [ "storageSpec" ],
             "properties": {
               "mainTemplate": {
                 "$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')]"
                   }
                 }
               }
             },
             "tags": {}
           }
         ]
       }
     ],
     "outputs": {}
   }
   

2. Para agregar la nueva versión a la especificación de plantilla, implemente la plantilla con la CLI de Azure o PowerShell.

   New-AzResourceGroupDeployment `
     -ResourceGroupName templateSpecRG `
     -TemplateFile "c:\Templates\azuredeploy.json"
   

   az deployment group create \
     --resource-group templateSpecRG \
     --template-file "c:\Templates\azuredeploy.json"
   

3. Copie la siguiente plantilla y guárdela en un archivo local llamado storage.json.

   {
     "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
     "contentVersion": "1.0.0.0",
     "parameters": {},
     "functions": [],
     "variables": {},
     "resources": [
       {
         "type": "Microsoft.Resources/deployments",
         "apiVersion": "2021-04-01",
         "name": "demo",
         "properties": {
           "templateLink": {
             "id": "[resourceId('templateSpecRG', 'Microsoft.Resources/templateSpecs/versions', 'storageSpec', '2.0')]"
           },
           "parameters": {
           },
           "mode": "Incremental"
         }
       }
     ],
     "outputs": {}
   }
   

4. Implemente la plantilla con la CLI de Azure o PowerShell.

   New-AzResourceGroupDeployment `
     -ResourceGroupName storageRG `
     -TemplateFile "c:\Templates\storage.json"
   

   az deployment group create \
     --resource-group storageRG \
     --template-file "c:\Templates\storage.json"
   

Limpieza de recursos

Para limpiar el recurso que implementó en esta guía de inicio rápido, elimine los dos grupos de recursos que creó.

1. En Azure Portal, seleccione el grupo de recursos en el menú de la izquierda.

2. Escriba el nombre del grupo de recursos (templateSpecRG y storageRG) en el campo Filtrar por nombre.

3. Seleccione el nombre del grupo de recursos.

4. Seleccione Eliminar grupo de recursos en el menú superior.

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.