Verwenden des Validierungstools für Vorlagen in Azure Stack Hub

  • Artikel

Überprüfen Sie Ihre Azure Resource Manager-Vorlagen mit dem Validierungstool für Vorlagen. Das Tool überprüft, ob Ihre Vorlage in Azure Stack Hub bereitgestellt werden kann. Sie können das Validierungstool aus dem GitHub-Repository für Azure Stack Hub-Tools abrufen.

Hinweis

Das Tool überprüft die Azure Resource Manager-Vorlage auf unterstützte Ressourcentypen und API-Versionen in Azure Stack. Das Tool überprüft jedoch nicht die für die einzelnen Ressourcentypen unterstützten Eigenschaften.

Übersicht

Um eine Vorlage zu überprüfen, müssen Sie zunächst eine Datei mit Cloudfunktionen erstellen und dann das Validierungstool ausführen. Verwenden Sie die folgenden PowerShell-Module aus den Azure Stack Hub-Tools:

  • Im Ordner CloudCapabilities: Mit Az.CloudCapabilities.psm1 wird eine JSON-Datei mit Cloudfunktionen erstellt, die die Dienste und Versionen in einer Azure Stack Hub-Cloud darstellt.
  • Im Ordner TemplateValidator: In Az.TemplateValidator.psm1 wird eine JSON-Datei mit Cloudfunktionen verwendet, um Vorlagen für die Bereitstellung in Azure Stack Hub zu testen.

Erstellen der Datei mit Cloudfunktionen

Bevor Sie die Vorlagenvalidierung verwenden, führen Sie das PowerShell-Modul Az.CloudCapabilities aus, um eine JSON-Datei zu erstellen.

Hinweis

Wenn Sie Ihr integriertes System aktualisieren oder neue Dienste oder virtuelle Erweiterungen hinzufügen, sollten Sie dieses Modul erneut ausführen.

  1. Stellen Sie sicher, dass Sie mit Azure Stack Hub verbunden sind. Sie können diese Schritte auf dem ASDK-Host (Azure Stack Development Kit) ausführen oder ein VPN verwenden, um eine Verbindung von Ihrer Arbeitsstation aus herzustellen.

  2. Importieren Sie das PowerShell-Modul Az.CloudCapabilities:

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

  3. Verwenden Sie das Cmdlet Get-CloudCapabilities, um Dienstversionen abzurufen und eine JSON-Datei mit Cloudfunktionen zu erstellen. Wenn Sie -OutputPath nicht angeben, wird die Datei AzureCloudCapabilities.Json im aktuellen Verzeichnis erstellt. Verwenden Sie den tatsächlichen Azure-Speicherort:

Get-AzCloudCapability -Location <your location> -Verbose

Überprüfen von Vorlagen

Mit diesen Schritten überprüfen Sie Vorlagen, indem Sie das PowerShell-Modul Az.TemplateValidator verwenden. Sie können Ihre eigenen Vorlagen oder die Azure Stack Hub-Vorlagen für den Schnellstart verwenden.

  1. Importieren Sie das PowerShell-Modul Az.TemplateValidator.psm1:

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

  2. Führen Sie das Validierungssteuerelement für Vorlagen aus:

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

Das Validierungssteuerelement zeigt Warnungen oder Fehler bei der Vorlagenvalidierung in der PowerShell-Konsole an und protokolliert diese in einer HTML-Datei im Quellverzeichnis. Der folgende Screenshot ist ein Beispiel für einen Validierungsbericht:

Vorlagenvalidierungsbericht

Parameter

Das Validierungs-Cmdlet für Vorlagen unterstützt die folgenden Parameter.

Parameter BESCHREIBUNG Erforderlich
TemplatePath Gibt den Pfad an, um Azure Resource Manager-Vorlagen rekursiv zu suchen. Ja
TemplatePattern Gibt den Namen der abzugleichenden Vorlagendateien an Nein
CapabilitiesPath Gibt den Pfad zu der JSON-Datei mit Cloudfunktionen an. Ja
IncludeComputeCapabilities Enthält die Auswertung von IaaS-Ressourcen wie VM-Größen und VM-Erweiterungen. Nein
IncludeStorageCapabilities Enthält die Auswertung von Speicherressourcen wie SKU-Typen. Nein
Report Gibt den Namen des generierten HTML-Berichts an. Nein
Verbose Protokolliert Fehler und Warnungen in der Konsole. Nein

Beispiele

In diesem Beispiel werden alle Vorlagen aus dem Azure Stack Hub-Schnellstart überprüft, die in den lokalen Speicher heruntergeladen wurden. Im Beispiel werden auch die Größen und Erweiterungen virtueller Computer anhand der ASDK-Funktionen überprüft.

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

Nächste Schritte