Compartilhar via

Usar a ferramenta de validação de modelo no Azure Stack Hub

Verifique seus modelos do Azure Resource Manager com a ferramenta de validação de modelo. A ferramenta verifica se o modelo está pronto para ser implantado no Azure Stack Hub. Você pode obter a ferramenta de validação do repositório GitHub das ferramentas do Azure Stack Hub.

Observação

A ferramenta valida o modelo do Azure Resource Manager para tipos de recursos e versões de API com suporte no Azure Stack. No entanto, a ferramenta não valida as propriedades com suporte para cada tipo de recurso.

Visão geral

Para validar um modelo, primeiro você deve criar um arquivo de funcionalidades de nuvem e, em seguida, executar a ferramenta de validação. Use os seguintes módulos do PowerShell das ferramentas do Azure Stack Hub:

  • Na pasta CloudCapabilities : Az.CloudCapabilities.psm1 cria um arquivo JSON de funcionalidades de nuvem que representa os serviços e versões em uma nuvem do Azure Stack Hub.
  • Na pasta TemplateValidator : Az.TemplateValidator.psm1 usa um arquivo JSON de funcionalidades de nuvem para testar modelos para implantação no Azure Stack Hub.

Criar o arquivo de funcionalidades de nuvem

Antes de usar o validador de modelo, execute o módulo Az.CloudCapabilities PowerShell para criar um arquivo JSON.

Observação

Se você atualizar seu sistema integrado ou adicionar novos serviços ou extensões virtuais, deverá executar este módulo novamente.

  1. Verifique se você tem conectividade com o Azure Stack Hub. Essas etapas podem ser feitas a partir de uma VPN para se conectar em sua estação de trabalho.

  2. Importe o módulo Az.CloudCapabilities PowerShell:

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

  3. Use o Get-CloudCapabilities cmdlet para recuperar versões de serviço e criar um arquivo JSON de funcionalidades de nuvem. Se você não especificar -OutputPath, o arquivo AzureCloudCapabilities.json será criado no diretório atual. Use seu local real do Azure:

    Get-AzCloudCapability -Location <your location> -Verbose

Validar modelos

Use estas etapas para validar modelos usando o módulo Az.TemplateValidator PowerShell. Você pode usar seus próprios modelos ou usar os modelos de Início Rápido do Azure Stack Hub.

  1. Importe o módulo do PowerShell Az.TemplateValidator.psm1 :

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

  2. Execute o validador de modelo:

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

O validador exibe avisos ou erros de validação de modelo no console do PowerShell e os grava em um arquivo HTML no diretório de origem. A captura de tela a seguir é um exemplo de um relatório de validação:

Relatório de validação de modelo

Parâmetros

O cmdlet do validador de modelo dá suporte aos seguintes parâmetros.

Parâmetro Descrição Obrigatório
TemplatePath Especifica o caminho para localizar recursivamente modelos do Azure Resource Manager. Sim
TemplatePattern Especifica o nome dos arquivos de modelo a serem correspondentes. Não
CapabilitiesPath Especifica o caminho para o arquivo JSON de funcionalidades de nuvem. Sim
IncludeComputeCapabilities Inclui a avaliação de recursos de IaaS, como tamanhos de VM e extensões de VM. Não
IncludeStorageCapabilities Inclui a avaliação de recursos de armazenamento, como tipos de SKU. Não
Report Especifica o nome do relatório HTML gerado. Não
Verbose Registra erros e avisos no console. Não

Exemplos

Este exemplo valida todos os modelos de Início Rápido do Azure Stack Hub baixados para o armazenamento local.

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

Próximas etapas

  • Last updated on