Tutorial: Incorporación de un recurso a la plantilla de Resource Manager

  • Artículo

En el tutorial anterior, ha aprendido a crear e implementar la primera una plantilla en blanco de Azure Resource Manager (plantilla de ARM) y a implementarla. Ya está listo para implementar un recurso real a esa plantilla. En este caso, una cuenta de almacenamiento de Azure. Se tardan 9 minutos en completar esta instrucción.

Prerrequisitos

Aunque no es obligatorio, se recomienda realizar el tutorial de introducción a las plantillas.

Debe tener Visual Studio Code instalado y en funcionamiento con la extensión Herramientas de Azure Resource Manager, y Azure PowerShell o la Interfaz de la línea de comandos de Azure (CLI). Para más información, consulte las herramientas de plantilla.

Agregar recurso

Para agregar una definición de cuenta de almacenamiento de Azure a la plantilla existente, examine el archivo JSON resaltado en el ejemplo siguiente. En lugar de intentar copiar secciones de la plantilla, copie todo el archivo y reemplace su plantilla por su contenido.

Reemplace {provide-unique-name} y las llaves {} por un nombre de cuenta de almacenamiento único.

Importante

El nombre de la cuenta de almacenamiento debe ser único en Azure. Solo contiene letras en minúsculas o números y tiene un límite de 24 caracteres. Puede usar un nombre como store1 como prefijo y, a continuación, agregar sus iniciales a la fecha de hoy. El nombre, por ejemplo, puede ser store1abc06132022.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2021-09-01",
      "name": "{provide-unique-name}",
      "location": "eastus",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    }
  ]
}

No es fácil adivinar un nombre único para una cuenta de almacenamiento y no resulta eficaz para automatizar implementaciones de gran tamaño. Más adelante en esta serie de tutoriales, usará características de plantilla que facilitan la creación de un nombre único.

Propiedades del recurso

Es posible que se pregunte cómo buscar las propiedades que se usarán para cada tipo de recurso. Puede usar la referencia de plantilla de Resource Manager para buscar los tipos de recursos que desea implementar.

Cada recurso implementado tiene al menos las siguientes tres propiedades:

  • type: Tipo de recurso. Este valor es una combinación del espacio de nombres del proveedor de recursos y el tipo de recurso, como Microsoft.Storage/storageAccounts.
  • apiVersion: Versión de la API de REST que debe usar para crear el recurso. Cada proveedor de recursos publica sus propias versiones de API, por lo que este valor es específico del tipo.
  • name: Nombre del recurso.

La mayoría de los recursos también tienen una propiedad location, que establece la región donde se implementa el recurso.

Las demás propiedades varían según el tipo de recurso y la versión de API. Es importante comprender la relación entre la versión de API y las propiedades disponibles, así que lo analizaremos con más detalle.

En este tutorial, se agrega una cuenta de almacenamiento a la plantilla. Puede ver la versión de la API de la cuenta de almacenamiento en storageAccounts 2021-09-01. Tenga en cuenta que no ha agregado todas las propiedades a la plantilla. Muchas de las propiedades son opcionales. El proveedor de recursos Microsoft.Storage podría publicar una nueva versión de API, pero la versión que está implementando no tiene que cambiar. Puede seguir usando esa versión con la seguridad de que los resultados de la implementación son coherentes.

Si la versión de la API es anterior, el conjunto de propiedades disponible es menor.

Si decide cambiar la versión de API de un recurso, asegúrese de evaluar las propiedades de esa versión y ajustar la plantilla consecuentemente.

Implementar plantilla

Puede implementar la plantilla para crear la cuenta de almacenamiento. Asigne un nombre diferente a la implementación para poder encontrarla fácilmente en el historial.

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

New-AzResourceGroupDeployment `
  -Name addstorage `
  -ResourceGroupName myResourceGroup `
  -TemplateFile $templateFile

Nota

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

Estos son los posibles errores de implementación que puede encontrar:

  • Error: Code=AccountNameInvalid; Message={provide-unique-name} no es un nombre de cuenta de almacenamiento válido. El nombre de la cuenta de almacenamiento debe tener entre 3 y 24 caracteres, y usar solo números y letras minúsculas.

    En la plantilla, reemplace {provide-unique-name} por un nombre único de cuenta de almacenamiento. Consulte Agregar recurso.

  • Error: Code=StorageAccountAlreadyTaken; Message=The storage account named store1abc09092019 ya está en uso.

    En la plantilla, pruebe con un nombre de cuenta de almacenamiento diferente.

Esta implementación tarda más tiempo que la implementación de una plantilla en blanco porque se crea la cuenta de almacenamiento. Puede tardar un minuto aproximadamente.

Comprobación de la implementación

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

  1. Inicie sesión en Azure Portal.
  2. En el menú izquierdo, seleccione Grupos de recursos.
  3. Active la casilla situada a la izquierda de myResourceGroup y seleccione myResourceGroup.
  4. Seleccione el grupo de recursos en el que ha realizado la implementación.
  5. Verá que se ha implementado una cuenta de almacenamiento.
  6. Observe que la etiqueta de implementación ahora indica: Deployments: 2 Succeeded (Implementaciones: 2 correctas).

Limpieza de recursos

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

Si va a terminar ya, puede eliminar el grupo de recursos para limpiar los recursos que ha implementado.

  1. En Azure Portal, seleccione Grupos de recursos en el menú de la izquierda.
  2. Escriba el nombre del grupo de recursos en el cuadro Filtrar por cualquier campo....
  3. Active la casilla situada junto a myResourceGroup y seleccione myResourceGroup o el nombre del grupo de recursos que eligió.
  4. Seleccione Eliminar grupo de recursos del menú superior.

Pasos siguientes

Ha creado una plantilla sencilla para implementar una cuenta de almacenamiento de Azure. En los tutoriales posteriores, aprenderá a agregar parámetros, variables, recursos y salidas a una plantilla. Estas características son los bloques de creación de plantillas mucho más complejas.

Adición de parámetros