Använda mallverifieringsverktyget i Azure Stack Hub

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.

Anmärkning

Verktyget validerar Azure Resource Manager-mallen för resurstyper som stöds och API-versioner 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 fil för molnfunktioner 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 filen med molnfunktioner

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

Anmärkning

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 ett VPN för att ansluta från din arbetsstation.

  2. Importera PowerShell-modulen Az.CloudCapabilities :

    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

Verifiera 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

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

Mallverifieringsrapport

Parameterar

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. Ja
TemplatePattern Anger namnet på mallfiler som ska matchas. Nej
CapabilitiesPath Anger sökvägen till JSON-filen för molnfunktioner. Ja
IncludeComputeCapabilities Innehåller utvärdering av IaaS-resurser, till exempel VM-storlekar och VM-tillägg. Nej
IncludeStorageCapabilities Innehåller utvärdering av lagringsresurser, till exempel SKU-typer. Nej
Report Anger namnet på den genererade HTML-rapporten. Nej
Verbose Loggar fel och varningar till konsolen. Nej

Exempel

Det här exemplet validerar alla Azure Stack Hub-snabbstartsmallar som laddats ned till lokal lagring.

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

Nästa steg

  • Last updated on