Tutorial: Exportación y uso de plantillas de Azure Portal

En esta serie de tutoriales, creará una plantilla para implementar una cuenta de Azure Storage. En los dos tutoriales siguientes, agregará un plan de App Service y un sitio web. En lugar de crear plantillas desde cero, aprenderá a exportar plantillas desde Azure Portal y a usar plantillas de ejemplo desde las plantillas de inicio rápido de Azure. Personaliza esas plantillas para su uso. Este tutorial se centra en exportar plantillas y personalizar el resultado de la plantilla. Esta instrucción tarda 14 minutos en completarse.

Prerrequisitos

Se recomienda completar el tutorial sobre las salidas, pero no es necesario.

Debe tener Visual Studio Code y Azure PowerShell o la CLI de Azure. Para obtener más información, consulte herramientas de plantilla.

Revisar plantilla

Al final del tutorial anterior, la plantilla tenía el siguiente archivo JSON:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storagePrefix": {
      "type": "string",
      "minLength": 3,
      "maxLength": 11
    },
    "storageSKU": {
      "type": "string",
      "defaultValue": "Standard_LRS",
      "allowedValues": [
        "Standard_LRS",
        "Standard_GRS",
        "Standard_RAGRS",
        "Standard_ZRS",
        "Premium_LRS",
        "Premium_ZRS",
        "Standard_GZRS",
        "Standard_RAGZRS"
      ]
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    }
  },
  "variables": {
    "uniqueStorageName": "[concat(parameters('storagePrefix'), uniqueString(resourceGroup().id))]"
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2025-06-01",
      "name": "[variables('uniqueStorageName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('storageSKU')]"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    }
  ],
  "outputs": {
    "storageEndpoint": {
      "type": "object",
      "value": "[reference(variables('uniqueStorageName')).primaryEndpoints]"
    }
  }
}

Esta plantilla funciona bien para implementar cuentas de almacenamiento, pero es posible que quiera agregar más recursos a ella. Puede exportar una plantilla desde un recurso existente para obtener rápidamente el json de ese recurso.

Creación de un plan de App Service

Inicie sesión en Azure Portal.
Seleccione Crear un recurso.
En Servicios de búsqueda y Marketplace, escriba Plan de Servicio de Aplicaciones y, a continuación, seleccione Plan de Servicio de Aplicaciones.
Selecciona Crear.
En la página Crear Plan de servicio de aplicaciones, escriba lo siguiente:
- Suscripción: seleccione la suscripción de Azure en el menú desplegable.
- Grupo de recursos: seleccione Crear nuevo y especifique un nombre. Proporcione un nombre de grupo de recursos diferente al que ha usado en esta serie de tutoriales.
- Nombre: escriba un nombre para el plan de App Service.
- Sistema operativo: seleccione Linux.
- Región: seleccione una ubicación de Azure en el menú desplegable, como Centro de EE. UU.
- Plan de tarifa: para ahorrar costos, seleccione Cambiar tamaño para cambiar la SKU y el tamaño a la primera versión básica (B1), en Desarrollo y pruebas para cargas de trabajo menos exigentes.
Seleccione Revisar y crear.
Selecciona Crear. Se tardan unos instantes en crear el recurso.

Exportación de la plantilla

Seleccione Ir al recurso.
En el menú de la izquierda, en Automatización, seleccione Exportar plantilla.

La característica de plantilla de exportación toma el estado actual de un recurso y genera una plantilla para implementarla. La exportación de una plantilla puede ser una manera útil de obtener rápidamente el json que necesita para implementar un recurso.
Examine la Microsoft.Web/serverfarms definición y la definición de parámetros en la plantilla exportada. No es necesario copiar estas secciones. Solo puede usar esta plantilla exportada como ejemplo de cómo desea agregar este recurso a la plantilla.

Importante

Normalmente, la plantilla exportada es más detallada de lo que podría desear al crear una plantilla. El objeto SKU, por ejemplo, en la plantilla exportada tiene cinco propiedades. Esta plantilla funciona, pero simplemente podría usar la name propiedad . Puede empezar con la plantilla exportada y, a continuación, modificarla a medida que quiera adaptarse a sus requisitos.

