Gebruik het hulp programma voor sjabloon validatie in Azure Stack hubUse the template validation tool in Azure Stack Hub

Gebruik het hulp programma voor sjabloon validatie om te controleren of uw Azure Resource Manager sjablonen gereed zijn om te implementeren op Azure stack hub.Use the template validation tool to check whether your Azure Resource Manager templates are ready to deploy to Azure Stack Hub. Het hulp programma voor het valideren van de sjabloon is beschikbaar in de Azure Stack hub-hulpprogram ma's GitHub opslag plaats.The template validation tool is available in the Azure Stack Hub tools GitHub repo. Down load de Azure Stack hub-hulpprogram ma's met behulp van de stappen die worden beschreven in hulpprogram Ma's downloaden van github.Download the Azure Stack Hub tools by using the steps described in Download tools from GitHub.

OverzichtOverview

Als u een sjabloon wilt valideren, moet u eerst een bestand met Cloud mogelijkheden maken en vervolgens het validatie programma uitvoeren.To validate a template, you must first build a cloud capabilities file, and then run the validation tool. Gebruik de volgende Power shell-modules van Azure Stack hub-hulpprogram ma's:Use the following PowerShell modules from Azure Stack Hub tools:

  • In de map CloudCapabilities : AZ. CloudCapabilities. psm1 maakt u een JSON-bestand met Cloud mogelijkheden waarmee de services en versies in een Azure stack hub-Cloud worden weer geven.In the CloudCapabilities folder: Az.CloudCapabilities.psm1 creates a cloud capabilities JSON file representing the services and versions in an Azure Stack Hub cloud.
  • In de map TemplateValidator : AZ. TemplateValidator. PSM1 gebruikt een JSON-bestand Cloud Capabilities om sjablonen te testen voor implementatie in 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.

Het bestand met Cloud mogelijkheden bouwenBuild the cloud capabilities file

Voordat u de sjabloon validatie functie gebruikt, voert u de AZ. CloudCapabilities Power shell-module uit om een JSON-bestand te maken.Before you use the template validator, run the Az.CloudCapabilities PowerShell module to build a JSON file.

Notitie

Als u het geïntegreerde systeem bijwerkt of nieuwe services of virtuele uitbrei dingen toevoegt, moet u deze module opnieuw uitvoeren.If you update your integrated system, or add any new services or virtual extensions, you should run this module again.

  1. Zorg ervoor dat u verbinding hebt met Azure Stack hub.Make sure you have connectivity to Azure Stack Hub. Deze stappen kunnen worden uitgevoerd vanaf de host van de Azure Stack Development Kit (ASDK), maar u kunt ook een VPN gebruiken om verbinding te maken vanaf uw werk 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. Importeer de Power shell-module AZ. CloudCapabilities :Import the Az.CloudCapabilities PowerShell module:

    Import-Module .\CloudCapabilities\Az.CloudCapabilities.psm1
    
  3. Gebruik de cmdlet Get-CloudCapabilities om service versies op te halen en een JSON-bestand met Cloud mogelijkheden te maken.Use the Get-CloudCapabilities cmdlet to retrieve service versions and create a cloud capabilities JSON file. Als u niet opgeeft -OutputPath , wordt het bestand AzureCloudCapabilities.jsaan gemaakt in de huidige map.If you do not specify -OutputPath, the file AzureCloudCapabilities.json is created in the current directory. Gebruik uw werkelijke Azure-locatie:Use your actual Azure location:

Get-AzCloudCapability -Location <your location> -Verbose

Sjablonen validerenValidate templates

Gebruik deze stappen om sjablonen te valideren met behulp van de Power shell-module AZ. TemplateValidator .Use these steps to validate templates by using the Az.TemplateValidator PowerShell module. U kunt uw eigen sjablonen gebruiken of de Quick Start- sjablonen van Azure stack hubgebruiken.You can use your own templates, or use the Azure Stack Hub Quickstart templates.

  1. Importeer de Power shell-module AZ. TemplateValidator. psm1 :Import the Az.TemplateValidator.psm1 PowerShell module:

    cd "c:\AzureStack-Tools-az\TemplateValidator"
    Import-Module .\Az.TemplateValidator.psm1
    
  2. De validatie van de sjabloon uitvoeren:Run the template validator:

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

Sjabloon validatie waarschuwingen of-fouten worden weer gegeven in de Power shell-console en geschreven naar een HTML-bestand in de bron directory.Template validation warnings or errors are displayed in the PowerShell console and written to an HTML file in the source directory. De volgende scherm afbeelding is een voor beeld van een validatie rapport:The following screenshot is an example of a validation report:

Rapport voor sjabloon validatie

ParametersParameters

De cmdlet voor sjabloon validatie ondersteunt de volgende para meters.The template validator cmdlet supports the following parameters.

ParameterParameter BeschrijvingDescription VereistRequired
TemplatePath Hiermee geeft u het pad voor het recursief zoeken van Azure Resource Manager sjablonen.Specifies the path to recursively find Azure Resource Manager templates. JaYes
TemplatePattern Hiermee geeft u de naam op van de sjabloon bestanden die moeten worden vergeleken.Specifies the name of template files to match. NeeNo
CapabilitiesPath Hiermee geeft u het pad op naar het JSON-bestand met Cloud mogelijkheden.Specifies the path to the cloud capabilities JSON file. JaYes
IncludeComputeCapabilities Omvat de evaluatie van IaaS-resources, zoals VM-grootten en VM-extensies.Includes evaluation of IaaS resources, such as VM sizes and VM extensions. NeeNo
IncludeStorageCapabilities Omvat de evaluatie van opslag resources, zoals SKU-typen.Includes evaluation of storage resources, such as SKU types. NeeNo
Report Hiermee geeft u de naam op van het gegenereerde HTML-rapport.Specifies the name of the generated HTML report. NeeNo
Verbose Registreert fouten en waarschuwingen in de-console.Logs errors and warnings to the console. NeeNo

VoorbeeldenExamples

In dit voor beeld worden alle Quick Start- sjablonen van Azure stack hub gevalideerd die naar lokale opslag zijn gedownload.This example validates all of the Azure Stack Hub Quickstart templates downloaded to local storage. Het voor beeld valideert ook de grootte van virtuele machines (VM) en uitbrei dingen voor ASDK-mogelijkheden.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

Volgende stappenNext steps