Compartir a través de


Inicio rápido: Creación de plantillas de ARM mediante Visual Studio Code

Las herramientas de Azure Resource Manager para Visual Studio Code proporcionan compatibilidad con lenguajes, fragmentos de código de los recursos y la finalización automática de los recursos. Estas herramientas ayudan a crear y validar plantillas de Azure Resource Manager (plantillas de ARM) y, por tanto, son el método recomendado de creación y configuración de plantillas de ARM. En este inicio rápido usará la extensión para crear una plantilla de ARM desde cero. Al hacerlo, utilizará las funcionalidades de las extensiones, como los fragmentos de código de las plantillas de Resource Manager, la validación, las finalizaciones y la compatibilidad con archivos de parámetros.

Este inicio rápido se centra en el uso de la extensión de Visual Studio Code para compilar la plantilla de ARM. Para ver un tutorial más centrado en la sintaxis, consulte Tutorial: Crear e implementar la primera plantilla de ARM.

Para completar este inicio rápido, necesita Visual Studio Code con la extensión de herramientas de Azure Resource Manager instalada. También necesita la CLI de Azure o el módulo de Azure PowerShell instalados y autenticados.

Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.

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 de plantillas de archivos de Bicep con Visual Studio Code.

Nota:

La versión actual de la extensión Herramientas de Azure Resource Manager para Visual Studio Code no reconoce las mejoras realizadas en languageVersion 2.0.

Creación de una plantilla de Resource Manager

Cree y abra con Visual Studio Code un archivo llamado azuredeploy.json. Escriba arm en el editor de código, lo cual inicia fragmentos de código de Azure Resource Manager para aplicar la técnica scaffolding a una plantilla de Resource Manager.

Seleccione arm! para crear una plantilla limitada a la implementación de un grupo de recursos de Azure.

Captura de pantalla que muestra fragmentos de código de scaffolding de Azure Resource Manager.

Este fragmento de código crea los bloques de creación básicos para una plantilla de Resource Manager.

Captura de pantalla que muestra una plantilla de Resource Manager con scaffolding completo.

Tenga en cuenta que el modo de lenguaje de Visual Studio Code cambió de JSON a la plantilla de Azure Resource Manager. La extensión incluye un servidor de lenguaje específico para plantillas de ARM que proporciona una validación específica para estas plantillas, finalización y otros servicios de lenguaje.

Captura de pantalla que muestra Azure Resource Manager como el modo de lenguaje de Visual Studio Code.

Incorporación de un recurso de Azure

La extensión incluye fragmentos de código para muchos recursos de Azure. Estos fragmentos se pueden usar para agregar fácilmente recursos a la implementación de la plantilla.

Coloque el cursor en el bloque resources de la plantilla, escriba storage y seleccione el fragmento de código arm-storage.

Captura de pantalla que muestra cómo se agrega un recurso a la plantilla de Resource Manager.

Esta acción agrega un recurso de almacenamiento a la plantilla.

Captura de pantalla que muestra un recurso de Azure Storage en una plantilla de Resource Manager.

La tecla TAB se puede usar para recorrer las distintas propiedades configurables de la cuenta de almacenamiento.

Captura de pantalla que muestra cómo se puede usar la tecla TAB para desplazarse por la configuración de recursos.

Finalización y validación

Una de las funcionalidades más eficaces de la extensión es su integración con los esquemas de Azure. Estos esquemas proporcionan a la extensión funcionalidades de validación y finalización de recursos. Vamos a modificar la cuenta de almacenamiento para ver tanto la validación como la finalización en acción.

En primer lugar, actualice el tipo de cuenta de almacenamiento a un valor no válido, como megaStorage. Tenga en cuenta que esta acción genera una advertencia que indica que megaStorage no es un valor válido.

Captura de pantalla que muestra una configuración de almacenamiento no válida.

Para usar las funcionalidades de finalización, quite megaStorage, coloque el cursor dentro de las comillas dobles y presione ctrl + space. Esta acción presenta una lista de finalización de valores válidos.

Captura de pantalla que muestra la finalización automática de la extensión.

