Uso de la herramienta de validación de plantillas en Azure Stack Hub

  • Artículo

Compruebe las plantillas de Azure Resource Manager con la herramienta de validación de plantillas. La herramienta comprueba si la plantilla está lista para implementarse en Azure Stack Hub. Puede obtener la herramienta de validación desde el repositorio de GitHub de herramientas de Azure Stack Hub.

Nota

La herramienta valida la plantilla de Azure Resource Manager para los tipos de recursos admitidos y las versiones de API en Azure Stack. Sin embargo, la herramienta no valida las propiedades admitidas para cada tipo de recurso.

Información general

Para validar una plantilla, primero tiene que crear un archivo con funcionalidades de la nube y, a continuación, ejecutar la herramienta de validación. Use los siguientes módulos de PowerShell desde las herramientas de Azure Stack Hub:

  • En la carpeta CloudCapabilities: Az.CloudCapabilities.psm1 crea un archivo JSON de funcionalidades de la nube que representa los servicios y las versiones en una nube de Azure Stack Hub.
  • En la carpeta TemplateValidator: Az.TemplateValidator.psm1 utiliza un archivo JSON de funcionalidades de la nube para probar plantillas para la implementación en Azure Stack Hub.

Genere el archivo de funcionalidades de la nube

Para poder usar el validador de plantillas, ejecute el módulo de PowerShell Az.CloudCapabilities para generar un archivo JSON.

Nota:

Si actualiza el sistema integrado o agrega los nuevos servicios o extensiones virtuales, también debe volver a ejecutar ese módulo.

  1. Asegúrese de que dispone de conectividad con Azure Stack Hub. Estos pasos se pueden realizar desde el host del Kit de desarrollo de Azure Stack (ASDK), o se puede usar una VPN para conectarse desde la estación de trabajo.

  2. Importe el módulo de PowerShell Az.CloudCapabilities:

    Import-Module .\CloudCapabilities\Az.CloudCapabilities.psm1

  3. Use el cmdlet Get-CloudCapabilities para recuperar las versiones de servicio y crear un archivo JSON de funcionalidades de la nube. Si no se especifica -OutputPath, se crea el archivo AzureCloudCapabilities.json en el directorio actual. Use la ubicación real de Azure:

Get-AzCloudCapability -Location <your location> -Verbose

Validar plantillas

Siga estos pasos para validar las plantillas mediante el módulo de PowerShell Az.TemplateValidator. Puede usar tanto sus propias plantillas como las plantillas de inicio rápido de Azure Stack Hub.

  1. Importe el módulo de PowerShell Az.TemplateValidator.psm1:

    cd "c:\AzureStack-Tools-az\TemplateValidator"
Import-Module .\Az.TemplateValidator.psm1

  2. Ejecute el validador de plantillas:

Test-AzTemplate -TemplatePath <path to template.json or template folder> `
-CapabilitiesPath <path to cloudcapabilities.json> `
-Verbose

El validador muestra los errores o las advertencias de validación de plantillas en la consola de PowerShell y los escribe en un archivo HTML del directorio de origen. La captura de pantalla siguiente es un ejemplo de un informe de validación:

Informe de comprobación de plantilla

Parámetros

El cmdlet del validador de plantillas admite los siguientes parámetros.

Parámetro Descripción Obligatorio
TemplatePath Especifica la ruta de acceso para buscar de forma recursiva las plantillas de Azure Resource Manager. Sí
TemplatePattern Especifica el nombre de los archivos de plantilla para que coincida. No
CapabilitiesPath Especifica la ruta de acceso al archivo JSON con funcionalidades de la nube. Sí
IncludeComputeCapabilities Incluye la evaluación de recursos de IaaS, como tamaños de máquina virtual y extensiones de máquina virtual. No
IncludeStorageCapabilities Incluye la evaluación de recursos de almacenamiento, como los tipos de SKU. No
Report Especifica el nombre del informe HTML generado. No
Verbose Registra los errores y las advertencias en la consola. No

Ejemplos

En este ejemplo, se validan todas las plantillas de inicio rápido de Azure Stack Hub descargadas en el almacenamiento local. Además, en el ejemplo se validan las extensiones y los tamaños de máquina virtual (VM) con respecto a las funcionalidades de ASDK.

test-AzTemplate -TemplatePath C:\AzureStack-Quickstart-Templates `
-CapabilitiesPath .\TemplateValidator\AzureStackCloudCapabilities_with_AddOns_20170627.json `
-TemplatePattern MyStandardTemplateName.json `
-IncludeComputeCapabilities `
-Report TemplateReport.html

Pasos siguientes