Redacción de plantillas de ARM

Las plantillas de ARM permiten definir la infraestructura de Azure como código en formato JSON. Esto permite realizar implementaciones repetibles y coherentes, además de controlarlas mediante versiones junto con el código de la aplicación. Las plantillas son idempotentes: ejecutar la misma plantilla varias veces produce el mismo resultado, por lo que es seguro volver a aplicarlas después de realizar cambios.

Toda plantilla de ARM comienza con una propiedad $schema que apunta a la URL del esquema de la plantilla, seguida de una cadena contentVersion. El esquema indica al portal de Azure y a las extensiones del editor cómo validar la plantilla y proporcionar IntelliSense. Las cinco secciones principales que siguen son parameters, variables, functions, resources y outputs.

Los parámetros hacen que las plantillas sean reutilizables al aceptar entradas durante la implementación. Cada parámetro tiene un type (string, int, bool, object, array, secureString), un defaultValue opcional y allowedValues opcionales para la validación. Utilizar secureString para las contraseñas garantiza que el valor nunca se registre en el historial de implementación.

Las variables almacenan valores calculados a partir de parámetros o funciones de plantilla, lo que reduce la repetición y facilita el mantenimiento de las plantillas. Las variables se evalúan una vez y se referencian en toda la sección de recursos mediante la expresión [variables('name')]. Un patrón habitual consiste en crear el nombre de un recurso concatenando un parámetro con un sufijo único.

La matriz resources es el núcleo de una plantilla de ARM. Cada elemento describe un recurso de Azure con los campos obligatorios: type, apiVersion, name y location. apiVersion fija la versión del esquema del proveedor de recursos. Utilice siempre una versión estable reciente para acceder a las funciones más recientes y evitar propiedades en desuso.

Las expresiones de las plantillas de ARM están delimitadas por corchetes [...] y admiten funciones integradas para cadenas, matrices, objetos e identificadores de recursos. Entre las funciones habituales se incluyen concat(), resourceGroup(), resourceId(), uniqueString() y parameters(). ARM evalúa estas funciones en el servidor durante la implementación, no localmente.

La sección outputs define los valores que ARM devuelve después de una implementación correcta. Los outputs son esenciales para encadenar plantillas: puede implementar una plantilla de red y devolver el identificador de recurso de la subred, y luego pasarlo como parámetro a una plantilla de máquina virtual. Los outputs pueden hacer referencia a cualquier expresión, incluidas las propiedades de recursos de la implementación.

Para arquitecturas complejas, ARM admite plantillas vinculadas (que hacen referencia a URL de plantillas externas) y plantillas anidadas (que integran una plantilla dentro de la matriz de recursos mediante el tipo Microsoft.Resources/deployments). Esto permite dividir una implementación de infraestructura grande en componentes modulares y reutilizables, manteniendo una única plantilla de orquestación como punto de entrada.

En lugar de pasar los parámetros en la línea de comandos, almacénelos en un archivo de parámetros independiente: un archivo JSON con un objeto parameters que contiene pares de nombre y valor. Los archivos de parámetros pueden ser específicos de cada entorno (por ejemplo, dev.parameters.json y prod.parameters.json) y confirmarse en el control de código fuente, manteniendo los valores confidenciales en referencias a Azure Key Vault en lugar de texto sin formato.

Utilice el comando de Azure CLI az deployment group create para implementar una plantilla en un grupo de recursos. Antes de realizar la implementación en producción, ejecute az deployment group validate para detectar errores de esquema y lógica, y az deployment group what-if para previsualizar los cambios en los recursos. Estos tres comandos forman una canalización de implementación segura: validar, previsualizar e implementar.

Siga estos procedimientos recomendados para las plantillas de ARM: utilice parámetros para los valores específicos de cada entorno, utilice variables para evitar repeticiones, fije las versiones de API en versiones estables, utilice secureString para las contraseñas, agregue descripciones de metadatos a los parámetros y separe las plantillas grandes en módulos vinculados. Almacene las plantillas en un repositorio de Git e impleméntelas mediante una canalización de CI/CD para facilitar la auditoría.

Compruebe su comprensión de los conceptos de Microsoft Azure Fundamentals (AZ-900) de esta lección.

En esta lección ha aprendido que las plantillas de ARM son documentos JSON que definen declarativamente la infraestructura de Azure; los parámetros y las variables hacen que las plantillas sean reutilizables y fáciles de mantener; y el flujo de trabajo validate, what-if, deploy permite realizar implementaciones seguras y repetibles. A continuación, exploraremos Bicep, una abstracción moderna de ARM JSON.