Freigeben über

Verwenden des Vorlagenüberprüfungstools im Azure Stack Hub

Überprüfen Sie Ihre Azure Resource Manager-Vorlagen mit dem Vorlagenüberprüfungstool. Das Tool überprüft, ob Ihre Vorlage für die Bereitstellung auf Azure Stack Hub bereit ist. Sie können das Überprüfungstool aus dem GitHub-Repository der Azure Stack Hub-Tools abrufen.

Hinweis

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

Überblick

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

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

Erstellen der Datei für Cloudfunktionen

Führen Sie vor der Verwendung des Vorlagen validators das Az.CloudCapabilities PowerShell-Modul 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 über eine Verbindung mit Azure Stack Hub verfügen. Diese Schritte können über ein VPN ausgeführt werden, um eine Verbindung von Ihrer Arbeitsstation herzustellen.

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

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

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

    Get-AzCloudCapability -Location <your location> -Verbose

Überprüfen von Vorlagen

Führen Sie diese Schritte aus, um Vorlagen mithilfe des Az.TemplateValidator PowerShell-Moduls zu überprüfen. Sie können eigene Vorlagen verwenden oder die Azure Stack Hub-Schnellstartvorlagen 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 den Vorlagen validator aus:

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

Der Validator zeigt Vorlagenüberprüfungswarnungen oder Fehler in der PowerShell-Konsole an und schreibt sie in eine HTML-Datei im Quellverzeichnis. Der folgende Screenshot ist ein Beispiel für einen Überprüfungsbericht:

Vorlagenüberprüfungsbericht

Die Parameter

Das Vorlagen-Validator-Cmdlet unterstützt die folgenden Parameter.

Parameter BESCHREIBUNG Erforderlich
TemplatePath Gibt den Pfad an, um Azure Resource Manager-Vorlagen rekursiv zu finden. Ja
TemplatePattern Gibt den Namen der Vorlagendateien an, die übereinstimmen sollen. Nein
CapabilitiesPath Gibt den Pfad zur JSON-Datei der Cloudfunktionen an. Ja
IncludeComputeCapabilities Umfasst die Auswertung von IaaS-Ressourcen, z. B. VM-Größen und VM-Erweiterungen. Nein
IncludeStorageCapabilities Umfasst die Auswertung von Speicherressourcen, z. B. 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 Azure Stack Hub-Schnellstartvorlagen überprüft, die in den lokalen Speicher heruntergeladen wurden.

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

Nächste Schritte

  • Last updated on