Incorporación de parámetros de plantilla

Ahora cree y use un parámetro para especificar el nombre de la cuenta de almacenamiento.

Coloque el cursor en el bloque de parámetros, agregue un retorno de carro, escriba " y seleccione el fragmento de código new-parameter. Esta acción agrega un parámetro genérico a la plantilla.

Captura de pantalla que muestra cómo se agrega un parámetro a la plantilla de Resource Manager.

Actualice el nombre del parámetro a storageAccountName y la descripción a Storage account name.

Captura de pantalla que muestra el parámetro completado en una plantilla de Resource Manager.

Los nombres de las cuentas de almacenamiento de Azure tienen una longitud mínima de tres caracteres y un máximo de 24. Agregue minLength y maxLength al parámetro y especifique los valores adecuados.

Captura de pantalla que muestra cómo se agregan minLength y maxLength a un parámetro de la plantilla de Resource Manager.

Ahora, en el recurso de almacenamiento, actualice la propiedad name para usar el parámetro. Para ello, quite el valor actual de la propiedad. Escriba una comilla doble y un corchete de apertura [, que genera una lista de funciones de la plantilla de Resource Manager. Seleccione parameters en la lista.

Captura de pantalla que muestra la finalización automática cuando se usan parámetros en los recursos de plantilla de Resource Manager.

Al escribir una comilla simple ' dentro de los paréntesis se genera una lista de todos los parámetros definidos en la plantilla, en este caso, storageAccountName. Seleccione el parámetro.

Captura de pantalla que muestra el parámetro completado en un recurso de la plantilla de Resource Manager.

Creación de un archivo de parámetros

Los archivos de parámetros de las plantillas de Resource Manager permiten almacenar valores de parámetro específicos del entorno y usarlos como un grupo en el momento de la implementación. Por ejemplo, puede tener un archivo de parámetros con valores específicos para un entorno de prueba y otro para un entorno de producción.

La extensión facilita la creación de un archivo de parámetros a partir de las plantillas existentes. Para ello, haga clic con el botón derecho en la plantilla en el editor de código y seleccione Select/Create Parameter File.

Captura de pantalla que muestra el proceso de hacer clic con el botón derecho para crear un archivo de parámetros a partir de una plantilla de Resource Manager.

Seleccione New>All Parameters> Seleccione el nombre y la ubicación del archivo de parámetros.

Esta acción crea un archivo de parámetros y lo asigna a la plantilla a partir de la que se creó. La asignación de archivos de la plantilla o parámetro actuales se puede ver y modificar en la barra de estado de Visual Studio Code mientras la plantilla esté seleccionada.

Captura de pantalla que muestra la asignación de plantilla y el archivo de parámetros en la barra de estado de Visual Studio Code.

Ahora que el archivo de parámetros se asigna a la plantilla, la extensión valida tanto la plantilla como el archivo de parámetros a la vez. Para ver esta validación en la práctica, agregue un valor de dos caracteres al parámetro storageAccountName del archivo de parámetros y guarde el archivo.

Captura de pantalla que muestra una plantilla no válida debido a un problema en el archivo de parámetros.

Vuelva a la plantilla de ARM y observe el error que indica que el valor no cumple los criterios de parámetro.

Captura de pantalla que muestra una plantilla de Resource Manager válida.

Actualice el valor a algo adecuado, guarde el archivo y vuelva a la plantilla. Observe que se ha resuelto el error en el parámetro.

Implementación de la plantilla

Abra el terminal de Visual Studio Code integrado con la combinación de teclas ctrl + ` y use la CLI de Azure o el módulo de Azure PowerShell para implementar la plantilla.

az group create --name arm-vscode --location eastus

az deployment group create --resource-group arm-vscode --template-file azuredeploy.json --parameters azuredeploy.parameters.json

Limpieza de recursos

Cuando los recursos de Azure dejen de ser necesarios, use la CLI de Azure o el módulo de Azure PowerShell para eliminar el grupo de recursos y el recurso del servidor del inicio rápido.

az group delete --name arm-vscode

Pasos siguientes