Revisión de la plantilla existente

La plantilla exportada proporciona la mayor parte del JSON que necesita, pero tiene que personalizarlo para su plantilla. Preste especial atención a las diferencias en los parámetros y las variables entre la plantilla y la plantilla exportada. Obviamente, el proceso de exportación no conoce los parámetros y variables que ya ha definido en la plantilla.

En el ejemplo siguiente se muestran las adiciones a la plantilla. Contiene el código exportado más algunos cambios. En primer lugar, cambia el nombre del parámetro para que coincida con la convención de nomenclatura. En segundo lugar, utiliza tu parámetro de ubicación para la localización del Plan de App Service. En tercer lugar, quita algunas de las propiedades en las que el valor predeterminado es correcto.

Copie todo el archivo y reemplace la plantilla por su contenido:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storagePrefix": {
      "type": "string",
      "minLength": 3,
      "maxLength": 11
    },
    "storageSKU": {
      "type": "string",
      "defaultValue": "Standard_LRS",
      "allowedValues": [
        "Standard_LRS",
        "Standard_GRS",
        "Standard_RAGRS",
        "Standard_ZRS",
        "Premium_LRS",
        "Premium_ZRS",
        "Standard_GZRS",
        "Standard_RAGZRS"
      ]
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    },
    "appServicePlanName": {
      "type": "string",
      "defaultValue": "exampleplan"
    }
  },
  "variables": {
    "uniqueStorageName": "[concat(parameters('storagePrefix'), uniqueString(resourceGroup().id))]"
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2025-06-01",
      "name": "[variables('uniqueStorageName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('storageSKU')]"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    },
    {
      "type": "Microsoft.Web/serverfarms",
      "apiVersion": "2025-03-01",
      "name": "[parameters('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
      }
    }
  ],
  "outputs": {
    "storageEndpoint": {
      "type": "object",
      "value": "[reference(variables('uniqueStorageName')).primaryEndpoints]"
    }
  }
}

Implementar plantilla

Use la CLI de Azure o Azure PowerShell para implementar una plantilla.

Si no ha creado el grupo de recursos, consulte Creación de un grupo de recursos. En el ejemplo se supone que ha establecido la templateFile variable en la ruta de acceso al archivo de plantilla, como se muestra en el primer tutorial.

Azure PowerShell
Azure CLI

New-AzResourceGroupDeployment `
  -Name addappserviceplan `
  -ResourceGroupName myResourceGroup `
  -TemplateFile $templateFile `
  -storagePrefix "store" `
  -storageSKU Standard_LRS

Para ejecutar este comando de implementación, debe tener la versión más reciente de la CLI de Azure.

az deployment group create \
  --name addappserviceplan \
  --resource-group myResourceGroup \
  --template-file $templateFile \
  --parameters storagePrefix=store storageSKU=Standard_LRS

Nota:

Si se produce un error en la implementación, use la verbose opción para obtener información sobre los recursos que está creando. Use el modificador debug para obtener más información para la depuración.

Comprobación de la implementación

Para comprobar la implementación, explore el grupo de recursos desde Azure Portal.

Inicie sesión en Azure Portal.
En el menú de la izquierda, seleccione Grupos de recursos.
Seleccione el grupo de recursos al que realizó la implementación.
El grupo de recursos contiene una cuenta de almacenamiento y un plan de App Service.

Limpieza de recursos

Si va a pasar al siguiente tutorial, no es necesario eliminar el grupo de recursos.

Si se detiene ahora, es posible que quiera eliminar el grupo de recursos.

En Azure Portal, seleccione Grupos de recursos en el menú izquierdo.
Escriba el nombre del grupo de recursos en el campo Filtro para cualquier campo... de texto.
Active la casilla situada junto a myResourceGroup y seleccione myResourceGroup o el nombre del grupo de recursos.
Seleccione Eliminar grupo de recursos del menú superior.

Pasos siguientes

Ha aprendido a exportar una plantilla desde Azure Portal y a usar la plantilla exportada para el desarrollo de plantillas. También puede usar las plantillas de inicio rápido de Azure para simplificar el desarrollo de plantillas.

Uso de plantillas de inicio rápido de Azure

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2025-10-29