Använda mallvalideringsverktyget i Azure Stack Hub

  • Artikel

Kontrollera dina Azure Resource Manager-mallar med mallverifieringsverktyget. Verktyget kontrollerar om mallen är redo att distribueras till Azure Stack Hub. Du kan hämta valideringsverktyget från GitHub-lagringsplatsen för Azure Stack Hub-verktyg.

Anteckning

Verktyget verifierar Azure Resource Manager-mallen för resurstyper och API-versioner som stöds i Azure Stack. Verktyget verifierar dock inte de egenskaper som stöds för varje resurstyp.

Översikt

För att verifiera en mall måste du först skapa en molnfunktionsfil och sedan köra valideringsverktyget. Använd följande PowerShell-moduler från Azure Stack Hub-verktyg:

  • I mappen CloudCapabilities : Az.CloudCapabilities.psm1 skapas en JSON-fil för molnfunktioner som representerar tjänsterna och versionerna i ett Azure Stack Hub-moln.
  • I mappen TemplateValidator : Az.TemplateValidator.psm1 används en JSON-fil för molnfunktioner för att testa mallar för distribution i Azure Stack Hub.

Skapa molnfunktionsfilen

Innan du använder mallverifieraren kör du Az.CloudCapabilities PowerShell-modulen för att skapa en JSON-fil.

Anteckning

Om du uppdaterar ditt integrerade system eller lägger till nya tjänster eller virtuella tillägg bör du köra den här modulen igen.

  1. Kontrollera att du har anslutning till Azure Stack Hub. De här stegen kan utföras från Azure Stack Development Kit-värden (ASDK), eller så kan du använda ett VPN för att ansluta från din arbetsstation.

  2. Importera Az.CloudCapabilities PowerShell-modulen:

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

  3. Använd cmdleten Get-CloudCapabilities för att hämta tjänstversioner och skapa en JSON-fil för molnfunktioner. Om du inte anger -OutputPathskapas filen AzureCloudCapabilities.json i den aktuella katalogen. Använd din faktiska Azure-plats:

Get-AzCloudCapability -Location <your location> -Verbose

Validera mallar

Använd de här stegen för att verifiera mallar med hjälp av PowerShell-modulen Az.TemplateValidator . Du kan använda dina egna mallar eller använda Snabbstartsmallar för Azure Stack Hub.

  1. Importera PowerShell-modulen Az.TemplateValidator.psm1 :

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

  2. Kör mallverifieraren:

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

Validatorn visar varningar eller fel för mallvalidering i PowerShell-konsolen och skriver dem till en HTML-fil i källkatalogen. Följande skärmbild är ett exempel på en valideringsrapport:

Mallvalideringsrapport

Parametrar

Cmdleten för mallverifieraren stöder följande parametrar.

Parameter Beskrivning Krävs
TemplatePath Anger sökvägen för att rekursivt hitta Azure Resource Manager-mallar. Yes
TemplatePattern Anger namnet på mallfilerna som ska matchas. No
CapabilitiesPath Anger sökvägen till JSON-filen för molnfunktioner. Yes
IncludeComputeCapabilities Innehåller utvärdering av IaaS-resurser, till exempel VM-storlekar och VM-tillägg. No
IncludeStorageCapabilities Innehåller utvärdering av lagringsresurser, till exempel SKU-typer. No
Report Anger namnet på den genererade HTML-rapporten. No
Verbose Loggar fel och varningar till konsolen. No

Exempel

Det här exemplet validerar alla Azure Stack Hub-snabbstartsmallar som laddats ned till lokal lagring. Exemplet validerar även storlekar och tillägg för virtuella datorer (VM) mot ASDK-funktioner.

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

Nästa steg