Använd verktyget för validering av mallar i Azure Stack hubbUse the template validation tool in Azure Stack Hub

Använd verktyget för validering av mallar för att kontrol lera om dina Azure Resource Manager mallar är redo att distribueras till Azure Stack Hub.Use the template validation tool to check whether your Azure Resource Manager templates are ready to deploy to Azure Stack Hub. Verktyget för verifiering av mallar är tillgängligt i Azure Stack Hub-verktyg GitHub lagrings platsen.The template validation tool is available in the Azure Stack Hub tools GitHub repo. Hämta Azure Stack Hub-verktyg med hjälp av stegen som beskrivs i Hämta verktyg från GitHub.Download the Azure Stack Hub tools by using the steps described in Download tools from GitHub.

ÖversiktOverview

Om du vill validera en mall måste du först skapa en fil för moln funktioner och sedan köra verifierings verktyget.To validate a template, you must first build a cloud capabilities file, and then run the validation tool. Använd följande PowerShell-moduler från Azure Stack Hub-verktyg:Use the following PowerShell modules from Azure Stack Hub tools:

  • I mappen CloudCapabilities : AZ. CloudCapabilities. PSM1 skapas en JSON-fil med moln funktioner som representerar tjänsterna och versionerna i ett Azure Stack Hub-moln.In the CloudCapabilities folder: Az.CloudCapabilities.psm1 creates a cloud capabilities JSON file representing the services and versions in an Azure Stack Hub cloud.
  • I mappen TemplateValidator : AZ. TemplateValidator. PSM1 använder en JSON-fil med moln funktioner för att testa mallar för distribution i Azure Stack Hub.In the TemplateValidator folder: Az.TemplateValidator.psm1 uses a cloud capabilities JSON file to test templates for deployment in Azure Stack Hub.

Bygg filen med moln funktionerBuild the cloud capabilities file

Innan du använder Template-verifieraren kör du PowerShell-modulen AZ. CloudCapabilities för att skapa en JSON-fil.Before you use the template validator, run the Az.CloudCapabilities PowerShell module to build a JSON file.

Anteckning

Om du uppdaterar det integrerade systemet, eller lägger till nya tjänster eller virtuella tillägg, bör du köra den här modulen igen.If you update your integrated system, or add any new services or virtual extensions, you should run this module again.

  1. Se till att du har anslutning till Azure Stack Hub.Make sure you have connectivity to Azure Stack Hub. De här stegen kan göras från Azure Stack Development Kit-värden (ASDK), eller så kan du använda en VPN- anslutning för att ansluta från din arbets Station.These steps can be done from the Azure Stack Development Kit (ASDK) host, or you can use a VPN to connect from your workstation.

  2. Importera PowerShell-modulen AZ. CloudCapabilities :Import the Az.CloudCapabilities PowerShell module:

    Import-Module .\CloudCapabilities\Az.CloudCapabilities.psm1
    
  3. Använd cmdleten Get-CloudCapabilities för att hämta tjänst versioner och skapa en JSON-fil för moln funktioner.Use the Get-CloudCapabilities cmdlet to retrieve service versions and create a cloud capabilities JSON file. Om du inte anger -OutputPath så skapas filen AzureCloudCapabilities.jspå i den aktuella katalogen.If you do not specify -OutputPath, the file AzureCloudCapabilities.json is created in the current directory. Använd din faktiska Azure-plats:Use your actual Azure location:

Get-AzCloudCapability -Location <your location> -Verbose

Validera mallarValidate templates

Använd de här stegen för att verifiera mallar med PowerShell-modulen AZ. TemplateValidator .Use these steps to validate templates by using the Az.TemplateValidator PowerShell module. Du kan använda dina egna mallar eller använda snabb starts mallarna för Azure Stack Hub.You can use your own templates, or use the Azure Stack Hub Quickstart templates.

  1. Importera PowerShell-modulen AZ. TemplateValidator. psm1 :Import the Az.TemplateValidator.psm1 PowerShell module:

    cd "c:\AzureStack-Tools-az\TemplateValidator"
    Import-Module .\Az.TemplateValidator.psm1
    
  2. Kör mal len verifierare:Run the template validator:

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

Verifierings varningar eller fel för mallar visas i PowerShell-konsolen och skrivs till en HTML-fil i käll katalogen.Template validation warnings or errors are displayed in the PowerShell console and written to an HTML file in the source directory. Följande skärm bild är ett exempel på en verifierings rapport:The following screenshot is an example of a validation report:

Verifierings rapport för mall

ParametrarParameters

Cmdleten validator-cmdlet stöder följande parametrar.The template validator cmdlet supports the following parameters.

ParameterParameter BeskrivningDescription KrävsRequired
TemplatePath Anger sökvägen för att rekursivt hitta Azure Resource Manager mallar.Specifies the path to recursively find Azure Resource Manager templates. JaYes
TemplatePattern Anger namnet på mallfilerna som ska matchas.Specifies the name of template files to match. NejNo
CapabilitiesPath Anger sökvägen till JSON-filen med moln funktioner.Specifies the path to the cloud capabilities JSON file. JaYes
IncludeComputeCapabilities Omfattar utvärdering av IaaS-resurser, till exempel VM-storlekar och VM-tillägg.Includes evaluation of IaaS resources, such as VM sizes and VM extensions. NejNo
IncludeStorageCapabilities Omfattar utvärdering av lagrings resurser, t. ex. SKU-typer.Includes evaluation of storage resources, such as SKU types. NejNo
Report Anger namnet på den genererade HTML-rapporten.Specifies the name of the generated HTML report. NejNo
Verbose Loggar fel och varningar till-konsolen.Logs errors and warnings to the console. NejNo

ExempelExamples

I det här exemplet verifieras alla snabb starts mallar för Azure Stack Hub som hämtats till lokal lagring.This example validates all of the Azure Stack Hub Quickstart templates downloaded to local storage. I exemplet verifieras även storlekar och tillägg för virtuella datorer (VM) mot ASDK-funktioner.The example also validates virtual machine (VM) sizes and extensions against ASDK capabilities.

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

Nästa stegNext steps