Sdílet prostřednictvím

Použití nástroje pro ověření šablony ve službě Azure Stack Hub

  • Článek

Zkontrolujte šablony Azure Resource Manager pomocí nástroje pro ověření šablon. Nástroj zkontroluje, jestli je šablona připravená k nasazení do služby Azure Stack Hub. Ověřovací nástroj můžete získat z úložiště GitHub tools služby Azure Stack Hub.

Poznámka

Nástroj ověří podporované typy prostředků a verze rozhraní API ve službě Azure Stack v šabloně Azure Resource Manager. Nástroj ale neověřuje vlastnosti podporované pro každý typ prostředku.

Přehled

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

  • Ve složce CloudCapabilities : Az.CloudCapabilities.psm1 vytvoří soubor JSON s funkcemi cloudu představující služby a verze v cloudu služby Azure Stack Hub.
  • Ve složce TemplateValidator : Az.TemplateValidator.psm1 používá k testování šablon pro nasazení ve službě Azure Stack Hub soubor JSON s cloudovými možnostmi.

Vytvoření souboru cloudových možností

Před použitím validátoru šablony vytvořte soubor JSON spuštěním modulu PowerShell Az.CloudCapabilities .

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í ke službě Azure Stack Hub. Tyto kroky můžete provést z hostitele sady Azure Stack Development Kit (ASDK) nebo můžete k připojení z pracovní stanice použít síť VPN .

  2. Naimportujte 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 AzureCloudCapabilities.json se vytvoří v aktuálním adresáři. Použijte skutečné umístění Azure:

Get-AzCloudCapability -Location <your location> -Verbose

Ověřování šablon

Pomocí těchto kroků ověřte šablony pomocí modulu Az.TemplateValidator PowerShell. Můžete použít vlastní šablony nebo šablony rychlý start služby Azure Stack Hub.

  1. Import modulu 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í šablon Azure Resource Manager. Yes
TemplatePattern Určuje název souborů šablon, které se mají shodovat. No
CapabilitiesPath Určuje cestu k souboru JSON ke cloudovým možnostem. 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 typy skladových položek. No
Report Určuje název vygenerované sestavy HTML. No
Verbose Protokoluje chyby a upozornění do konzoly. No

Příklady

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

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

Další kroky