Použití nástroje pro ověřování šablon v Azure Stack Hub

Zkontrolujte své Azure Resource Manager šablony pomocí nástroje pro ověřování šablon. Nástroj zkontroluje, jestli je vaše šablona připravená k nasazení do Azure Stack Hub. Nástroj pro ověřování můžete získat z Azure Stack Hub nástrojů GitHub.

Poznámka

Nástroj ověří šablonu Azure Resource Manager pro podporované typy prostředků a verze rozhraní API v Azure Stack. Nástroj ale neověřuje vlastnosti podporované pro jednotlivé typy prostředků.

Přehled

Pokud chcete šablonu ověřit, musíte nejprve vytvořit soubor cloudových schopností a pak spustit nástroj pro ověřování. Použijte následující moduly PowerShellu z Azure Stack Hub nástrojů:

  • Ve složce CloudCapabilities:Az.CloudCapabilities.psm1 vytvoří soubor JSON s funkcemi cloudu, který představuje služby a verze v Azure Stack Hub cloudu.
  • Ve složce TemplateValidator:Az.TemplateValidator.psm1 používá soubor JSON s funkcemi cloudu k testování šablon pro nasazení v Azure Stack Hub.

Vytvoření souboru možností cloudu

Před použitím validátoru šablony spusťte modul PowerShellu Az.CloudCapabilities a sestavte soubor JSON.

Poznámka

Pokud aktualizujete integrovaný systém nebo přidáte nové služby nebo virtuální rozšíření, měli byste tento modul spustit znovu.

  1. Ujistěte se, že máte připojení k Azure Stack Hub. Tyto kroky je možné provést z hostitele Azure Stack Development Kit (ASDK), nebo můžete použít síť VPN pro připojení z pracovní stanice.

  2. Importujte modul PowerShellu Az.CloudCapabilities:

    Import-Module .\CloudCapabilities\Az.CloudCapabilities.psm1
    
  3. Pomocí rutiny Get-CloudCapabilities načtěte verze služby a vytvořte soubor JSON s funkcemi cloudu. Pokud nezadáte -OutputPath , soubor -OutputPath se vytvoří v aktuálním adresáři. Použijte vlastní umístění Azure:

Get-AzCloudCapability -Location <your location> -Verbose

Ověřování šablon

Pomocí těchto kroků můžete šablony ověřit pomocí modulu PowerShellu Az.TemplateValidator. Můžete použít vlastní šablony nebo použít šablony Azure Stack Hub pro rychlý start.

  1. Importujte modul PowerShellu Az.TemplateValidator.psm1:

    cd "c:\AzureStack-Tools-az\TemplateValidator"
    Import-Module .\Az.TemplateValidator.psm1
    
  2. Spusťte validátor šablony:

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

Validátor zobrazí upozornění nebo chyby ověření šablony v konzole PowerShellu a zapíše je do souboru HTML ve zdrojovém adresáři. Následující snímek obrazovky je příkladem sestavy ověření:

Sestava ověření šablony

Parametry

Rutina validátoru šablony podporuje následující parametry.

Parametr Popis Povinné
TemplatePath Určuje cestu k rekurzivnímu vyhledání Azure Resource Manager šablon. Yes
TemplatePattern Určuje název souborů šablon, které se musí shodovat. No
CapabilitiesPath Určuje cestu k souboru JSON s funkcemi cloudu. Yes
IncludeComputeCapabilities Zahrnuje vyhodnocení prostředků IaaS, jako jsou velikosti virtuálních počítačů a rozšíření virtuálních počítačů. No
IncludeStorageCapabilities Zahrnuje vyhodnocení prostředků úložiště, jako jsou například typy skladových položek. No
Report Určuje název vygenerované sestavy HTML. No
Verbose Zaznamená do konzoly chyby a upozornění. No

Příklady

Tento příklad ověří všechny šablony Azure Stack Hub pro rychlý start stažených do místního úložiště. Tento příklad také ověřuje velikosti a rozšíření virtuálních počítačů podle možností ASDK.

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

Další kroky