Partilhar 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 seu modelo está pronto para implantar 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 suportados e versões de API no Azure Stack. No entanto, a ferramenta não valida as propriedades suportadas para cada tipo de recurso.

Visão geral

Para validar um modelo, você deve primeiro criar um arquivo de recursos 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 recursos de nuvem representando os serviços e versões em uma nuvem do Azure Stack Hub.
  • Na pasta TemplateValidator : Az.TemplateValidator.psm1 usa um arquivo JSON de recursos de nuvem para testar modelos para implantação no Azure Stack Hub.

Crie o arquivo de recursos da 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 a partir de 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 recursos de nuvem. Se você não especificar -OutputPath, o arquivoAzureCloudCapabilities.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 Az.TemplateValidator.psm1 PowerShell:

    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 do modelo

Parâmetros

O cmdlet do validador de modelo suporta os 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 correspondidos. Não
CapabilitiesPath Especifica o caminho para o arquivo JSON de recursos de nuvem. Sim
IncludeComputeCapabilities Inclui avaliação de recursos IaaS, como tamanhos e extensões de VM. Não
IncludeStorageCapabilities Inclui 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óximos passos

  • Last updated on