Condividi tramite

Usare lo strumento di convalida del modello nell'hub di Azure Stack

Controllare i modelli di Azure Resource Manager con lo strumento di convalida dei modelli. Lo strumento controlla se il modello è pronto per la distribuzione nell'hub di Azure Stack. È possibile ottenere lo strumento di convalida dal repository GitHub degli strumenti dell'hub di Azure Stack.

Annotazioni

Lo strumento convalida il modello di Azure Resource Manager per i tipi di risorse e le versioni API supportati in Azure Stack. Tuttavia, lo strumento non convalida le proprietà supportate per ogni tipo di risorsa.

Informazioni generali

Per convalidare un modello, è prima necessario compilare un file di funzionalità cloud e quindi eseguire lo strumento di convalida. Usare i moduli di PowerShell seguenti dagli strumenti dell'hub di Azure Stack:

  • Nella cartella CloudCapabilities : Az.CloudCapabilities.psm1 crea un file JSON delle funzionalità cloud che rappresenta i servizi e le versioni in un cloud dell'hub di Azure Stack.
  • Nella cartella TemplateValidator : Az.TemplateValidator.psm1 usa un file JSON delle funzionalità cloud per testare i modelli per la distribuzione nell'hub di Azure Stack.

Creare il file delle funzionalità cloud

Prima di usare il validator del modello, eseguire il modulo Az.CloudCapabilities di PowerShell per compilare un file JSON.

Annotazioni

Se si aggiorna il sistema integrato o si aggiungono nuovi servizi o estensioni virtuali, è necessario eseguire di nuovo questo modulo.

  1. Assicurarsi di avere connettività all'hub di Azure Stack. Questi passaggi possono essere eseguiti da una VPN per connettersi dalla workstation.

  2. Importare il modulo PowerShell Az.CloudCapabilities

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

  3. Usare il Get-CloudCapabilities cmdlet per recuperare le versioni del servizio e creare un file JSON delle funzionalità cloud. Se non si specifica -OutputPath, il fileAzureCloudCapabilities.json viene creato nella directory corrente. Usare la tua posizione effettiva di Azure:

    Get-AzCloudCapability -Location <your location> -Verbose

Convalidare i modelli

Usare questi passaggi per convalidare i modelli usando il modulo Az.TemplateValidator di PowerShell. È possibile usare modelli personalizzati o usare i modelli di avvio rapido dell'hub di Azure Stack.

  1. Importare il modulo Az.TemplateValidator.psm1 di PowerShell:

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

  2. Esegui il validatore di modelli:

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

Il validator visualizza avvisi o errori di convalida dei modelli nella console di PowerShell e li scrive in un file HTML nella directory di origine. Lo screenshot seguente è un esempio di un report di convalida:

Report di convalida dei modelli

Parametri

Il cmdlet di convalida del modello supporta i parametri seguenti.

Parametro Descrizione Obbligatorio
TemplatePath Specifica il percorso per trovare in modo ricorsivo i modelli di Azure Resource Manager. Sì
TemplatePattern Specifica il nome dei file modello da corrispondere. NO
CapabilitiesPath Specifica il percorso del file JSON delle funzionalità cloud. Sì
IncludeComputeCapabilities Include la valutazione delle risorse IaaS, ad esempio le dimensioni delle macchine virtuali e le estensioni della macchina virtuale. NO
IncludeStorageCapabilities Include la valutazione delle risorse di archiviazione, ad esempio i tipi di SKU. NO
Report Specifica il nome del report HTML generato. NO
Verbose Registra gli errori e gli avvisi nella console. NO

Esempi

Questo esempio convalida tutti i modelli di avvio rapido dell'hub di Azure Stack scaricati nell'archiviazione locale.

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

Passaggi successivi